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