en:software:stellarium [OST Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Stellarium ======

Stellarium is a free software to simulate a planetarium on your own computer. This article intends to give a short overview on the basic function and possibilities using Stellarium.

===== Install Stellarium =====

You can download the software on the official [[http://www.stellarium.org/en/|website]]. There are multiple versions for Windows (32/64Bit), Mac OS and Linux.

For Linux one gets the source code which has to be compiled. For Debian and their derivatives such as Ubuntu, Stellarium can easily be installed from the standard package repository:

<code>sudo apt-get install stellarium</code>


===== Working with Stellarium =====

Stellarium is capable of simulating the apparent sky at given time on any position on the earth. We will now go through the basic menus that control what you can see.

==== The menus ====

Stellarium has three different menu bars. Two in the lower left which appear only if the mouse is close. The third one is in the upper right corner and is always visible. 

=== Main menu ===

All basic functions can be found here as well as useful and necessary configurations. This is the vertical menu on the left.

|< 100%  15% 8% - >|
^                                     Button  ^  Hotkey  ^ Description ^
|  {{ost:stellarium:stellarium_menu_location.jpg?70}}  |  [F6]  | Choose your place on earth. Stellarium has a large list of known locations gathered by the community. There you find the //Astrophysical Institute Potsdam// which is the AIP in Potsdam Babelsberg. This is sufficiently close enough to Golm to plan lab course observations. Alternatively one can enter coordinates directly. One needs [[en:ost:telescope:grunddaten#coordinates|longitude, latitude, and elevation above ground level]]. A more rough method is to simply click into the shown map to retrieve coordinates. |
|  {{ost:stellarium:stellarium_menu_time.jpg?70}}  |  [F5]  | Configure the clock. \\  {{ost:stellarium:stellarium_menu_time_window.jpg}}  |
|  {{ost:stellarium:stellarium_menu_skyview.jpg?70}}  |  [F4]  | Here you can choose which objects are displayed.|
|  {{ost:stellarium:stellarium_menu_search.jpg?70}}  |  [F3]  | Opens the search window. Stellarium has an extensive database of over 100K stars, various nebulae, clusters, satellites and the like.  This can be extended by plug-ins. If there is an internet connection, Stellarium matches the search term with the database of [[http://simbad.u-strasbg.fr/simbad/sim-fid|Simbad]] and obtains the coordinates. This allows Stellarium to find an object with different designations. \\   {{ost:stellarium:stellarium_menu_search_window.jpg}} |
|  {{ost:stellarium:stellarium_menu_options.jpg?70}}  |  [F2]  | Opens the options menu|
|  {{ost:stellarium:stellarium_menu_help.jpg?70}}  |  [F1]  | Opens the help window|
|  {{ost:stellarium:stellarium_menu_exit.jpg?70}}  |  [STRG]+[Q]  | Exits Stellarium|

=== The observer menu ===

|< 100%  15% 20% 8% - >|
^  Buttons group  ^ Designation  ^  Hotkey  ^ Function ^
|  {{ost:stellarium:stellarium_menu_constellations.jpg?210}}  | Turns the display of constellations on and off. The options can be combined as desired.|  [C]  | Connecting lines between stars of the constellations are displayed. |
| :::                                                    | :::                                                                                                 |  [V]  | The name is displayed. |
| :::                                                    | :::                                                                                                  |  [R]  | Artistic impressions matching the constellations are displayed.|
|  {{ost:stellarium:stellarium_menu_coordinates.jpg?140}}  | Displays coordinate systems. |  [E]  | An azimuthal coordinate system (orange) in which the coordinates of an object depend on the choice of location.  |
| :::                                              |                    :::          |  [Z]  | The equatorial coordinate system  (blue) with the axes right ascension and declination. |
|  {{ost:stellarium:stellarium_menu_viewmode.jpg?280}}  | Controls the view in Stellarium |  [STRG]+[M]  | Viewing angle can be switched between azimuthal and horizontal mount. |
| :::                                             |    :::                            |  [LEER]  | Centers the view on an object as long as it is selected. |
| :::                                             | :::                               |  None  | Switches to night vision mode. Red light does not dazzle and destroys the eyes habituation to the dark less. |
| :::                                             | :::                               |  [F11]  | Switches between window and full screen mode. |
|  {{ost:stellarium:stellarium_menu_ocular.jpg?140}}  | Responsible for eyepiece view and finding satellites. |  [STRG]+[O]  | Switches to the eyepiece view and gives an impression of the field of view with different equipment, more about this under telescope menu. |
|  :::                                                 | :::                                                         |  [STRG]+[Z]  | Displays artificial satellites, selected ones also with predicted trajectory. |  |
|  {{ost:stellarium:stellarium_menu_objects.jpg?140}}  | Displays markers for additional objects.  |  [D]  | Deep sky objects, including galaxies, nebulae, and star clusters. |
| :::                                          | :::                                                  |  [P]  | Solar system objects, planets and their moons |
|   {{ost:stellarium:stellarium_menu_earth.jpg?210}}  | Switching on and off the influence of the earth |  [G]  | Toggles the display of the ground level. Useful to see how high an object is above the horizon. The ground display can be adjusted in the options menu to simulate high buildings or mountains in the vicinity. |
|   :::  |  :::  |  [Q]  | Display of cardinal directions for easier orientation |
|   :::  |  :::  |  [A]  | Switching the atmosphere. The artificial earth atmosphere simulates scattered light, refractive position changes, and extinction. |

|  {{ost:stellarium:stellarium_menu_timecontrol.jpg?280}}  | Control of the time flow. At startup Stellarium inherits the system time and lets the time run along. With the control the speed and direction of the time can be specified or completely stopped. |  [J]  | Fast rewind, each additional click increases speed |
| :::           | ::: |  [K]  | Pause the simulation, at increased speed it will be reset to normal. |
| :::           | ::: |  [8]  | Resets the clock to system time. The increased speed is preserved. |
| :::           | ::: |  [L]  | Fast forward, each additional click increases the speed |


=== The telescope menu ===

|< 100% 15% 20% - >|
^ Button group ^ Name ^ Function ^
| {{ost:stellarium:stellarium_menu_telescope.jpg?280}}  | The telescope menu offers the possibility to simulate the field of view of your own equipment. The use of this option is described [[en:software:stellarium#incorporation_of_own_observation_equipment| below]]. | Turns on the eyepiece view. Another button appears, which shows a crosshair.|
| ::: | ::: | Displays the size of the image sensor. |
| ::: | ::: | |
| ::: | ::: | Opens the configuration of the telescope plugin. |


==== What does Stellarium offer me? ====
Stellarium offers a considerable amount of additional information in addition to the simulation.

=== Level of detail and additional information ===
Stellarium outputs a list of parameters for each object. Most of these are coordinates in various coordinate systems. In addition, depending on the object, there is also basic information. For stars these are for example spectral type and photometric data. These are to be handled with care. Often these data differ from the current state of knowledge. Therefore, for each object at least the [[http://www.simbad.u-strasbg.fr/simbad/sim-fid|Simbad database]] should always be consulted.

=== Day and night cycle, scattered light ===
Stellarium simulates besides the positions of the objects also a luminosity cycle in the sky. This is based on a rough approximation including the positions of all luminous objects. First and foremost, the sun naturally provides the most scattered light. But also darker objects like the moon, Jupiter or Saturn can illuminate the sky around them so much that darker objects are no longer visible. However, the representation of Stellarium is only a rough guide, for observations at the OST the light scattering is greater due to the air pollution of the surrounding cities.

=== Incorporation of own observation equipment ===

There is the possibility to simulate the specifications of own observation equipment. For this a special PlugIn is needed, which is however already present in the standard installation. If it is activated, a new menu appears in the right, upper corner. There you can enter the parameters. Required are telescope aperture, focal length of the telescope, focal length of the eyepieces and the dimension of the camera chips. From this Stellarium calculates the field of view of any combination of the entered equipment. This can be helpful if, for example, a nebula is to be imaged. You can check in advance if the selected object is too big or too small for a certain configuration.

=== Extensions ===
There are a lot of extensions for Stellarium, too many to mention here. For working with the OST the standard installation is usually sufficient. Also installing additional catalogs makes only limited sense, because of the connection to the Simbad database. All known objects, which were listed somewhere once, can be found by their coordinates. Even if these objects are not always displayed.


==== How do I use Stellarium? ====

=== Planning an observation ===
Part of the preparation for any observation is putting together a list of objects. First and foremost, of course, the object selection depends on the nature of the desired observation itself. If it is clear what kind of objects one wants to observe, Stellarium can be used to check which objects come into question. To create an object list, one can roughly follow the steps below:

  - What do I want to observe? Stars, galaxies, nebulae?
  - What is visible at all during the day, or during the night of observation? For this purpose the time can be set in Stellarium to the desired night. The exact time depends on the season and on the observation planning. In summer the sun sets late, so you usually start late. In winter you can start much earlier. In winter even two different observations are possible in one night, the second one should be planned with a later time. Also the movement of an object has to be considered, if many exposures or a long exposure time are necessary for the observation. The OST follows the motion, but is powerless if an object sets or disappears behind buildings during the observation.
  - How bright is the object? Stellarium is able to estimate the brightness of an object with the influence of the Earth's atmosphere. 
  - How big is the object? In the case of nebulae or galaxies, the field of view of the telescope may be too small. For this purpose Stellarium offers a [[en:software:stellarium#incorporation_of_own_observation_equipment|comparison with the existing telescope equipment]].
  - What is in the near vicinity? Are there brighter objects that can influence my observation? The biggest interfering factor here is the moon, but Jupiter and Saturn can also brighten the sky around them so much due to their great brightness that darker objects are outshined. Even the brightest stars are practically unrecognizable close to the full moon. Stellarium displays the phase and degree of illumination of the moon. The graphical representation of other moons and planets is also dynamic, meaning that the illuminated area in Stellarium corresponds to that in the sky.
  - Are there any other detail requirements? Planets and moons of the solar system have special accuracy in Stellarium. For example, moons disappear behind Jupiter or cast a shadow on it as they pass by. The rotation of the planet itself is also included, and so it can be determined whether, for example, the great red spot of Jupiter is visible.
  - 
==== Controlling the telescope ====

Stellarium can also be used to [[en:ost:stellarium |control the telescope or to drive to objects]] directly. 

===== Alternatives =====

Stellarium already offers a lot of information with its many possibilities. Comparable powerful software is mostly not usable free of charge. A selection can be found [[en:etc:progs|here]].