You are on page 1of 8

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

org Stellarium comes with ABSOLUTELY NO WARRANTY. See the COPYING file for details. -------------------------------------------------------------------------------1. 2. 3. 4. 5. INTRODUCTION INSTALLATION INSTRUCTIONS REQUIREMENT QUICK START CONFIGURATION 6. THANKS 7. NOTE 8. FULL REFERENCES & CREDITS 9. LICENSE 10. APPENDIX

-------------------------------------------------------------------------------1. INTRODUCTION -------------------------------------------------------------------------------Stellarium is a free GPL software which renders realistic s ies 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 eys or drag with the mouse to move the point of view. Use page up and page down eys 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 ey 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 located in config/config.ini on Windows/MacOSX and in $HOME/.stellarium/ on a unix system. -------------------------------------------------------------------------------6. THANKS

-------------------------------------------------------------------------------++ Special than s to ++ Rob Spearman (Digitalis Education Solutions, Inc.) for his help and fina ncial support. Have a loo at http://digitaliseducation.com if you want to buy a planetarium projector running stellarium! Johan Meuris for his stunning drawings of the constellations. (Johan is now an official member of the project) Johannes Gajdosi for his wor on planets computation and projection. (Johannes is now an official member of the project) Matthew Gates for his huge wor on the User Guide. (Matthew is now an official member of the project) Nigel Kerr for his MacOSX port. Fumio Yamamoto for his MacOSX pac ages, patches, support and documentati on. Tony Furr for his wor on the Graphical User Interface. lp with any question concerning planetary/satellite ephemeris. Norbert Zacharias from USNO for indly sending a cut of the NOMAD catalo gue on 4 DVD, answering NOMAD related questions, and finally copying the entiere NOMAD catalogue onto a dis . The Trolltech Qt team for its incredible library. ++ Than s to ++ Axel Mellinger who gave me the authorisation to use his impressive mil y way panorama. Jesse Jones for his callbac library. The celestia project team from which I borrowed many code parts (GPL lic ense). The libnova team for their planet calculation algorithms (GPL 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 s y rendering algorithm. Sylvain Ferey for his optimisation of the grids drawing. Jean-Francois Tremblay for his porting on MacOSX. Vincent Caron for his parser bugfix and Linux compatibility bugfixes. Nic Porcino for his planet function. Tangui Morlier for his help on Linux System. Bill Gray (projectpluto.com) and Mar Huss (mar (at) mhuss.com) for all the astro libraries. Chris Laurel (claurel (at) shatters.net) who ma es Celestia. Antje Buchholz for her translation help and logistic support :) And... All the people who sent me mails and bug reports!

Valery Lainey for his L1 and MarsSat ephemeris and his prompt an

ind he

-------------------------------------------------------------------------------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 ta en from [3] and combined with the Scotopic vision formula from [4]. [1] "Tone Reproduction for Realistic Images", Tumblin and Rushme ier, IEEE Computer Graphics & Application, November 1993 [2] "Tone Reproduction and Physically Based Spectral Rendering", Devlin, Chalmers, Wil ie and Purgathofer in EUROGRAPHICS 2002 [3] "Night Rendering", H. Wann Jensen, S. Premoze, P. Shirley, W.B. Thompson, J.A. Ferwerda, M.M. Star [4] "A Visibility Matching Tone Reproduction Operator for High D ynamic Range Scenes", G.W. Larson, H. Rushmeier, C. Piat o 1.2 The s ylight class The class is a fast implementation of the algorithm from the art icle "A Practical Analytic Model for Daylight" by A. J. Preetham, Pet er Shirley and Brian Smits. 1.3 The s ybright class The class is a fast reimplementation of the VISLIMIT.BAS basic s ource code from Brad Schaefer's article on pages 57-60, May 1998 _S y & Telescope_, "To the Visual Limits". The basic sources are av ailable on the S y and Telescope web site. 1.4 Object luminance algorithm from GPL delphi program by Jan Hollan, 19 99 (C) N.Copernicus Observatory and Planetarium in Brno. See http://svetlo.astro.cz/compute/lum.php 2. Included source code 2.1 The png and jpeg openGL texture loader are Copyright (c) 2005-2006 D avid HENRY (see 10.4) 2.2 The stellastro and stellplanet libraries are mainly subsets of the libnova library (GPL) by Liam Girdwood (liam (at) nova-ioe.org) 2.3 The orbit.cpp/h and solve.h files are directly borrowed from Celestia (Chris Laurel). (GPL license) 2.4 Other pieces of code and ideas are from Celestia too (GPL license). 2.5 Callbac library by Jess Jones, see section 10.4 for full license.

2.6 Several implementations of IMCCE theories for planet and satellite movement by Johannes Gajdosi (MIT-style license, see the corresponding files for the license text) 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 Celest ia. 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 Spac e Museum 3.5 Egyptian constellations are based on the wor of Juan Antonio Belmon te, Instituto de Astrofisica de Canarias 3.6 The Tycho-2 Catalogue of the 2.5 Million Brightest Stars Hog E., Fabricius C., Ma arov V.V., Urban S., Corbin T., Wycoff G., Bastian U., Schwe endie 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 valu es -) compute nr_of_measurements = the number of valid b,v,r values -) throw away or eep 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 triangu lar zones according to position and magnitude The programs that are used to generate the star files are called "Ma eCombinedCatalogue", "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 t he ones mentioned below : 4.2 The "earthmap" texture was created by NASA (Reto Stoc li, NASA Earth

Observatory) using data from the MODIS instrument aboard the Terra satellite (Public Domain). See chapter 10.1 for full credi ts. 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.g ov/ 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 lic ense. 4.7 The fulls y mil y way panorama is created by Axel Mellinger, Univers ity able 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 G rasslands Observatory : "Images courtesy of Tim Hunter and James McGaha, G rasslands Observatory at http://www.3towers.com." License: permission given to "use the image freely" (including r ight to modify and redistribute) "as long as it is credited." 4.9 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 co mmercial setting please attribute the source." 4.10 Images of M8, M20, M33, NGC253, NGC1499, NGC2244, IC343 from Jean-P ierre Bousquet 4.11 Images of M1, M15, M16, M27, M57, M97, NGC6946 from Stephane Dumont 4.12 Images of M17, M44, NGC856, NGC884 from Maxime Spano 4.13 Constellation art, GUI buttons, logo created by Johan Meuris (Jomej ome) (jomejome at users.sourceforge.net ) http://users.pandora.be/jom ejom/ License: released under the Free Art License (http://artlibre.org/licence.php/lalgb.html) 4.14 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 o f the imagery The cloud texturing was ta en from Celestia (GPL), http://www.shatters.net/celestia/ 4.15 The folder icon derived from the Tango Des top Project, used under the terms of the Creative Commons Attribution Share-Ali e license. -------------------------------------------------------------------------------9. LICENSE -------------------------------------------------------------------------------Copyright (C) 2004-2009 Fabien Chereau et al. This program is free software; you can redistribute it and/or of Potsdam, Germany. Further information and more pictures avail

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., 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 Stoc li, NASA Earth Observatory, rstoc li (at) climate.gsfc .nasa.gov Address of correspondance: Reto Stoc li 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: rstoc li (at) climate.gsfc.nasa.gov http://earthobservatory.nasa.gov http://www.iac.ethz.ch/staff/stoc li 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 fr eely 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/i ndex.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 wis h 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 ma es no representations or warranties with respect to

ownership of copyrights in the images, and does not represent others who may es no ible 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 u se. 2. to use a credit line in connection with images. Unless otherwise note d in the caption information for an image, the credit line should be "Courtes y NASA/JPL-Caltech." 3. that the endorsement of any product or service by Caltech, JPL or NAS A 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 t he NASA seal. These images may not be used by persons who are not NASA empl oyees 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. Req uests to use NASA logos may be directed to Bert Ulrich, Public Services Divisi on, NASA Headquarters, Code POS, Washington, DC 20546, telephone (202) 358-1 713, 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 dir ected 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 comme rcial 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 li enesses of current employees to appear on commercial products. For e. * 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-12 0, 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 ma e t heir more information, consult the NASA and JPL points of contact listed abov warranties as to the quality of the images. Caltech shall not be respons

claim to be authors or owners of copyright of any of the images, and ma

images and video available for journalistic, educational and personal us es, 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 note d in the caption material with each image. --10.3 License for the callbac library by Jesse Jones : (C) Copyright Jesse Jones 2000. Permission to copy, use, modify, sell and distribute this software is granted provided this copyright notice appears in all copies. This software is provided "as is" without express or implied warranty, and with no claim as to its suitability for any purpose. 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.

You might also like