README

				  ## ### ### #   #   ### ###  #  # # # #
				  #   #  ##  #   #   ### ##   #  # # ###
				 ##   #  ### ### ### # # # #  #  ### # #

			   By Fabien Chereau & al. - www.stellarium.org

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 F1 key for more help.

More help can be found on www.stellarium.org, and in the user guide.

--------------------------------------------------------------------------------
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 config.ini in the user data
directory.  See http://www.stellarium.org/doc/head/fileStructure.html
for more details on the location of the user data directory for your OS.

--------------------------------------------------------------------------------
6. THANKS
--------------------------------------------------------------------------------

	++ Special thanks to ++

	Johan Meuris for his stunning drawings of the constellations.
	  (Johan is now an official member of the project)

	Johannes Gajdosik for his work on planets computation and projection.
	  (Johannes is now an official member of the project)

	Matthew Gates for his huge work on the User Guide.
	  (Matthew is now an official member of the project)

	Nigel Kerr for his MacOSX port.

	Fumio Yamamoto for his MacOSX packages, patches, support and
	  documentation.

	Tony Furr for his work on the Graphical User Interface.

	Rob Spearman (Digitalis Education Solutions, Inc.) for his help and
	financial support.
	
	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.

	The Trolltech Qt team for its incredible library.

	++ Thanks to ++

	Axel Mellinger who gave me the authorisation to use his impressive
	  milky way panorama.
	The celestia project team from which I borrowed many code parts (GPL
	  license).
	The libnova team for their planet calculation algorithms (LGPL license).
	All the sourceforge team for hosting my project.
	Cedric Delfosse for his precious help on debian port.
	The GEPI team from the Observatoire Astronomique de Paris for
	  the great Hipparcos catalog.
	Brad Schaefer for his sky rendering algorithm.
	Jean-Francois Tremblay for his porting on MacOSX.
	Vincent Caron for his parser bugfix and Linux compatibility bugfixes.
	Nick Porcino for his planet function.
	Tangui Morlier for his help on Linux System.
	Bill Gray (projectpluto.com) and Mark Huss (mark (at) mhuss.com) for all
	  the astro libraries.
	Antje Buchholz for her translation help and logistic support :)
	James Hastings-Trew who gave us the authorisation to use his beautiful and realistic planet textures.

	And... All the people who sent us 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.
		(code "offered as-is and without support.")
	1.4 The Delta-T calculations
		For implementation of calculate values of Delta-T we used next sources:
		[1] Delta-T webpage by Rob van Gent: http://www.staff.science.uu.nl/~gent0113/deltat/deltat.htm
		[2] "Five Millennium Canon of Solar Eclipses", Espenak and Meeus
		    http://eclipse.gsfc.nasa.gov/SEhelp/deltatpoly2004.html
		[3] "On the system of astronomical constants", Clemence, G. M.,
		    Astronomical Journal, Vol. 53, p. 169
		    http://adsabs.harvard.edu/abs/1948AJ.....53..169C
		[4] "The Rotation of the Earth, and the Secular Accelerations of the Sun, Moon and Planets",
		    Spencer Jones, Monthly Notices of the Royal Astronomical Society, 99 (1939), 541-558
		    http://adsabs.harvard.edu/abs/1939MNRAS..99..541S
		[5] "Polynomial approximations for the correction delta T E.T.-U.T. in the period 1800-1975",
		    Schmadel, L. D.; Zech, G., Acta Astronomica, vol. 29, no. 1, 1979, p. 101-104.
		    http://adsabs.harvard.edu/abs/1979AcA....29..101S
		[6] "ELP 2000-85 and the dynamic time-universal time relation", Borkowski, K. M.,
		    Astronomy and Astrophysics (ISSN 0004-6361), vol. 205, no. 1-2, Oct. 1988, p. L8-L10.
		    http://adsabs.harvard.edu/abs/1988A&A...205L...8B
		[7] "Empirical Transformations from U.T. to E.T. for the Period 1800-1988", 
		    Schmadel, L. D.; Zech, G., Astronomische Nachrichten 309, 219-221
		    http://adsabs.harvard.edu/abs/1988AN....309..219S
		[8] "Historical values of the Earth's clock error DeltaT and the calculation of eclipses",
		    Morrison, L. V.; Stephenson, F. R., Journal for the History of Astronomy (ISSN 0021-8286), 
		    Vol. 35, Part 3, No. 120, p. 327 - 336 (2004)
		    http://adsabs.harvard.edu/abs/2004JHA....35..327M
		[9] "Addendum: Historical values of the Earth's clock error", Morrison, L. V.; Stephenson, F. R.,
		    Journal for the History of Astronomy (ISSN 0021-8286), Vol. 36, Part 3, No. 124, p. 339 (2005)
		    http://adsabs.harvard.edu/abs/2005JHA....36..339M
		[10] "Polynomial approximations to Delta T, 1620-2000 AD", Meeus, J.; Simons, L.,
		    Journal of the British Astronomical Association, vol.110, no.6, 323
		    http://adsabs.harvard.edu/abs/2000JBAA..110..323M
		[11] "Einstein's Theory of Relativity Confirmed by Ancient Solar Eclipses", Henriksson G.,
		    http://adsabs.harvard.edu/abs/2009ASPC..409..166H
		[12] "Canon of Solar Eclipses" by Mucke & Meeus (1983)
		[13] "The accelerations of the earth and moon from early astronomical observations", 
		     Muller P. M., Stephenson F. R.,
		     http://adsabs.harvard.edu/abs/1975grhe.conf..459M
		[14] "Pre-Telescopic Astronomical Observations", Stephenson F. R.,
		    http://adsabs.harvard.edu/abs/1978tfer.conf....5S
		[15] "Long-term changes in the rotation of the earth - 700 B.C. to A.D. 1980", 
		     Stephenson F. R., Morrison L. V., 
		     Philosophical Transactions, Series A (ISSN 0080-4614), vol. 313, no. 1524, Nov. 27, 1984, p. 47-70.
		     http://adsabs.harvard.edu/abs/1984RSPTA.313...47S
		[16] "Long-Term Fluctuations in the Earth's Rotation: 700 BC to AD 1990",
		    Stephenson F. R., Morrison L. V., 
		    Philosophical Transactions: Physical Sciences and Engineering, Volume 351, Issue 1695, pp. 165-202
		    http://adsabs.harvard.edu/abs/1995RSPTA.351..165S
		[17] "Historical Eclipses and Earth's Rotation" by F. R. Stephenson (1997)
		    http://ebooks.cambridge.org/ebook.jsf?bid=CBO9780511525186
		[18] "Astronomical Algorithms" by J. Meeus (2nd ed., 1998)
		[19] "Astronomy on the Personal Computer" by O. Montenbruck & T. Pfleger (4nd ed., 2000)
		[20] "Calendrical Calculations" by E. M. Reingold & N. Dershowitz (2nd ed., 2001)
		[21] DeltaT webpage by V. Reijs: http://www.iol.ie/~geniet/eng/DeltaTeval.htm

2. Included source code
	2.1 Some computation of the sideral time (sideral_time.h/c) and pluto
		orbit contains code from the libnova library (LGPL) by Liam Girdwood.
	2.2 The orbit.cpp/h and solve.h files are directly borrowed from
		Celestia (Chris Laurel). (GPL license)
	2.3 Several implementations of IMCCE theories for planet and satellite
		movement by Johannes Gajdosik (MIT-style license,
		see the corresponding files for the license text)
	2.4 The tesselation algorithms were originally extracted from the glues 
		library version 1.4 Mike Gorchak <mike@malva.ua> (SGI FREE SOFTWARE
		LICENSE B).

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.
	3.8 Stellarium's Catalog of Variable Stars based on General Catalog of Variable 
		Stars (GCVS) version 2013Apr.
		http://www.sai.msu.su/gcvs/gcvs/
		Samus N.N., Durlevich O.V., Kazarovets E V., Kireeva N.N., Pastukhova E.N., 
		Zharova A.V., et al., General Catalogue of Variable Stars (Samus+ 2007-2012)
		http://cdsarc.u-strasbg.fr/viz-bin/Cat?cat=B%2Fgcvs&

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 was combined from maps by USGS Astrogeology Research Program,
		http://astrogeology.usgs.gov (Public Domain, DFSG-free) and by Lunar 
		surface textures from Celestia, based on Clementine data (Public Domain).
	4.5a Jupiter map, Saturn map and ring textures created by Björn Jónsson:
		"All the planetary maps available on these pages are publicly
		available. You do not need a special permission to use them but if
		you do then please mention their origin in your work [..]"
	4.5b The Rhea, Amalthea, Proteus and Triton maps and rings of Uranus and 
		Neptune	are from Celestia (http://shatters.net/celestia/) under the 
		GNU General Purpose License, version 2 or any later version:
		- Amalthea is a shaded relief map by Phil Stooke, colored by
		  Wm. Robert Johnston 
		  (http://www.johnstonsarchive.net/spaceart/cylmaps.html),
		  and further modified by Jens Meyer and Grant Hutchison.
		- The Proteus map is from Phil Stooke.
		- Triton is probably from David Seal's site (see below),
                  modified by Chris Laurel and Grant Hutchison.
	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 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.7 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 modify and redistribute) "as long as it is credited."
	4.8 M31, and the Pleiades pictures come from Herm Perez :
		http://home.att.net/~hermperez/default.htm
		License: "Feel free to use these images, if you use them in a
		commercial setting please attribute the source."
	4.9 Images of M8, M33, NGC253, NGC1499, NGC2244, IC343 from
		Jean-Pierre Bousquet
	4.10 Images of M1, M15, M16, M27, M42, M57, M97, NGC6946 from Stephane Dumont	
	4.11 Images of M17, M44, NGC856, NGC884 from Maxime Spano
	4.12 Constellation art, GUI buttons, logo created by Johan Meuris
		(Jomejome) (jomejome at users.sourceforge.net)
		http://www.johanmeuris.eu/
		License: released under the Free Art License
		(http://artlibre.org/licence.php/lalgb.html)
	     Icon created by Johan Meuris
	        License: Creative Commons Attribution-ShareAlike 3.0 Unported
	4.13 The "earth-clouds" texture includes imagery owned by NASA.
		See NASA's Visible Earth project at http://visibleearth.nasa.gov/
		License: 1. The imagery is free of licensing fees
			 2. NASA requires that they be provided a credit as the owners
			    of the imagery
		The cloud texturing was taken from Celestia (GPL),
		http://www.shatters.net/celestia/
	4.14 The folder icon derived from the Tango Desktop Project, used under
		the terms of the Creative Commons Attribution Share-Alike
		license.
	4.15 Images of NGC281, NGC5139, NGC6543, NGC6960, NGC7023, NGC7317, NGC7318, 
		NGC7319, NGC7320, NGC7331, IC4601, IC4592
		from Andrey Kuznetsov, Kepler Observatory
		http://kepler-observatorium.ru
		License: Creative Commons Attribution 3.0 Unported
	4.16 Images of NGC891, NGC1333, NGC2903, NGC3185, NGC3187, NGC3189, NGC3190, 
		NGC3193, NGC3718, NGC3729, NGC4490, NGC5981, NGC5982, NGC5985, NGC7129 
		from Oleg Bryzgalov 
		http://olegbr.astroclub.kiev.ua/
		License: Creative Commons Attribution 3.0 Unported
	4.17 Image of eta Carinae 
		from Georg Zotti
		http://www.waa.at/
		License: Creative Commons Attribution 3.0 Unported
	4.18 Images of IC1805, IC1848, NGC6888
		from Steve Tuttle
		http://www.stuttle1.com/
	4.19 Images of IC2944, IC4628, M20, M21, M47
		from Trevor Gerdes
		http://sarcasmogerdes.dyndns.org/
	4.20 Images of IC2118, NGC1532
		from users of Ice In Space
		http://www.iceinspace.com.au/
	4.21 Image of IC5146 from James A Weier
	4.22 Images of SMC, LMC (Magellanic Clouds) and rho Oph from Albert Van Donkelaar
	4.23 Images of NGC55, NGC300, NGC1365, NGC3628, NGC4945, NGC5128, NGC6726,
		NGC6744, NGC6752, NGC6822, NGC7293
		from Philip Montgomery
		http://www.kenthurst.bigpondhosting.com/

--------------------------------------------------------------------------------
9. LICENSE
--------------------------------------------------------------------------------
   Copyright (C) 2004-2012 Fabien Chereau et al.

   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License
   as published by the Free Software Foundation; either version 2
   of the License, or (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   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., 51 Franklin Street, Suite 500, Boston, MA  02110-1335, 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."

10.2 License for the JPL planets images
(http://www.jpl.nasa.gov/images/policy/index.cfm)
	---
	Unless otherwise noted, images and video on JPL public web sites (public
	sites ending with a jpl.nasa.gov address) may be used for any purpose
	without prior 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 warranties as to the quality of the images.
	   Caltech shall not be responsible for any loss or expenses resulting
	   from the use of the images, and you release and hold Caltech harmless
	   from all liability arising from such use.
	2. to use a credit line in connection with images. Unless otherwise
	   noted in the caption information for an image, the credit line should
	   be "Courtesy NASA/JPL-Caltech."
	3. that the endorsement of any product or service by Caltech, JPL or
	   NASA must not be claimed or implied.
	Special Cases:
	* Prior written approval must be obtained to use the NASA insignia logo
	  (the blue "meatball" insignia), the NASA logotype (the red "worm"
	  logo) and the NASA seal. These images may not be used by persons who
	  are not NASA employees or on products (including Web pages) that are
	  not NASA sponsored. In addition, no image may be used to explicitly
	  or implicitly suggest endorsement by NASA, JPL or Caltech of
	  commercial goods or services. Requests 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 to the Television/Imaging Team Leader, Media Relations
	  Office, Mail Stop 186-120, Jet Propulsion Laboratory, Pasadena CA
	  91109, telephone (818) 354-5011, fax (818) 354-4537.
	* If an image includes an identifiable person, using the image for
	  commercial purposes may infringe that person's right of privacy or
	  publicity, and permission should be obtained from the person. NASA
	  and JPL generally do not permit likenesses of current employees to
	  appear on commercial products. For more information, consult the NASA
	  and JPL points of contact listed above.
	* JPL/Caltech contractors and vendors who wish to use JPL images in
	  advertising or public relation materials should direct requests to the
	  Television/Imaging Team Leader, Media Relations Office, Mail Stop
	  186-120, Jet Propulsion Laboratory, Pasadena CA 91109, telephone
	  (818) 354-5011, fax (818) 354-4537.
	* Some image and video materials on JPL public web sites are owned by
	  organizations other than JPL or NASA. These owners have agreed to
	  make their images and video available for journalistic, educational
	  and personal uses, but restrictions are placed on commercial uses.
	  To obtain permission for commercial use, contact the copyright owner
	  listed in each image caption.  Ownership of images and video by
	  parties other than JPL and NASA is noted in the caption material
	  with each image.
	---