Update README and INSTALL (Closes: #219)

pull/3/head
Hleb Valoshka 2019-01-29 22:27:15 +03:00
parent 44f0e3217e
commit 188c436611
2 changed files with 572 additions and 552 deletions

189
INSTALL
View File

@ -1,58 +1,58 @@
Basic installation instructions
-------------------------------
Install from you OS repository or from the official bintray repository
https://bintray.com/celestia.
https://bintray.com/celestia/celestia-builds/celestia-dev contains
official development snapshots.
To build from sources please follow instructions below.
Celestia Install instructions for UNIX Celestia Install instructions for UNIX
-------------------------------------- --------------------------------------
!!!!! Don't use this file. It's outdated. Use README. !!!!! First you need a C++ compiler able to compile C++11 code (GCC 4.8.1 or later,
!!!!! This file will be updated after switch to CMAKE !!!!! Clang 3.3 or later), CMake, GNU Make or Ninja.
You need to have the following components installed before Celestia Then you need to have the following devel components installed before Celestia
will build: OpenGL (tested with Mesa 3.4), glu, libjpeg, and libpng. will build: OpenGL, glu, glew, theora, libjpeg, and libpng. Optional packages
Should you have a package based installation (most Linux distributions these are fmtlib, Eigen3, Qt5, Gtk2 and glut.
days are), you will also need to install the devel packages for your OpenGL,
glu and glibc packages. For example on modern Debian-derived system you need to install the following
packages: libglew-dev, libjpeg-dev, libpng-dev, libtheora-dev, libgl1-mesa-dev,
libglu1-mesa-dev. Them you may want to install libeigen3-dev, libfmt-dev;
qtbase5-dev, qtbase5-dev-tools and libqt5opengl5-dev if you want to build with
Qt5 interface; libgtk2.0-dev and libgtkglext1-dev to build with legacy Gtk2
interface; or freeglut3-dev to build with glut interface.
OK, assuming you've collected all the necessary libraries, here's OK, assuming you've collected all the necessary libraries, here's
what you need to do to build and run Celestia: what you need to do to build and run Celestia:
./configure --with-INTERFACE [*] mkdir build
cd build
cmake .. -DENABLE_INTERFACE=ON [*]
make make
make install sudo make install
[*] INTERFACE must be replaced with one of "kde", "gtk", "gnome", or "glut". [*] INTERFACE must be replaced with one of "QT", "GTK", or "GLUT".
Four interfaces are available for Celestia: Three interfaces are available for Celestia on Unix-like systems:
- glut: minimal interface, barebone Celestia core with no toolbar or menu... - GLUT: minimal interface, barebone Celestia core with no toolbar or menu...
Disabled by default.
- GTK: A full interface with minimal dependencies, adds a menu, a configuration - GTK: A full interface with minimal dependencies, adds a menu, a configuration
dialog some other utilities. dialog some other utilities. Legacy interface, may lack some new
- Gnome: The full GTK interface plus a few Gnome integration goodies, such as features. Disabled by default.
preference saving in GConf. This looks and works very much like the - QT: A full interface with minimal dependencies, adds a menu, a configuration
Windows interface. dialog some other utilities, bookmarks... A preferred option. Enabled by
- KDE3: brings contextual menus, toolbars, KDE integration, default, No need to pass -DENABLE_QT=ON.
internationalization, bookmarks...
To build the KDE interface (requires various kde-devel packages): Starting with version 1.3.1, Lua is the new scripting engine for Celestia,
configure --with-kde
To build the Gnome interface (requires gnome-devel and all GTK requirements):
configure --with-gnome
To build the GTK interface (requires gtkglext and gtkglext-devel):
configure --with-gtk
To build the GLUT interface (requires glut and glut-devel):
configure --with-glut
At the end of the configure output shows which interface has been selected, you
should check it is correct before running make.
Starting with version 1.3.1, Lua is the new scripting engine for Celestia,
the old homegrown scripting engine is still available. By default Lua support the old homegrown scripting engine is still available. By default Lua support
will NOT be compiled in, to enable it you need to download the Lua library is enabled, it can be disabled passing -DENABLE_CELX=OFF to cmake.
from: Versions 5.1, 5.2 or 5.3 of Lua library is required. On Debian-based systems
http://www.lua.org/ either one of liblua5.3-dev, liblua5.2-dev or liblua5.1-dev should be installed
Version 5.0 or newer is required. to have Lua support.
Once Lua has been installed on your system, you need to run:
configure --with-lua=/path/to/lua
To check wether your Celestia has been compiled with Lua support, go to File To check wether your Celestia has been compiled with Lua support, go to File
-> Open. If you have '*.cel *.celx' in the filter box, then Lua is available -> Open. If you have '*.cel *.celx' in the filter box, then Lua is available
@ -65,27 +65,94 @@ by the build process. For instance, to build under SUSE Linux, you will also
need to have the gtk-devel package installed. need to have the gtk-devel package installed.
Celestia will be installed into /usr/local by default, with data files landing Celestia will be installed into /usr/local by default, with data files landing
in /usr/local/share/celestia , but you may specify a new location with the in /usr/local/share/celestia, but you may specify a new location with the
--prefix option to configure: following option to cmake: -DCMAKE_INSTALL_PREFIX=/another/path.
configure --prefix=/home/my_directory
All the other usual configure parameters apply; you may see which options
are available using 'configure --help'
If while running configure you see an error reporting that gl.h,
is missing, you either don't have OpenGL installed on your system,
or you don't have the corresponding devel package installed. If for
instance you have Mesa installed, you will also have to install the
mesa-devel package (or something named similarly). Missing glu.h or glut.h
means that you don't have GLU, GLUT, or their devel pacakges installed.
Chris Laurel & Deon Ramsey
claurel@.shatters.net dramsey@users.sourceforge.net
Updated 2003-06-10 by Celestia Install instructions for Windows
Christophe Teyssier -----------------------------------------
chris@teyssier.org
Updated 2004-04-28 by pat@suwalski.net Currently to build on Windows you need a Visual Studio 2015 or later, CMake
and vcpkg (*).
Install required packages:
vcpkg install libpng libjpeg-turbo gettext lua fmt glew eigen3
Install optional packages:
vcpkg install qt5
Configure and build 32-bit version:
md build32
cd build32
cmake -DCMAKE_TOOLCHAIN_FILE=c:/tools/vcpkg/scripts/buildsystems/vcpkg.cmake ..
cmake --build . -- /maxcpucount:N /nologo
Configure and build 64-bit version:
md build64
cd build64
cmake -DCMAKE_GENERATOR_PLATFORM=x64 -DCMAKE_TOOLCHAIN_FILE=c:/tools/vcpkg/scripts/buildsystems/vcpkg.cmake ..
cmake --build . -- /maxcpucount:N /nologo
Instead of N in /maxcpucount pass a number of CPU cores you want to use during
a build.
If you have Qt5 installed using official Qt installer, then pass parameter
CMAKE_PREFIX_PATH to cmake call used to configure Celestia, e.g.
cmake -DCMAKE_PREFIX_PATH=C:\Qt\5.10.1\msvc2015 ..
Not supported yet:
- automatic installation using cmake
- building using GNU toolchain (Mingw32), currently Work-In-Progress
- using Ninja instead of MSBuild
Notes:
* vcpkg installation instructions are located on
https://github.com/Microsoft/vcpkg
Celestia Install instructions for OS X
--------------------------------------
Currently not supported as nobody in the Team has access to an OS X system.
Supported CMake parameters
--------------------------
List of supported parameters (passed as -DPARAMETER=VALUE):
| Parameter | TYPE | Default | Description
+----------------------+------+---------+--------------------------------------
| CMAKE_INSTALL_PREFIX | path | * | Prefix where to install Celestia
| CMAKE_PREFIX_PATH | path | | Additional path to look for libraries
| LEGACY_OPENGL_LIBS | bool | **OFF | Use OpenGL libraries not GLvnd
| ENABLE_CELX | bool | ON | Enable Lua scripting support
| ENABLE_SPICE | bool | OFF | Enable NAIF kernels support
| ENABLE_NLS | bool | ON | Enable interface translation
| ENABLE_GLUT | bool | OFF | Build simple Glut frontend
| ENABLE_GTK | bool | **OFF | Build legacy GTK2 frontend
| ENABLE_QT | bool | ON | Build Qt frontend
| ENABLE_WIN | bool | ***ON | Build Windows native frontend
| ENABLE_THEORA | bool | **ON | Support video capture to OGG Theora
Notes:
* /usr/local on Unix-like systems, c:\Program Files or c:\Program Files (x86)
on Windows depending on OS type (32 or 64 bit) and build configuration.
** Ignored on Windows systems.
*** Ignored on Unix-like systems.
Parameters of type "bool" accept ON or OFF value. Parameters of type "path"
accept any directory.
On Windows systems two additonal options are supported:
- CMAKE_GENERATOR_PLATFORM - can be set to x64 on 64-bit Windows to build
64-bit Celestia. To build 32-bit Celestia it should be omitted.
- CMAKE_TOOLCHAIN_FILE - location of vcpkg.cmake if vcpkg is used.

935
README
View File

@ -1,491 +1,444 @@
*************************************************************************** ***************************************************************************
* Celestia Fork * * Celestia *
* * * *
* A real-time space simulation that lets you experience our universe in * * A real-time space simulation that lets you experience our universe in *
* three dimensions. * * three dimensions. *
* * * *
* Copyright (c) 2001-2018, Celestia Development Team * * Copyright (c) 2001-2019, Celestia Development Team *
* * * *
*-------------------------------------------------------------------------* *-------------------------------------------------------------------------*
* Celestia web site: http://www.shatters.net/celestia/ * * Celestia web site: https://celestia.space *
* * * *
* Celestia documentation: * * Celestia documentation: *
* http://celestiamotherlode.net/catalog/documentation.html * * http://celestiamotherlode.net/catalog/documentation.html *
* Celestia WikiBook: http://en.wikibooks.org/wiki/Celestia * * Celestia WikiBook: http://en.wikibooks.org/wiki/Celestia *
* * * *
* Celestia forums: https://celestia.space/forum/ * * Celestia forums: https://celestia.space/forum/ *
* * * *
*************************************************************************** ***************************************************************************
CONTENTS CONTENTS
-------- --------
License License
Installing in Unix and Linux Getting Started
Getting Started Mouse, Keyboard & Joystick Controls
Mouse, Keyboard & Joystick Controls Star & Solar System Browser
Star & Solar System Browser Selecting Objects by Name
Selecting Objects by Name Known Issues
Known Issues User Modifiable Elements
User Modifiable Elements Celestia Resources
Celestia Resources Contributions
Contributions Acknowledgements
Acknowledgements
LICENSE
LICENSE -------
------- This program is free software; you can redistribute it and/or modify it under
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
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
Foundation; either version 2 of the License, or (at your option) any later version.
version.
This program is distributed in the hope that it will be useful, but WITHOUT
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
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details, which you should have received along with this program (filename:
details, which you should have received along with this program (filename: COPYING). If not, request a copy from:
COPYING). If not, request a copy from: Free Software Foundation, Inc.
Free Software Foundation, Inc. 59 Temple Place - Suite 330
59 Temple Place - Suite 330 Boston, MA 02111-1307
Boston, MA 02111-1307 USA
USA
GETTING STARTED
INSTALLING IN UNIX AND LINUX ---------------
---------------------------- Celestia will start up in a window, and if everything is working correctly,
Currently only QT5 based backend is available. To build it you need QT5 you'll see Earth in front of a field of stars. Displayed on-screen, is some
developer libraries. information about your target (Earth), your speed, and the current time
(Universal Time, so it'll probably be a few hours off from your computer's
On Debian based systems the following packages should be installed: clock).
* qtbase5-dev-tools
* qtbase5-dev Right drag the mouse to orbit Earth and you might see the Moon and some
* libqt5opengl5-dev familiar constellations. Left dragging the mouse changes your orientation
* qtchooser also, but the camera rotates about its center instead of rotating around
* libglu1-mesa-dev Earth. Rolling the mouse wheel will change your distance to Earth--you can
* libpng-dev move light years away, then roll the wheel in the opposite direction to get
* libjpeg-dev back to your starting location. If your mouse lacks a wheel, you can use the
* libtheora-dev Home and End keys instead.
* Either one of liblua5.3-dev, liblua5.2-dev or liblua5.1-dev
When running Celestia, you will usually have some object selected. Currently,
Optional packages are libeigen3-dev and libglew-dev. it's Earth, but it could also be a star, moon, spacecraft, galaxy, or some
other object. The simplest way to select an object is to click on it. Try
Then do the following actions in Celestia's source directory: clicking on a star to select it. The information about Earth is replaced with
mkdir build && cd build some details about the star. Press G (or use the Navigation menu), and you'll
qmake -qt=5 PREFIX=/opt/celestia -o Makefile ../celestia.pro zoom through space toward the selected star. If you press G again, you'll
make approach the star even closer.
sudo make install
Press H to select our Sun, and then G to go back to our Sun. Right click on
You can speedup build passing option -jN to make where N is a number of the sun to bring up a menu of planets and other objects in the solar system.
your CPU cores. After selecting a planet from the menu, hit G again to travel toward it. Once
there, hold down the right mouse button and drag to orbit the planet.
An executable binary will be installed to /opt/celestia/bin/Celestia_QT.
The Tour Guide is a list of some of the more interesting objects you can visit
GETTING STARTED in Celestia. Select the Tour Guide option in the Navigation menu to display
--------------- the Tour Guide window. Choose a destination from the list, click the Goto
Celestia will start up in a window, and if everything is working correctly, button, and you're off.
you'll see Earth in front of a field of stars. Displayed on-screen, is some
information about your target (Earth), your speed, and the current time That covers the very basics. For a more in-depth look at Celestia and the
(Universal Time, so it'll probably be a few hours off from your computer's controls available to you, download the "Celestia User's Guide" (written by
clock). Frank Gregorio), available in several languages, from:
http://celestiamotherlode.net/catalog/documentation.html
Right drag the mouse to orbit Earth and you might see the Moon and some This web page also includes links to the Celestia README file translated into
familiar constellations. Left dragging the mouse changes your orientation Japanese.
also, but the camera rotates about its center instead of rotating around
Earth. Rolling the mouse wheel will change your distance to Earth--you can
move light years away, then roll the wheel in the opposite direction to get MOUSE, KEYBOARD & JOYSTICK CONTROLS
back to your starting location. If your mouse lacks a wheel, you can use the -----------------------------------
Home and End keys instead. See the included file: controls.txt OR use the Help menu to display the Controls
list.
When running Celestia, you will usually have some object selected. Currently,
it's Earth, but it could also be a star, moon, spacecraft, galaxy, or some
other object. The simplest way to select an object is to click on it. Try STAR & SOLAR SYSTEM BROWSER
clicking on a star to select it. The information about Earth is replaced with -------------------------------------------
some details about the star. Press G (or use the Navigation menu), and you'll The Navigation menu contains 'Solar System Browser' and 'Star Browser'
zoom through space toward the selected star. If you press G again, you'll options.
approach the star even closer.
STAR BROWSER
Press H to select our Sun, and then G to go back to our Sun. Right click on
the sun to bring up a menu of planets and other objects in the solar system. By default, the Star Browser window displays a table of the 100 nearest stars,
After selecting a planet from the menu, hit G again to travel toward it. Once along with their Distance, Apparent and Absolute Magnitude, and Type. Clicking
there, hold down the right mouse button and drag to orbit the planet. on the column headers will sort the stars. The table is not continuously
updated, so if you travel to another star, you should press the Refresh button
The Tour Guide is a list of some of the more interesting objects you can visit to update the table for your current position. The radio buttons beneath the
in Celestia. Select the Tour Guide option in the Navigation menu to display table let you switch between viewing a list of Nearest, Brightest, or 'With
the Tour Guide window. Choose a destination from the list, click the Goto planets' stars. As with the solar system browser, clicking on any star name
button, and you're off. in the table will select it. Use this feature along with the Center and Go
To buttons to tour the stars visible from any night sky in the galaxy.
That covers the very basics. For a more in-depth look at Celestia and the
controls available to you, download the "Celestia User's Guide" (written by SOLAR SYSTEM BROWSER
Frank Gregorio), available in several languages, from:
http://celestiamotherlode.net/catalog/documentation.html The Solar System Browser displays a window with a tree view of all the objects
This web page also includes links to the Celestia README file translated into in the nearest solar system (if there is one within a light year of your current
Japanese. position.) Clicking on the name of any object in the window will select it.
You can then use the Center or Go To buttons to display that object in the main
Celestia window.
MOUSE, KEYBOARD & JOYSTICK CONTROLS
-----------------------------------
See the included file: controls.txt OR use the Help menu to display the Controls SELECTING OBJECTS BY NAME
list. -------------------------
Celestia provides several ways to select an object by name...
1. Choose 'Select Object' from the Navigation menu, type in the object
STAR & SOLAR SYSTEM BROWSER name, and click OK.
-------------------------------------------
The Navigation menu contains 'Solar System Browser' and 'Star Browser' 2. Press Enter, type in the entire object name, and press Enter again.
options.
3. Press Enter, type in the first few characters of the object name,
STAR BROWSER press the Tab key to move through the displayed listing until the
object is highlighted, then press Enter again.
By default, the Star Browser window displays a table of the 100 nearest stars,
along with their Distance, Apparent and Absolute Magnitude, and Type. Clicking You can use common names, Bayer designations or catalog numbers for stars.
on the column headers will sort the stars. The table is not continuously Celestia currently supports the HIP, HD and SAO catalogs. Catalog numbers must
updated, so if you travel to another star, you should press the Refresh button be entered with a space between the prefix and the catalog number.
to update the table for your current position. The radio buttons beneath the
table let you switch between viewing a list of Nearest, Brightest, or 'With
planets' stars. As with the solar system browser, clicking on any star name KNOWN ISSUES
in the table will select it. Use this feature along with the Center and Go ------------
To buttons to tour the stars visible from any night sky in the galaxy. For up-to-the-minute answers to some common problems encountered when running
Celestia, please view either the FAQ in the Help menu or take a look at the
SOLAR SYSTEM BROWSER "Celestia User's FAQ" located on the Celestia User's Forum:
https://celestia.space/forum/
The Solar System Browser displays a window with a tree view of all the objects
in the nearest solar system (if there is one within a light year of your current
position.) Clicking on the name of any object in the window will select it. USER MODIFIABLE ELEMENTS
You can then use the Center or Go To buttons to display that object in the main ------------------------
Celestia window. You can modify how Celestia starts up each time you run it, by defining your
own start-up settings. Simply open the file "start.cel" in a plain text
editor and follow the in-file instructions. Also, view the celestia.cfg file
SELECTING OBJECTS BY NAME in a plain text editor to see additional settings.
-------------------------
Celestia provides several ways to select an object by name... Celestia allows you to easily add real, hypothetical, or fictional objects
1. Choose 'Select Object' from the Navigation menu, type in the object by creating new catalog files. It is *not* recommended that you alter the
name, and click OK. built-in data files; nearly all desired modifications and additions can be
made by placing new catalog files in Celestia's extras folders. There are three
2. Press Enter, type in the entire object name, and press Enter again. types of catalog files:
- ssc (solar system catalog: planets, moons, spacecraft, etc.)
3. Press Enter, type in the first few characters of the object name, - stc (star catalog)
press the Tab key to move through the displayed listing until the - dsc (deep sky catalog: galaxies, star clusters, and nebulae)
object is highlighted, then press Enter again. All three types of catalog file are text files that can be updated with your
favorite text editing program.
You can use common names, Bayer designations or catalog numbers for stars.
Celestia currently supports the HIP, HD and SAO catalogs. Catalog numbers must
be entered with a space between the prefix and the catalog number. CELESTIA RESOURCES
------------------
Celestia Web Site:
KNOWN ISSUES https://celestia.space
------------
For up-to-the-minute answers to some common problems encountered when running Celestia User Forums:
Celestia, please view either the FAQ in the Help menu or take a look at the https://celestia.space/forum/
"Celestia User's FAQ" located on the Celestia User's Forum:
http://www.shatters.net/forum/ Selden's List of Resources for Celestia :
http://www.lepp.cornell.edu/~seb/celestia/
USER MODIFIABLE ELEMENTS Celestia WikiBook:
------------------------ http://en.wikibooks.org/wiki/Celestia
You can modify how Celestia starts up each time you run it, by defining your
own start-up settings. Simply open the file "start.cel" in a plain text Celestial Matters Website and Forums:
editor and follow the in-file instructions. Also, view the celestia.cfg file http://www.celestialmatters.org/
in a plain text editor to see additional settings. http://forum.celestialmatters.org/
Celestia allows you to easily add real, hypothetical, or fictional objects Celestia Motherlode:
by creating new catalog files. It is *not* recommended that you alter the http://www.celestiamotherlode.net/
built-in data files; nearly all desired modifications and additions can be
made by placing new catalog files in Celestia's extras folders. There are three Celestia Cource Repository:
types of catalog files: https://github.com/CelestiaProject/Celestia
- ssc (solar system catalog: planets, moons, spacecraft, etc.)
- stc (star catalog) Celestia Binary Repository:
- dsc (deep sky catalog: galaxies, star clusters, and nebulae) https://bintray.com/celestia
All three types of catalog file are text files that can be updated with your
favorite text editing program. Celestia Bug Tracking (SourceForge.net):
https://github.com/CelestiaProject/celestia/issues
CELESTIA RESOURCES Celestia Feature Requests (SourceForge.net):
------------------ https://github.com/CelestiaProject/celestia/issues
Celestia Web Site:
https://github.com/CelestiaFork/celestia
CONTRIBUTIONS
Celestia User Forums: -------------
https://celestia.space/forum/
Authors
Selden's List of Resources for Celestia : -------
http://www.lepp.cornell.edu/~seb/celestia/ Chris Laurel <claurel@gmail.com>
Clint Weisbrod <cweisbrod@cogeco.ca>
Celestia WikiBook: Fridger Schrempp <t00fri@mail.desy.de>
http://en.wikibooks.org/wiki/Celestia Bob Ippolito <bob@redivi.com>
Christophe Teyssier <chris@teyssier.org>
Celestial Matters Website and Forums: Hank Ramsey <hramsey@users.sourceforge.net>
http://www.celestialmatters.org/ Grant Hutchison <grant.celestia@xemaps.com>
http://forum.celestialmatters.org/ Pat Suwalski <pat@suwalski.net>
Toti
Celestia Motherlode: Da Woon Jung <dirkpitt2050@users.sf.net>
http://www.celestiamotherlode.net/ Vincent Giangiulio <vince.gian@free.fr>
Andrew Tribick
Celestia Fork Source Code (SourceForge.net):
https://github.com/CelestiaFork/celestia Contributors
------------
Celestia Bug Tracking (SourceForge.net): Deon Ramsey ........... original GTK1 interface
https://github.com/CelestiaFork/celestia/issues Christopher ANDRE ..... Eclipse Finder
Colin Walters ......... Endianness fixes
Celestia Feature Requests (SourceForge.net): Peter Chapman ......... Orbit path rendering changes
https://github.com/CelestiaFork/celestia/issues James Holmes ..........
Harald Schmidt ........ Lua scripting enhancements, bug fixes
Nils Larsson .......... Qt enhancements
CONTRIBUTIONS
------------- Documentation
-------------
Authors Frank Gregorio ........ Celestia User's Guide
------- Hitoshi Suzuki ........ Japanese README translation
Chris Laurel <claurel@gmail.com> Christophe Teyssier ... DocBook and HTML conversion of User's Guide
Clint Weisbrod <cweisbrod@cogeco.ca> Diego Rodriguez ....... Acrobat conversion of User's Guide
Fridger Schrempp <t00fri@mail.desy.de> Don Goyette ........... CEL Scripting Guide
Bob Ippolito <bob@redivi.com> Harald Schmidt ........ Celx/Lua Scripting Guide
Christophe Teyssier <chris@teyssier.org>
Hank Ramsey <hramsey@users.sourceforge.net>
Grant Hutchison <grant.celestia@xemaps.com> Scientific Data Base
Pat Suwalski <pat@suwalski.net> --------------------
Toti
Da Woon Jung <dirkpitt2050@users.sf.net> # Grant Hutchison
Vincent Giangiulio <vince.gian@free.fr> Supplied the correct orientations for the major planets, their moons, and a
Andrew Tribick number of asteroids and also worked on these data files:
Solarsys.ssc, nearstars.stc, extrasolar.ssc, extrasolar.stc, earth_locs.ssc
Contributors
------------ # Fridger Schrempp
Deon Ramsey ........... original GTK1 interface Complete NGC/IC galaxy database + local group galaxies (galaxies.dsc)
Christopher ANDRE ..... Eclipse Finder Data base on globular clusters (globulars.dsc)
Colin Walters ......... Endianness fixes
Peter Chapman ......... Orbit path rendering changes Data base on visual and spectroscopic binaries (visualbins.stc,
James Holmes .......... spectbins.stc)
Harald Schmidt ........ Lua scripting enhancements, bug fixes
Nils Larsson .......... Qt enhancements World-capitals.ssc
Documentation Asterisms.dat
-------------
Frank Gregorio ........ Celestia User's Guide # Andrew Tribick
Hitoshi Suzuki ........ Japanese README translation Significant update of the star.dat base based on new HIP Reduction of the
Christophe Teyssier ... DocBook and HTML conversion of User's Guide Raw data, Floor van Leeuwen, 2007.
Diego Rodriguez ....... Acrobat conversion of User's Guide
Don Goyette ........... CEL Scripting Guide CHARM2 stellar radii (charm2.stc)
Harald Schmidt ........ Celx/Lua Scripting Guide
Texture maps
Scientific Data Base ------------
--------------------
# Most of the planet maps are from David Seal's site:
# Grant Hutchison http://maps.jpl.nasa.gov/.
Supplied the correct orientations for the major planets, their moons, and a A few of these maps were modified by me, with fictional terrain added to fill
number of asteroids and also worked on these data files: in gaps. The model of the Galileo spacecraft is also from David Seal's site
Solarsys.ssc, nearstars.stc, extrasolar.ssc, extrasolar.stc, earth_locs.ssc (though it was converted from Inventor to 3DS format.)
# Fridger Schrempp # The Mars, Neptune, and Uranus textures and Mars bump maps are all from James
Complete NGC/IC galaxy database + local group galaxies (galaxies.dsc) Hastings-Trew's collection.
Data base on globular clusters (globulars.dsc) # Grant Hutchison
Data base on visual and spectroscopic binaries (visualbins.stc, Saturn's rings were built by Grant Hutchison from Cassini imaging.
spectbins.stc) The Eros map is a shaded relief generated from the NEAR laser rangefinder.
World-capitals.ssc # Jens Meyer
Asterisms.dat Dione and Rhea are USGS maps colored and modified by Jens Meyer.
# Andrew Tribick The Moon map is based on data from PDS Map-A-Planet at with colors from
Significant update of the star.dat base based on new HIP Reduction of the Mark Robinson.
Raw data, Floor van Leeuwen, 2007.
# Fridger Schrempp
CHARM2 stellar radii (charm2.stc)
'Available data' Pluto and Charon textures using maps created by Marc Buie
at Lowell Observatory. Buie's maps were generated from photometric data
Texture maps gathered during six years of mutual occultations of Pluto and Charon.
------------
Titan's cloud texture in natural colors and its surface map at near-infrared
# Most of the planet maps are from David Seal's site: wavelength. They are based on resources available from the imaging site
http://maps.jpl.nasa.gov/. (Ciclops) of the Cassini mission http://ciclops.org/
A few of these maps were modified by me, with fictional terrain added to fill
in gaps. The model of the Galileo spacecraft is also from David Seal's site The Phoebe base texture was created from the cylindrical map published by
(though it was converted from Inventor to 3DS format.) the Cassini imaging team
(http://photojournal.jpl.nasa.gov/catalog/PIA07775)
# The Mars, Neptune, and Uranus textures and Mars bump maps are all from James
Hastings-Trew's collection. His maps may be found here: The Tethys textures are based on the Oct 2008 Ciclops map
http://gw.marketingden.com/planets/planets.html (http://photojournal.jpl.nasa.gov/catalog/PIA11116)
# Grant Hutchison The Iapetus texture was created from the Oct 2008 Ciclops map
(http://photojournal.jpl.nasa.gov/catalog/PIA11116)
Saturn's rings were built by Grant Hutchison from Cassini imaging, with
transparency information derived from stellar transit data obtained from: The Lunar topography and bump maps, using Clementine laser altimeter data,
http://pds-rings.arc.nasa.gov/ringocc/ringocc.html merged in the polar regions with topographic data from Clementine 750 nm
oblique and nadir images.
The Eros map is a shaded relief generated from the NEAR laser rangefinder
shape model at: The Mercury map was created from a combination of Mariner 10 imaging
http://pdssbn.astro.umd.edu/NEARdb/nlr/#shape with recent MESSENGER WAC images from the first two flybys, as collected
and reprojected by Steve Albers.
# Jens Meyer
# Phil Stooke
Dione and Rhea are USGS maps colored and modified by Jens Meyer.
Proteus, Janus, Prometheus and Epimetheus maps are from Phil Stooke.
The Moon map is based on data from PDS Map-A-Planet at
http://pdsmaps.wr.usgs.gov/maps.html with colors from Mark Robinson at The Ida and Gaspra photomosaic maps are by Phil Stooke.
http://www.earth.northwestern.edu/research/robinson/MOON/clem_color.html.
# Venus's clouds and the textures for Ganymede, Callisto and Saturn are from
# Fridger Schrempp Björn Jónsson.
'Available data' Pluto and Charon textures using maps created by Marc Buie # Venus's surface is a copyright-free NASA image, prepared from Magellan radar
at Lowell Observatory. Buie's maps were generated from photometric data data. The original is available at
gathered during six years of mutual occultations of Pluto and Charon. http://www.solarviews.com/cap/venus/venmap.htm
Titan's cloud texture in natural colors and its surface map at near-infrared # The Earth texture was created by NASA using data from the MODIS instrument
wavelength. They are based on resources available from the imaging site aboard the Terra satellite.
(Ciclops) of the Cassini mission
(http://ciclops.lpl.arizona.edu/index.php) # Steve Albers
The Io and Europa maps are by Steve Albers.
The Phoebe base texture was created from the cylindrical map published by
the Cassini imaging team # The textures for the Uranian satellites were created by Ivan Rivera from JPL
(http://photojournal.jpl.nasa.gov/catalog/PIA07775) data. His Celestia page is: http://bruckner.homelinux.net/celestia.html
The Tethys textures are based on the Oct 2008 Ciclops map # The Hyperion map is a photomosaic assembled by Phil Stooke and
(http://photojournal.jpl.nasa.gov/catalog/PIA11116) colored by Jens Meyer.
The Iapetus texture was created from the Oct 2008 Ciclops map # Amalthea is a shaded relief map by Phil Stooke, colored by Wm. Robert Johnston
(http://photojournal.jpl.nasa.gov/catalog/PIA11116) (http://www.johnstonsarchive.net/spaceart/cylmaps.html), and further modified
by Jens Meyer and Grant Hutchison.
The Lunar topography and bump maps, using Clementine laser altimeter data,
merged in the polar regions with topographic data from Clementine 750 nm # The asteroid.jpg texture was created by Paul Roberts.
oblique and nadir images
(ftp://ftpflag.wr.usgs.gov/dist/pigpen/moon/usgs/topo/global/) # The textures for the five classes of extrasolar giant planet were created by
Andrew Tribick.
The Mercury map was created from a combination of Mariner 10 imaging
with recent MESSENGER WAC images from the first two flybys, as collected # CICLOPS
and reprojected by Steve Albers:
See http://laps.noaa.gov/albers/sos/sos.html. The map of Enceladus is derived from the December 2008 CICLOPS map:
http://ciclops.org/view/5447/Map_of_Enceladus_December_2008
# Phil Stooke
Proteus, Janus, Prometheus and Epimetheus maps are from Phil Stooke. 3D Models
---------
The Ida and Gaspra photomosaic maps are by Phil Stooke.
# Models of Mars Global Surveyor and Mars Odyssey were created by Shrox:
# Venus's clouds and the textures for Ganymede, Callisto and Saturn are from http://www.shrox.com/
Bj<42>rn J<>nsson. His site at http://www.mmedia.is/~bjj/ is an excellent
resource for solar system rendering. # The Cassini and Huygens models are by Jack Higgins:
http://homepage.eircom.net/~jackcelestia/
# Venus's surface is a copyright-free NASA image, prepared from Magellan radar
data. The original is available at # The 3D model of ISS is a deconstruction of Andrew Farnaby's
http://www.solarviews.com/cap/venus/venmap.htm complete ISS model with textures by Bob Hundley. The model
represents the ISS as of June 2008 and is a modification of
# The Earth texture was created by NASA using data from the MODIS instrument the model that can be found here:
aboard the Terra satellite. Further information is available from: http://www.celestiamotherlode.net/catalog/show_addon_details.php?addon_id=1199
http://earthobservatory.nasa.gov/Newsroom/BlueMarble/ ISS model of June 2008 (with Kibo) by krisci3 (modified and
converted in order to work with JPG by Ulrich Dickmann, a.k.a.
# Steve Albers Adirondack)
The Io and Europa maps are by Steve Albers. His planetary maps are at:
http://laps.noaa.gov/albers/sos/sos.html # 3D asteroid models of Toutatis, Kleopatra, Geographos, 1998 KY26, Bacchus,
Castalia and Golevka are courtesy of Scott Hudson, Washington State
# The textures for the Uranian satellites were created by Ivan Rivera from JPL University.
data. His Celestia page is: http://bruckner.homelinux.net/celestia.html
# 3D models of Phobos, Deimos, Amalthea, Janus, Epimetheus, Prometheus, Pandora,
# The Hyperion map is a photomosaic assembled by Phil Stooke and Hyperion, Larissa, Proteus, Vesta, Ida, Gaspra and Halley are derived from
colored by Jens Meyer. Phil Stooke's Cartography of Non-Spherical Worlds.
# Amalthea is a shaded relief map by Phil Stooke, colored by Wm. Robert Johnston # The 3D model of Eros was prepared from the NEAR laser rangefinder shape model.
(http://www.johnstonsarchive.net/spaceart/cylmaps.html), and further modified
by Jens Meyer and Grant Hutchison. # The Phoebe mesh was designed by Jerry Gardner aka Jestr, jestr@ntlworld.com,
based on Phoebe's bumpy topography display from Cassini,
# The asteroid.jpg texture was created by Paul Roberts. http://photojournal.jpl.nasa.gov/catalog/PIA06070
# The textures for the five classes of extrasolar giant planet were created by
Andrew Tribick. Libraries
---------
# CICLOPS
# This software is based in part on the work of the Independent JPEG Group.
The map of Enceladus is derived from the December 2008 CICLOPS map:
http://ciclops.org/view/5447/Map_of_Enceladus_December_2008 # Some versions of Celestia may use the SPICE system for spacecraft and
planetary information, developed by Caltech/JPL under contract to NASA.
3D Models # Many cylindrical projections of photographs were performed by Fridger
--------- Schrempp with Matthew Arcus 'mmps' software,
http://www.users.globalnet.co.uk/~arcus/mmps/
# Models of Mars Global Surveyor and Mars Odyssey were created by Shrox:
http://www.shrox.com/ # The lower resolution textures were all converted from their higher resolution
versions using Gimp.
# The Cassini and Huygens models are by Jack Higgins:
http://homepage.eircom.net/~jackcelestia/ # The star database (stars.dat) was derived from the ESA's HIPPARCOS data set.
# The 3D model of ISS is a deconstruction of Andrew Farnaby's # Constellation boundaries are drawn from Davenhall & Leggett's "Catalogue of
complete ISS model with textures by Bob Hundley. The model Constellation Boundary Data":
represents the ISS as of June 2008 and is a modification of http://cdsweb.u-strasbg.fr/viz-bin/ftp-index?/ftp/cats/VI/49
the model that can be found here:
http://www.celestiamotherlode.net/catalog/show_addon_details.php?addon_id=1199
ISS model of June 2008 (with Kibo) by krisci3 (modified and Other work
converted in order to work with JPG by Ulrich Dickmann, a.k.a. ----------
Adirondack)
# Selden Ball deserves a special mention for suffering more prerelease versions
# 3D asteroid models of Toutatis, Kleopatra, Geographos, 1998 KY26, Bacchus, finding more bugs, and giving more feedback than anyone else.
Castalia and Golevka are courtesy of Scott Hudson, Washington State
University. His site is: # Christophe Campos aka ElChristou created the splash screen for Celestia.
http://www.eecs.wsu.edu/~hudson/Research/Asteroids/models.html
# The MacOS X icon was designed by Chris Alford: http://www.chrisalford.com/
# 3D models of Phobos, Deimos, Amalthea, Janus, Epimetheus, Prometheus, Pandora,
Hyperion, Larissa, Proteus, Vesta, Ida, Gaspra and Halley are derived from # The txf font format used by Celestia was devised by Mark Kilgard.
Phil Stooke's Cartography of Non-Spherical Worlds at:
http://publish.uwo.ca/~pjstooke/plancart.htm
and optical shape model dataset at: ACKNOWLEDGEMENTS
http://pdssbn.astro.umd.edu/SBNast/holdings/EAR-A-5-DDR-STOOKE-SHAPE-MODELS- ----------------
V1.0.html
A very big thank you for creating Celestia goes to Chris Laurel who started this
# The 3D model of Eros was prepared from the NEAR laser rangefinder shape model program in the year 2001.
at: http://pdssbn.astro.umd.edu/NEARdb/nlr/#shape <claurel@gmail.com>
http://www.shatters.net/~claurel/
# The Phoebe mesh was designed by Jerry Gardner aka Jestr, jestr@ntlworld.com, http://www.shatters.net/celestia/
based on Phoebe's bumpy topography display from Cassini,
http://photojournal.jpl.nasa.gov/catalog/PIA06070 Special thanks go to all Celestia users who submit bug reports, suggestions, and
fixes. Celestia wouldn't be the program it is today, without their help.
Libraries
---------
# This software is based in part on the work of the Independent JPEG Group. The Celestia Development Team
# Some versions of Celestia may use the SPICE system for spacecraft and
planetary information, developed by Caltech/JPL under contract to NASA.
# Many cylindrical projections of photographs were performed by Fridger
Schrempp with Matthew Arcus 'mmps' software,
http://www.users.globalnet.co.uk/~arcus/mmps/
# The lower resolution textures were all converted from their higher resolution
versions using Gimp.
# The star database (stars.dat) was derived from the ESA's HIPPARCOS data set.
# Constellation boundaries are drawn from Davenhall & Leggett's "Catalogue of
Constellation Boundary Data":
http://cdsweb.u-strasbg.fr/viz-bin/ftp-index?/ftp/cats/VI/49
Other work
----------
# Selden Ball deserves a special mention for suffering more prerelease versions
finding more bugs, and giving more feedback than anyone else.
# Christophe Campos aka ElChristou created the splash screen for Celestia.
# The MacOS X icon was designed by Chris Alford: http://www.chrisalford.com/
# The txf font format used by Celestia was devised by Mark Kilgard.
ACKNOWLEDGEMENTS
----------------
A very big thank you for creating Celestia goes to Chris Laurel who started this
program in the year 2001.
<claurel@gmail.com>
http://www.shatters.net/~claurel/
http://www.shatters.net/celestia/
Special thanks go to all Celestia users who submit bug reports, suggestions, and
fixes. Celestia wouldn't be the program it is today, without their help.
The Celestia Development Team