Professional Documents
Culture Documents
Readme
Readme
# # ## # # ### ## # # # ###
## # ### ### ### # # # # # ### # #
Stellarium comes with ABSOLUTELY NO WARRANTY. See the COPYING file for details.
--------------------------------------------------------------------------------
1. INTRODUCTION 6. THANKS
2. INSTALLATION INSTRUCTIONS 7. NOTE
3. REQUIREMENT 8. FULL REFERENCES & CREDITS
4. QUICK START 9. LICENSE
5. CONFIGURATION 10. APPENDIX
--------------------------------------------------------------------------------
1. INTRODUCTION
--------------------------------------------------------------------------------
Stellarium is a free GPL software which renders realistic skies in real time
with openGL. It is available for Linux/Unix, Windows and MacOSX. With Stellarium,
you really see what you can see with your eyes, binoculars or a small telescope.
--------------------------------------------------------------------------------
2. INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------------------
Please see the INSTALL file.
--------------------------------------------------------------------------------
3. REQUIREMENT
--------------------------------------------------------------------------------
Windows or linux/POSIX or CYGWIN or MACOSX environment
A 3d openGL acceleration card and a good CPU.
--------------------------------------------------------------------------------
4. QUICK START
--------------------------------------------------------------------------------
Navigation :
Use the direction keys or drag with the mouse to move the point of view.
Use page up and page down keys or mouse wheel to zoom in and out.
Use left mouse button to select an object, right button to select no object and
middle mouse button or SPACE to center on the selected object.
Zooming on nebulas or planets is very interesting....
Use J, K and L to increment/decrement time speed.
Press the H key for more help.
--------------------------------------------------------------------------------
5. CONFIGURATION
--------------------------------------------------------------------------------
From version 0.6.0 the most useful configuration options can be set from within
the program.
You can however change it by hand in the file located in config/config.ini on
Windows/MacOSX and in $HOME/.stellarium/ on a unix system.
--------------------------------------------------------------------------------
6. THANKS
--------------------------------------------------------------------------------
++ Special thanks to ++
Rob Spearman (Digitalis Education Solutions, Inc.) for his help and financial
Fumio Yamamoto for his MacOSX packages, patches, support and documentation.
Valery Lainey for his L1 and MarsSat ephemeris and his prompt an kind help
with any question concerning planetary/satellite ephemeris.
Norbert Zacharias from USNO for kindly sending a cut of the NOMAD catalogue
on 4 DVD, answering NOMAD related questions, and finally copying the
entiere NOMAD catalogue onto a disk.
++ Thanks to ++
And... All the people who sent me mails and bug reports!
--------------------------------------------------------------------------------
7. NOTE
--------------------------------------------------------------------------------
This program is free, but if you have nothing to do with your
money, just go there and do something usefull with it :
https://www.greenpeace.com/forms/gpicontr.html
--------------------------------------------------------------------------------
8. FULL REFERENCES & CREDITS
--------------------------------------------------------------------------------
1. Technical Articles
1.1 The tone reproductor class
The class mainly performs a fast implementation of the algorithm from
the paper [1], with more accurate values from [2]. The blue shift
formula is taken from [3] and combined with the Scotopic vision
formula from [4].
[1] "Tone Reproduction for Realistic Images", Tumblin and Rushmeier,
IEEE Computer Graphics & Application, November 1993
[2] "Tone Reproduction and Physically Based Spectral Rendering",
Devlin, Chalmers, Wilkie and Purgathofer in EUROGRAPHICS 2002
[3] "Night Rendering", H. Wann Jensen, S. Premoze, P. Shirley,
W.B. Thompson, J.A. Ferwerda, M.M. Stark
[4] "A Visibility Matching Tone Reproduction Operator for High Dynamic
Range Scenes", G.W. Larson, H. Rushmeier, C. Piatko
1.2 The skylight class
The class is a fast implementation of the algorithm from the article
"A Practical Analytic Model for Daylight" by A. J. Preetham, Peter
Shirley and Brian Smits.
1.3 The skybright class
The class is a fast reimplementation of the VISLIMIT.BAS basic source
code from Brad Schaefer's article on pages 57-60, May 1998 _Sky &
Telescope_, "To the Visual Limits". The basic sources are available on
the Sky and Telescope web site.
1.4 Object luminance algorithm from GPL delphi program by Jan Hollan, 1999
(C)
N.Copernicus Observatory and Planetarium in Brno.
See http://svetlo.astro.cz/compute/lum.php
3. Data
3.1 The Hipparcos star catalog
From ESA (European Space Agency) and the Hipparcos mission.
ref. ESA, 1997, The Hipparcos and Tycho Catalogues, ESA SP-1200
http://cdsweb.u-strasbg.fr/ftp/cats/I/239
3.2 The solar system data mainly comes from IMCCE and partly from Celestia.
3.3 Polynesian constellations are based on diagrams from the Polynesian
Voyaging Society
3.4 Chinese constellations are based on diagrams from the Hong Kong Space
Museum
3.5 Egyptian constellations are based on the work of Juan Antonio Belmonte,
Instituto de Astrofisica de Canarias
3.6 The Tycho-2 Catalogue of the 2.5 Million Brightest Stars
Hog E., Fabricius C., Makarov V.V., Urban S., Corbin T.,
Wycoff G., Bastian U., Schwekendiek P., Wicenec A.
<Astron. Astrophys. 355, L27 (2000)>
http://cdsweb.u-strasbg.fr/ftp/cats/I/259
3.7 Naval Observatory Merged Astrometric Dataset (NOMAD) version 1
http://www.nofs.navy.mil/nomad
Norbert Zacharias writes:
"There are no fees, both UCAC and NOMAD are freely available
with the only requirement that the source of the data
(U.S. Naval Observatory) and original product name need to be
provided with any distribution, as well as a description about
any changes made to the data, if at all."
The changes made to the data are:
-) try to compute visual magnitude and color from the b,v,r values
-) compute nr_of_measurements = the number of valid b,v,r values
-) throw away or keep stars (depending on magnitude,
nr_of_measurements, combination of flags, tycho2 number)
-) add all stars from hiparcos (incl. component solutions),
and tycho2+1st supplement
-) reorganize the stars in several brigthness levels and triangular
zones according to position and magnitude
The programs that are used to generate the star files are called
"MakeCombinedCatalogue", "ParseHip", "ParseNomad",
and can be found in the util subdirectory in source code.
The position, magnitudes, and proper motions of the stars
coming from NOMAD are unchanged, except for a possible
loss of precision, especially in magnitude. When there is no
v-magnitude, it is estimated from r or b magnitude.
When there is no b- or v- magnitude, the color B-V is estimated from
the other magnitudes.
Also proper motions of faint stars are neglected at all.
4. Graphics
4.1 All graphics are copyrighted by the Stellarium's Team (GPL) except the
ones
mentioned below :
4.2 The "earthmap" texture was created by NASA (Reto Stockli, NASA Earth
Observatory) using data from the MODIS instrument aboard the
Terra satellite (Public Domain). See chapter 10.1 for full credits.
4.4 Moon texture map is Courtesy USGS Astrogeology Research Program,
http://astrogeology.usgs.gov. (Public Domain, DFSG-free)
4.5 All other planet maps from David Seal's site: http://maps.jpl.nasa.gov/
see license in section 10.3
4.6 The snowy landscape textures are from the GPL game tuxracer.
"Copyright 1999, 2000, 2001 Jasmin F. Patry" available under GPL license.
4.7 The fullsky milky way panorama is created by Axel Mellinger, University
of Potsdam, Germany. Further information and more pictures available
from
http://home.arcor-online.de/axel.mellinger/
License: permission given to "Modify and redistribute this image if
proper
credit to the original image is given."
4.8 All messiers nebula pictures except those mentioned below from the
Grasslands
Observatory : "Images courtesy of Tim Hunter and James McGaha,
Grasslands
Observatory at http://www.3towers.com."
License: permission given to "use the image freely" (including right to
--------------------------------------------------------------------------------
9. LICENSE
--------------------------------------------------------------------------------
Copyright (C) 2004-2009 Fabien Chereau et al.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
See the COPYING file for more information regarding the GNU General
Public License.
--------------------------------------------------------------------------------
10 APPENDIX :
--------------------------------------------------------------------------------
10.1 Full credits for image 4.2 :
Author: Reto Stockli, NASA Earth Observatory, rstockli (at)
climate.gsfc.nasa.gov
Address of correspondance:
Reto Stockli
ETH/IAC (NFS Klima) & NASA/GSFC Code 913 (SSAI)
University Irchel
Building 25 Room J53
Winterthurerstrasse 190
8057 Zurich, Switzerland
Phone: +41 (0)1 635 5209
Fax: +41 (0)1 362 5197
Email: rstockli (at) climate.gsfc.nasa.gov
http://earthobservatory.nasa.gov
http://www.iac.ethz.ch/staff/stockli
Supervisors:
Fritz Hasler and David Herring, NASA/Goddard Space Flight Center
Funding:
This project was realized under the SSAI subcontract 2101-01-027 (NAS5-
01070)
License :
"Any and all materials published on the Earth Observatory are freely
available
for re-publication or re-use, except where copyright is indicated."
permission, subject to the special cases noted below. Publishers who wish to
have authorization may print this page and retain it for their records; JPL
does not issue image permissions on an image by image basis.
By electing to download the material from this web site the user agrees:
1. that Caltech makes no representations or warranties with respect to
ownership of copyrights in the images, and does not represent others who may
claim to be authors or owners of copyright of any of the images, and makes no
to use NASA logos may be directed to Bert Ulrich, Public Services Division,
NASA Headquarters, Code POS, Washington, DC 20546, telephone (202) 358-1713,
fax (202) 358-4331, email bert.ulrich@hq.nasa.gov.
* Prior written approval must be obtained to use the JPL logo (stylized JPL
letters in red or other colors). Requests to use the JPL logo may be directed
10.4 License for the JPEG and PNG loading code from David HENRY
Copyright (c) 2005-2006 David HENRY
Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.