.. _user-interface: Control panel ************* The Gaia Sky control panel is divided into seven panes, `Time <#time>`__, `Camera <#camera>`__, `Type visibility <#type-visibility>`__, `Visual settings <#visual-settings>`__, `Datasets <#datasets>`__, `Objects <#objects>`__, and `Music <#music>`__. +----------------------------------------------------+-------------------------------------------------------+ | .. image:: img/ui/control-panel-collapsed.jpg | .. image:: img/ui/control-panel-expanded.jpg | | :width: 45% | :width: 45% | | :alt: User interface with all panes collapsed | :alt: User interface with camera pane expanded | +----------------------------------------------------+-------------------------------------------------------+ | Collapsed control panel | Expanded control panel | +----------------------------------------------------+-------------------------------------------------------+ The seven panes, except for the Time pane, are collapsed at startup. To expand them and reveal its controls just click on the little arrow bottom icon |caret-bottom| at the right of the pane title. Use the arrow right icon |caret-right| to collapse it again. Panes can also be detached to their own window. To do so, use the detach icon |detach-icon|. .. |caret-bottom| image:: img/ui/iconic-caret-bottom.png .. |caret-right| image:: img/ui/iconic-caret-right.png .. |plus-icon| image:: img/ui/plus-icon.png .. |minus-icon| image:: img/ui/minus-icon.png .. |detach-icon| image:: img/ui/detach-icon.png Time ==== Play and pause the simulation using the |play-icon|/|pause-icon| ``Play/Pause`` buttons in the time pane, or toggle using :guilabel:`Space`. You can also change time warp, which is expressed as a scaling factor, using the provided **Warp factor** slider. Use :guilabel:`,` or |minus-icon| and :guilabel:`.` or |plus-icon| to divide by 2 and double the value of the time warp respectively. .. figure:: img/ui/warp-factor.jpg :width: 45% :align: center Warp factor slider .. |play-icon| image:: img/ui/play-icon.png .. |pause-icon| image:: img/ui/pause-icon.png .. |warp-factor| image:: img/ui/warp-factor.jpg Camera ====== In the camera options pane on the left you can select the type of camera. This can also be done by using the :guilabel:`Numpad 0-7` keys. There are eight camera modes: * **Free mode** -- the camera is not linked to any object and its velocity is exponential with respect to the distance to the origin (Sun). * **Focus mode** -- the camera is linked to a focus object and it rotates and rolls with respect to it. * **Game mode** -- a game mode which maps the controls :guilabel:`wasd` + mouse look. * **Spacecraft**-- take control of a spacecraft and navigate around at will. * **Gaia FOV (1, 2, both)** -- the camera simulates either of the fields of view of Gaia, or both. For more information on the camera modes, see the :ref:`camera-modes` section. Additionally, there are a number of sliders for you to control different parameters of the camera: - **Field of view** -- control the field of view angle of the camera. The bigger it is, the larger the portion of the scene represented. - **Camera speed** -- control the longitudinal speed of the camera. - **Rotation speed** -- control the transversal speed of the camera, how fast it rotates around an object. - **Turn speed** -- control the turning speed of the camera. You can **lock the camera** to the focus when in focus mode. Doing so links the reference system of the camera to that of the object and thus it moves with it. .. hint:: **Lock the camera** so that it stays at the same relative position to the focus object. Finally, we can also **lock the orientation** of the camera to that of the focus so that the same transformation matrix is applied to both. .. hint:: **Lock the orientation** so that the camera also rotates with the focus. Additionally, we can also enable the **crosshair**, which will mark the currently focused object. .. _type-visibility: Type visibility =============== Most graphical elements can be turned off and on using these toggles. For example you can hide the stars by clicking on the ``stars`` |stars| toggle. The object types available are the following: - |stars| -- Stars - |planets| -- Planets - |moons| -- Moons - |satellites| -- Satellites - |asteroids| -- Asteroids - |clusters| -- Star clusters - |milkyway| -- Milky Way - |galaxies| -- Galaxies - |nebulae| -- Nebulae - |meshes| -- Meshes - |equatorial| -- Equatorial grid - |ecliptic| -- Ecliptic grid - |galactic| -- Galactic grid - |labels| -- Labels - |titles| -- Titles - |orbits| -- Orbits - |locations| -- Locations - |countries| -- Countries - |constellations| -- Constellations - |boundaries| -- Constellation boundaries - |ruler| -- Rulers - |effects| -- Particle effects - |atmospheres| -- Atmospheres - |clouds| -- Clouds - |axes| -- Axes - |arrows| -- Velocity vectors - |others| -- Others .. |stars| image:: img/ui/ct/icon-elem-stars.png .. |planets| image:: img/ui/ct/icon-elem-planets.png .. |moons| image:: img/ui/ct/icon-elem-moons.png .. |satellites| image:: img/ui/ct/icon-elem-satellites.png .. |asteroids| image:: img/ui/ct/icon-elem-asteroids.png .. |clusters| image:: img/ui/ct/icon-elem-clusters.png .. |milkyway| image:: img/ui/ct/icon-elem-milkyway.png .. |galaxies| image:: img/ui/ct/icon-elem-galaxies.png .. |nebulae| image:: img/ui/ct/icon-elem-nebulae.png .. |meshes| image:: img/ui/ct/icon-elem-meshes.png .. |equatorial| image:: img/ui/ct/icon-elem-equatorial.png .. |ecliptic| image:: img/ui/ct/icon-elem-ecliptic.png .. |galactic| image:: img/ui/ct/icon-elem-galactic.png .. |labels| image:: img/ui/ct/icon-elem-labels.png .. |titles| image:: img/ui/ct/icon-elem-titles.png .. |orbits| image:: img/ui/ct/icon-elem-orbits.png .. |locations| image:: img/ui/ct/icon-elem-locations.png .. |countries| image:: img/ui/ct/icon-elem-countries.png .. |constellations| image:: img/ui/ct/icon-elem-constellations.png .. |boundaries| image:: img/ui/ct/icon-elem-boundaries.png .. |ruler| image:: img/ui/ct/icon-elem-ruler.png .. |effects| image:: img/ui/ct/icon-elem-effects.png .. |atmospheres| image:: img/ui/ct/icon-elem-atmospheres.png .. |clouds| image:: img/ui/ct/icon-elem-clouds.png .. |axes| image:: img/ui/ct/icon-elem-axes.png .. |arrows| image:: img/ui/ct/icon-elem-arrows.png .. |others| image:: img/ui/ct/icon-elem-others.png .. _individual-visibility: Per-object visibility --------------------- This button provides access to controls to manipulate the individual visibility of objects. .. figure:: img/screenshots/per-object-vis.jpg :alt: Individual object visibility :align: center Individual object visibility button and dialog .. raw:: html
Since 3.1.0
As shown in the image above, when clicking the :guilabel:`Per-object visibility` button, a new dialog appears, from which individual objects can be toggled on and off. They are organized per object type (top of the dialog). Once the object type is selected, the list of object appears in the bottom part. .. hint:: **Stars do not appear** in the per-object visibility panel! Since there are so many stars, they are not in the per-object visibility panel as single objects. Instead, they show up in groups. A single standalone catalog is a single star group. In the case of LOD catalogs like the ones based on Gaia data releases, each octree node contains a star group. However, individual star visibility can still be manipulated using the eye icon in the focus information pane when the star is focused. .. _velocityvectors: Velocity vectors ---------------- Enabling **velocity vectors** activates the representation of star velocities, if the currently loaded catalog provides them. Once velocity vectors are activated, a few extra controls become available to tweak their length and color. .. figure:: img/screenshots/velocity-vectors.jpg :alt: Velocity vectors in Gaia Sky :align: center Velocity vectors in Gaia Sky * **Number factor** -- control how many velocity vectors are rendered. The stars are sorted by magnitude (ascending) so the brightest stars will get velocity vectors first. * **Length factor** -- length factor to scale the velocity vectors. * **Color mode** -- choose the color scheme for the velocity vectors: * **Direction** -- color-code the vectors by their direction. The vectors :math:`\vec{v}` are pre-processed (:math:`\vec{v}'=\frac{|\vec{v}|+1}{2}`) and then the :math:`xyz` components are mapped to the colors :math:`rgb`. * **Speed** -- the speed is normalized in from :math:`[0,100] Km/h` to :math:`[0,1]` and then mapped to colors using a long rainbow colormap (see `here `__). * **Has radial velocity** -- stars in blue have radial velocity, stars in red have no radial velocity. * **Redshift from the Sun** -- map the redshift (radial velocity) from the sun using a red-to-blue colormap. * **Redshift from the camera** -- map the redshift (radial velocity) from the current camera position using a red-to-blue colormap. * **Solid color** -- use a solid color for all arrows. * **Show arrowheads** -- Whether to show the vectors with arrow caps or not. .. hint:: Control the width of the velocity vectors with the **line width** slider in the **visual settings** pane. .. _interface-lighting: .. _visual-settings: Visual settings =============== The **visual settings** pane contains a few options to control the shading of stars and other elements: .. raw:: html
Since 3.0.0
- **Brightness power** -- exponent of power function that controls the brightness of stars. Makes bright stars brighter and faint stars fainter. - **Star brightness** -- control the brightness of stars. - **Star size (px)** -- control the size of point-like stars. - **Min. star opacity** -- set a minimum opacity for the faintest stars. - **Ambient light** -- control the amount of ambient light. This only affects the models such as the planets or satellites. - **Line width** -- control the width of all lines in Gaia Sky (orbits, velocity vectors, etc.). - **Label size** -- control the size of the labels. - **Elevation multiplier** -- scale the height representation. .. figure:: img/ui/visual-settings.jpg :align: center The visual settings pane Location log ============ Gaia Sky keeps track of the visited locations during a session, up to 200 entries. More information on the location log can be found in the :ref:`location log section `. Bookmarks ========= Gaia Sky offers a bookmark system to keep your favorite objects organized and at hand. This panel centralizes the operation of bookmarks. You can find more information on this in the :ref:`bookmarks section `. Datasets ======== This tab contains all the datasets currently loaded. For each dataset, a highlight color can be defined. The dataset properties window can be used to define arbitrary filters on any of the properties of the elements of the dataset. Datasets can be highlighted by clicking on the little crosshair next to the name, below the color picker. Please see the :ref:`datasets section ` for more information on this. Music ===== Since version ``0.800b``, Gaia Sky also offers a music player in its interface. By default it ships with only a few *spacey* melody, but you can add your own by dropping them in the folder ``$GS_DATA/music`` (see :ref:`folders `). .. hint:: Drop your ``mp3``, ``ogg`` or ``wav`` files in the folder ``$GS_DATA/music`` and these will be available during your Gaia Sky sessions to play. In order to start playing, click on the |audio-play| ``Play`` button. To pause the track, click on the |audio-pause| ``Pause`` icon. To skip to the next track, click on the |audio-fwd| ``Forward`` icon. To go to the previous track, click on the |audio-bwd| ``Backward`` icon. The volume can be controlled by scrolling up and down, using the mouse wheel, over the volume indicator. The default volume value is 5%. .. |audio-play| image:: img/ui/audio-play.png .. |audio-pause| image:: img/ui/audio-pause.png .. |audio-fwd| image:: img/ui/audio-fwd.png .. |audio-bwd| image:: img/ui/audio-bwd.png Bottom buttons ============== The buttons at the bottom of the control panel are described here. Minimap ------- With this button |minimap| you can toggle the minimap window on an off. You can also use :guilabel:`Tab`. .. |minimap| image:: img/ui/map-icon.png Load dataset ------------ Use this button |dsload| to load a new VOTable file (``.vot``) into Gaia Sky. Refer to the :ref:`stil-data-provider` section for more information on the metadata needed for Gaia Sky to parse the dataset correctly. .. |dsload| image:: img/ui/open-icon.png Preferences window ------------------ You can launch the preferences window any time during the execution of the program. To do so, click on the |prefsicon| ``Preferences`` button at the bottom of the GUI window. For a detailed description of the configuration options refer to the :ref:`Configuration Instructions `. .. |prefsicon| image:: img/ui/prefs-icon.png .. _running-scripts: Log --- The log button |logicon| brings up the log window, which displays the Gaia Sky log for the current session. The log can be exported to a file by clicking on the ``Export to file`` button. The location of the exported log files is ``$GS_DATA`` (see :ref:`folders `). .. |logicon| image:: img/ui/log-icon.png About/help ---------- The help button |helpicon| brings up the help dialog, where information on the current system, OpenGL settings, Java memory, updates and contact can be found. .. |helpicon| image:: img/ui/help-icon.png Exit ---- Click on the cross icon |quiticon| to exit Gaia Sky. You can also use :guilabel:`Esc`. .. |quiticon| image:: img/ui/quit-icon.png