1***************************************************************************
2* Celestia *
3* *
4* A real-time space simulation that lets you experience our universe in *
5* three dimensions. *
6* *
7* Copyright (c) 2001-2009, Celestia Development Team *
8* *
9*-------------------------------------------------------------------------*
10* Celestia web site: http://www.shatters.net/celestia/ *
11* *
12* Celestia documentation: *
13* http://www.shatters.net/celestia/documentation.html *
14* Celestia WikiBook: http://en.wikibooks.org/wiki/Celestia *
15* *
16* Celestia forums: http://www.shatters.net/forum/ *
17* *
18***************************************************************************
19
20CONTENTS
21--------
22 License
23 Installing in Unix and Linux
24 Getting Started
25 Mouse, Keyboard & Joystick Controls
26 Star & Solar System Browser
27 Selecting Objects by Name
28 Known Issues
29 User Modifiable Elements
30 Celestia Resources
31 Contributions
32 Acknowledgements
33
34
35LICENSE
36-------
37This program is free software; you can redistribute it and/or modify it under
38the terms of the GNU General Public License as published by the Free Software
39Foundation; either version 2 of the License, or (at your option) any later
40version.
41
42This program is distributed in the hope that it will be useful, but WITHOUT
43ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
44FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
45details, which you should have received along with this program (filename:
46COPYING). If not, request a copy from:
47 Free Software Foundation, Inc.
48 59 Temple Place - Suite 330
49 Boston, MA 02111-1307
50 USA
51
52
53INSTALLING IN UNIX AND LINUX
54----------------------------
55Type "./configure --help" for a list of options. The basic commands are shown
56below. For more detailed information, refer to the INSTALL file.
57
58The GTK version is built with...
59 ./configure --with-gtk
60 make
61 make install
62
63The KDE3 version is built with...
64 ./configure --with-kde
65 make
66 make install
67
68 Note: some systems may require configure to be executed with
69 --with-qt-includes=/usr/include/qt3
70
71The Gnome version is built with...
72 ./configure --with-gnome
73 make
74 make install
75
76If all else fails, try the gui-less version with...
77 ./configure --with-glut
78 make
79 make install
80
81
82GETTING STARTED
83---------------
84Celestia will start up in a window, and if everything is working correctly,
85you'll see Earth in front of a field of stars. Displayed on-screen, is some
86information about your target (Earth), your speed, and the current time
87(Universal Time, so it'll probably be a few hours off from your computer's
88clock).
89
90Right drag the mouse to orbit Earth and you might see the Moon and some
91familiar constellations. Left dragging the mouse changes your orientation
92also, but the camera rotates about its center instead of rotating around
93Earth. Rolling the mouse wheel will change your distance to Earth--you can
94move light years away, then roll the wheel in the opposite direction to get
95back to your starting location. If your mouse lacks a wheel, you can use the
96Home and End keys instead.
97
98When running Celestia, you will usually have some object selected. Currently,
99it's Earth, but it could also be a star, moon, spacecraft, galaxy, or some
100other object. The simplest way to select an object is to click on it. Try
101clicking on a star to select it. The information about Earth is replaced with
102some details about the star. Press G (or use the Navigation menu), and you'll
103zoom through space toward the selected star. If you press G again, you'll
104approach the star even closer.
105
106Press H to select our Sun, and then G to go back to our Sun. Right click on
107the sun to bring up a menu of planets and other objects in the solar system.
108After selecting a planet from the menu, hit G again to travel toward it. Once
109there, hold down the right mouse button and drag to orbit the planet.
110
111The Tour Guide is a list of some of the more interesting objects you can visit
112in Celestia. Select the Tour Guide option in the Navigation menu to display
113the Tour Guide window. Choose a destination from the list, click the Goto
114button, and you're off.
115
116That covers the very basics. For a more in-depth look at Celestia and the
117controls available to you, download the "Celestia User's Guide" (written by
118Frank Gregorio), available in several languages, from:
119 http://www.shatters.net/celestia/documentation.html
120This web page also includes links to the Celestia README file translated into
121Japanese.
122
123
124MOUSE, KEYBOARD & JOYSTICK CONTROLS
125-----------------------------------
126See the included file: controls.txt OR use the Help menu to display the Controls
127list.
128
129
130STAR & SOLAR SYSTEM BROWSER
131-------------------------------------------
132The Navigation menu contains 'Solar System Browser' and 'Star Browser'
133options.
134
135STAR BROWSER
136
137By default, the Star Browser window displays a table of the 100 nearest stars,
138along with their Distance, Apparent and Absolute Magnitude, and Type. Clicking
139on the column headers will sort the stars. The table is not continuously
140updated, so if you travel to another star, you should press the Refresh button
141to update the table for your current position. The radio buttons beneath the
142table let you switch between viewing a list of Nearest, Brightest, or 'With
143planets' stars. As with the solar system browser, clicking on any star name
144in the table will select it. Use this feature along with the Center and Go
145To buttons to tour the stars visible from any night sky in the galaxy.
146
147SOLAR SYSTEM BROWSER
148
149The Solar System Browser displays a window with a tree view of all the objects
150in the nearest solar system (if there is one within a light year of your current
151position.) Clicking on the name of any object in the window will select it.
152You can then use the Center or Go To buttons to display that object in the main
153Celestia window.
154
155
156SELECTING OBJECTS BY NAME
157-------------------------
158Celestia provides several ways to select an object by name...
159 1. Choose 'Select Object' from the Navigation menu, type in the object
160 name, and click OK.
161
162 2. Press Enter, type in the entire object name, and press Enter again.
163
164 3. Press Enter, type in the first few characters of the object name,
165 press the Tab key to move through the displayed listing until the
166 object is highlighted, then press Enter again.
167
168You can use common names, Bayer designations or catalog numbers for stars.
169Celestia currently supports the HIP, HD and SAO catalogs. Catalog numbers must
170be entered with a space between the prefix and the catalog number.
171
172
173KNOWN ISSUES
174------------
175For up-to-the-minute answers to some common problems encountered when running
176Celestia, please view either the FAQ in the Help menu or take a look at the
177"Celestia User's FAQ" located on the Celestia User's Forum:
178http://www.shatters.net/forum/
179
180
181USER MODIFIABLE ELEMENTS
182------------------------
183You can modify how Celestia starts up each time you run it, by defining your
184own start-up settings. Simply open the file "start.cel" in a plain text
185editor and follow the in-file instructions. Also, view the celestia.cfg file
186in a plain text editor to see additional settings.
187
188Celestia allows you to easily add real, hypothetical, or fictional objects
189by creating new catalog files. It is *not* recommended that you alter the
190built-in data files; nearly all desired modifications and additions can be
191made by placing new catalog files in Celestia's extras folders. There are three
192types of catalog files:
193 - ssc (solar system catalog: planets, moons, spacecraft, etc.)
194 - stc (star catalog)
195 - dsc (deep sky catalog: galaxies, star clusters, and nebulae)
196All three types of catalog file are text files that can be updated with your
197favorite text editing program.
198
199
200CELESTIA RESOURCES
201------------------
202Celestia Web Site:
203 http://www.shatters.net/celestia/
204
205Celestia User Forums:
206 http://www.shatters.net/forum/
207
208Selden's List of Resources for Celestia :
209 http://www.lepp.cornell.edu/~seb/celestia/
210
211Celestia WikiBook:
212 http://en.wikibooks.org/wiki/Celestia
213
214Celestial Matters Website and Forums:
215 http://www.celestialmatters.org/
216 http://forum.celestialmatters.org/
217
218Celestia Motherlode:
219 http://www.celestiamotherlode.net/
220
221Celestia Source Code (SourceForge.net):
222 http://sourceforge.net/projects/celestia/
223
224Celestia Bug Tracking (SourceForge.net):
225 http://sourceforge.net/tracker/?atid=121302&group_id=21302&func=browse
226
227Celestia Feature Requests (SourceForge.net):
228 http://sourceforge.net/tracker/?atid=371302&group_id=21302&func=browse
229
230
231CONTRIBUTIONS
232-------------
233
234Authors
235-------
236 Chris Laurel <claurel@gmail.com>
237 Clint Weisbrod <cweisbrod@cogeco.ca>
238 Fridger Schrempp <t00fri@mail.desy.de>
239 Bob Ippolito <bob@redivi.com>
240 Christophe Teyssier <chris@teyssier.org>
241 Hank Ramsey <hramsey@users.sourceforge.net>
242 Grant Hutchison <grant.celestia@xemaps.com>
243 Pat Suwalski <pat@suwalski.net>
244 Toti
245 Da Woon Jung <dirkpitt2050@users.sf.net>
246 Vincent Giangiulio <vince.gian@free.fr>
247 Andrew Tribick
248
249Contributors
250------------
251 Deon Ramsey ........... Original GTK1 interface
252 Christopher ANDRE ..... Eclipse Finder
253 Colin Walters ......... Endianness fixes
254 Peter Chapman ......... Orbit path rendering changes
255 James Holmes ..........
256 Harald Schmidt ........ Lua scripting enhancements, bug fixes
257 Nils Larsson .......... Various enhancements and bug fixes
258
259Documentation
260-------------
261 Frank Gregorio ........ Celestia User's Guide
262 Hitoshi Suzuki ........ Japanese README translation
263 Christophe Teyssier ... DocBook and HTML conversion of User's Guide
264 Diego Rodriguez ....... Acrobat conversion of User's Guide
265 Don Goyette ........... CEL Scripting Guide
266 Harald Schmidt ........ Celx/Lua Scripting Guide
267
268
269Scientific Data Base
270--------------------
271
272# Grant Hutchison
273 Supplied the correct orientations for the major planets, their moons, and a
274 number of asteroids and also worked on these data files:
275 Solarsys.ssc, nearstars.stc, extrasolar.ssc, extrasolar.stc, earth_locs.ssc
276
277# Fridger Schrempp
278 Complete NGC/IC galaxy database + local group galaxies (galaxies.dsc)
279
280 Data base on globular clusters (globulars.dsc)
281
282 Data base on visual and spectroscopic binaries (visualbins.stc,
283
284 spectbins.stc)
285
286 World-capitals.ssc
287
288 Asterisms.dat
289
290# Andrew Tribick
291 Significant update of the star.dat base based on new HIP Reduction of the
292 Raw data, Floor van Leeuwen, 2007.
293
294 CHARM2 stellar radii (charm2.stc)
295
296
297Texture maps
298------------
299
300# Most of the planet maps are from David Seal's site:
301 http://maps.jpl.nasa.gov/.
302 A few of these maps were modified by me, with fictional terrain added to fill
303 in gaps. The model of the Galileo spacecraft is also from David Seal's site
304 (though it was converted from Inventor to 3DS format.)
305
306# The Mars, Neptune, and Uranus textures and Mars bump maps are all from James
307 Hastings-Trew's collection. His maps may be found here:
308 http://gw.marketingden.com/planets/planets.html
309
310# Grant Hutchison
311
312 Saturn's rings were built by Grant Hutchison from Cassini imaging, with
313 transparency information derived from stellar transit data obtained from:
314 http://pds-rings.arc.nasa.gov/ringocc/ringocc.html
315
316 The Eros map is a shaded relief generated from the NEAR laser rangefinder
317 shape model at:
318 http://pdssbn.astro.umd.edu/NEARdb/nlr/#shape
319
320# Jens Meyer
321
322 Dione and Rhea are USGS maps colored and modified by Jens Meyer.
323
324 The Moon map is based on data from PDS Map-A-Planet at
325 http://pdsmaps.wr.usgs.gov/maps.html with colors from Mark Robinson at
326 http://www.earth.northwestern.edu/research/robinson/MOON/clem_color.html.
327
328# Fridger Schrempp
329
330 'Available data' Pluto and Charon textures using maps created by Marc Buie
331 at Lowell Observatory. Buie's maps were generated from photometric data
332 gathered during six years of mutual occultations of Pluto and Charon.
333
334 Titan's cloud texture in natural colors and its surface map at near-infrared
335 wavelength. They are based on resources available from the imaging site
336 (Ciclops) of the Cassini mission
337 (http://ciclops.lpl.arizona.edu/index.php)
338
339 The Phoebe base texture was created from the cylindrical map published by
340 the Cassini imaging team
341 (http://photojournal.jpl.nasa.gov/catalog/PIA07775)
342
343 The Tethys textures are based on the Oct 2008 Ciclops map
344 (http://photojournal.jpl.nasa.gov/catalog/PIA11116)
345
346 The Iapetus texture was created from the Oct 2008 Ciclops map
347 (http://photojournal.jpl.nasa.gov/catalog/PIA11116)
348
349 The Lunar topography and bump maps, using Clementine laser altimeter data,
350 merged in the polar regions with topographic data from Clementine 750 nm
351 oblique and nadir images
352 (ftp://ftpflag.wr.usgs.gov/dist/pigpen/moon/usgs/topo/global/)
353
354 The Mercury map was created from a combination of Mariner 10 imaging
355 with recent MESSENGER WAC images from the first two flybys, as collected
356 and reprojected by Steve Albers:
357 See http://laps.noaa.gov/albers/sos/sos.html.
358
359# Phil Stooke
360
361 Proteus, Janus, Prometheus and Epimetheus maps are from Phil Stooke.
362
363 The Ida and Gaspra photomosaic maps are by Phil Stooke.
364
365# Venus's clouds and the textures for Ganymede, Callisto and Saturn are from
366 Bj�rn J�nsson. His site at http://www.mmedia.is/~bjj/ is an excellent
367 resource for solar system rendering.
368
369# Venus's surface is a copyright-free NASA image, prepared from Magellan radar
370 data. The original is available at
371 http://www.solarviews.com/cap/venus/venmap.htm
372
373# The Earth texture was created by NASA using data from the MODIS instrument
374 aboard the Terra satellite. Further information is available from:
375 http://earthobservatory.nasa.gov/Newsroom/BlueMarble/
376
377# Steve Albers
378 The Io and Europa maps are by Steve Albers. His planetary maps are at:
379 http://laps.noaa.gov/albers/sos/sos.html
380
381# The textures for the Uranian satellites were created by Ivan Rivera from JPL
382 data. His Celestia page is: http://bruckner.homelinux.net/celestia.html
383
384# The Hyperion map is a photomosaic assembled by Phil Stooke and
385 colored by Jens Meyer.
386
387# Amalthea is a shaded relief map by Phil Stooke, colored by Wm. Robert Johnston
388 (http://www.johnstonsarchive.net/spaceart/cylmaps.html), and further modified
389 by Jens Meyer and Grant Hutchison.
390
391# The asteroid.jpg texture was created by Paul Roberts.
392
393# The textures for the five classes of extrasolar giant planet were created by
394 Andrew Tribick.
395
396# CICLOPS
397
398 The map of Enceladus is derived from the December 2008 CICLOPS map:
399 http://ciclops.org/view/5447/Map_of_Enceladus_December_2008
400
401
4023D Models
403---------
404
405# Models of Mars Global Surveyor and Mars Odyssey were created by Shrox:
406 http://www.shrox.com/
407
408# The Cassini and Huygens models are by Jack Higgins:
409 http://homepage.eircom.net/~jackcelestia/
410
411# The 3D model of ISS is a deconstruction of Andrew Farnaby's
412 complete ISS model with textures by Bob Hundley. The model
413 represents the ISS as of June 2008 and is a modification of
414 the model that can be found here:
415 http://www.celestiamotherlode.net/catalog/show_addon_details.php?addon_id=1199
416 ISS model of June 2008 (with Kibo) by krisci3 (modified and
417 converted in order to work with JPG by Ulrich Dickmann, a.k.a.
418 Adirondack)
419
420# 3D asteroid models of Toutatis, Kleopatra, Geographos, 1998 KY26, Bacchus,
421 Castalia and Golevka are courtesy of Scott Hudson, Washington State
422 University. His site is:
423 http://www.eecs.wsu.edu/~hudson/Research/Asteroids/models.html
424
425# 3D models of Phobos, Deimos, Amalthea, Janus, Epimetheus, Prometheus, Pandora,
426 Hyperion, Larissa, Proteus, Vesta, Ida, Gaspra and Halley are derived from
427 Phil Stooke's Cartography of Non-Spherical Worlds at:
428 http://publish.uwo.ca/~pjstooke/plancart.htm
429 and optical shape model dataset at:
430 http://pdssbn.astro.umd.edu/SBNast/holdings/EAR-A-5-DDR-STOOKE-SHAPE-MODELS-
431 V1.0.html
432
433# The 3D model of Eros was prepared from the NEAR laser rangefinder shape model
434 at: http://pdssbn.astro.umd.edu/NEARdb/nlr/#shape
435
436# The Phoebe mesh was designed by Jerry Gardner aka Jestr, jestr@ntlworld.com,
437 based on Phoebe's bumpy topography display from Cassini,
438 http://photojournal.jpl.nasa.gov/catalog/PIA06070
439
440
441Libraries
442---------
443
444# This software is based in part on the work of the Independent JPEG Group.
445
446# Some versions of Celestia may use the SPICE system for spacecraft and
447 planetary information, developed by Caltech/JPL under contract to NASA.
448
449# Many cylindrical projections of photographs were performed by Fridger
450 Schrempp with Matthew Arcus 'mmps' software,
451 http://www.users.globalnet.co.uk/~arcus/mmps/
452
453# The lower resolution textures were all converted from their higher resolution
454 versions using Gimp.
455
456# The star database (stars.dat) was derived from the ESA's HIPPARCOS data set.
457
458# Constellation boundaries are drawn from Davenhall & Leggett's "Catalogue of
459 Constellation Boundary Data":
460 http://cdsweb.u-strasbg.fr/viz-bin/ftp-index?/ftp/cats/VI/49
461
462
463Other work
464----------
465
466# Selden Ball deserves a special mention for suffering more prerelease versions
467 finding more bugs, and giving more feedback than anyone else.
468
469# Christophe Campos aka ElChristou created the splash screen for Celestia.
470
471# The MacOS X icon was designed by Chris Alford: http://www.chrisalford.com/
472
473# The txf font format used by Celestia was devised by Mark Kilgard.
474
475
476ACKNOWLEDGEMENTS
477----------------
478
479A very big thank you for creating Celestia goes to Chris Laurel who started this
480program in the year 2001.
481 <claurel@gmail.com>
482 http://www.shatters.net/~claurel/
483 http://www.shatters.net/celestia/
484
485Special thanks go to all Celestia users who submit bug reports, suggestions, and
486fixes. Celestia wouldn't be the program it is today, without their help.
487
488
489
490
491The Celestia Development Team
492
