Installation
System requirements
Download
Installation
Linux
Windows
macOS
Compressed (TGZ) package
System Directories
Datasets location
Logs and crash reports
Run Gaia Sky
Run regular installation
Linux
Windows
macOS
Flatpak
Appimage
TAR.GZ package
Run from source
Requirements
Getting the catalog data
Compiling and running
CLI arguments
Packaging the software
User manual
Settings and configuration
Graphics settings
Interface settings
Performance
Controls
Screenshots
Frame output
Camrecorder
Panorama mode
Planetarium mode
Data
Gaia
System
The configuration file
Program settings
Controls settings
Graphics settings
Data settings
Scene settings
Post-processing settings
Proxy settings
Graphics configuration
Resolution and mode
Graphics settings
Graphics quality
Antialiasing
Point cloud style
Line style
Bloom effect
Unsharp mask factor
Lens flare
Star glow over objects
Fade time
Elevation representation
Shadows
Image levels
Virtual textures
Cache size
Experimental
Proxy configuration
Use system proxy
Direct configuration
HTTP
HTTPS
SOCKS
FTP
Dataset manager
Welcome screen
Dataset manager
Data location
Available datasets
Installed datasets
Controls
Keyboard controls
Keyboard mappings
Default camera controls
Default spacecraft controls
Mouse controls
Focus mode
Free mode
Game mode
Gamepad controls
Default camera mappings
Spacecraft camera mappings
Gamepad UI
GUI navigation
Camera modes
Focus mode
Object tracking
Free mode
Game mode
Spacecraft mode
Field of View mode
Camera behaviors
Cinematic behavior
Non-cinematic behavior
Control panel
Time
Camera
Type visibility
Per-object visibility
Velocity vectors
Visual settings
Location log
Bookmarks
Datasets
Bottom buttons
Minimap
Load dataset
Preferences window
Log
About/help
Exit
Search objects
Focus panel
Focus object
Mouse pointer location
Camera information
Object visiblity
Datasets
Preparing datasets
Object IDs
Object names
Positions
Proper motions and radial velocities
Magnitudes
Colors
Variability
Other columns
Loading catalogs
Star catalogs
Particle datasets
Star cluster catalogs
Variable star catalogs
Managing datasets
Dataset highlight color
Dataset preferences
Stereoscopic (3D) mode
Stereoscopic profiles
Planetarium mode
Single-projector setup
Spherical mirror projection
Multi-projector setup
MPCDI
Gaia Sky configuration file
Re-projection shaders
Panorama mode
Configuration
Creating panorama images
Injecting panorama metadata to 360 images
Creating spherical (360) videos
Orthosphere view mode
Bookmarks
Creating bookmarks
Bounding shapes
Adding bounding shapes
Removing shape objects
Location log
Debug panel
External views
Connecting Gaia Sky instances
Configuration
Configuration: replica instance(s)
Configuration: primary instance
Caveats
Camera paths
Camera path file format
Recording camera paths
Real time recording
Keyframe editor
Keyframe and camera files
Creating and editing keyframes
Playback controls
Export keyframes to camera paths
Keyframes preferences
Playing camera paths
Scripting
Quick start
Requirements
Running a test script
The scripting API
Using the API remotely
API documentation
Writing scripts for Gaia Sky
Logging to Gaia Sky and Python
Method and attribute access
Strict parameter types
Loading datasets from scripts
Synchronizing with the main loop
Camera and scene runnables
Overriding object coordinates provider
More examples
Running and debugging scripts
REST API server
Using the REST API server
Debug
Capturing videos
Frame output system +
ffmpeg
OpenGL/Screen recorders
Linux
Windows
Taking screenshots
Screenshot modes
SAMP integration
Implemented features
Unimplemented features
Procedural planetary surfaces
Surface generation process
Seamless (tilable) noise
Noise parametrization
Cloud generation process
Descriptor files
Randomize all
Surface description
Color look-up table
Noise parameters
Cloud description
Atmospheric parameters description
Procedural generation at runtime
System logs
Session log
Crash reports
Debug mode
Advanced topics
Performance
Maximum heap memory
Heap memory on Linux
Heap memory on Windows
Heap memory on macOS
Heap memory when running from source
Graphics performance
CPU performance
Multithreading
Limiting FPS
Draw distance (levels of detail)
Smooth transitions
Graphics performance
Graphics quality setting
Dynamic resolution
Star brightness
Star groups
Billboards
Labels
Velocity vectors
Model detail
Bloom, lens flare and light glow
Antialiasing
Internal reference system
Description
Internal units
Data format
Where are the data files defined?
$data/[dataset-name]/dataset.json example
default-data/dataset.json example file
Data loaders
Catalog formats
Star catalogs
Regular star catalogs
Level-of-detail star catalogs
JSON data format
Data morphology
Objects vs Updates
Basic attributes
Proper motions
Magnitudes
Labels
Coordinates and ephemerides
Orbit coordinates
Static coordinates
VSOP87
VSOP2000
Chebyshev polynomials
Heliotropic orbits
Moon AA coordinates
Pluto coordinates
Python scripting coordinates
Model objects
Rotation
Model
Clouds
Atmospheric scattering parameters
Mesh objects
Orbits
Grids and other special objects
Affine transformations
Reference system transformations
Creating your own catalog loaders
Loading data using scripts
Archetypes
Components
Base
Body
GraphNode
Coordinates
Rotation
Celestial
Magnitude
ProperMotion
SolidAngle
Shape
Trajectory
ModelScaffolding
Model
Atmosphere
Cloud
RenderFlags
MotorEngine
RefSysTransform
AffineTransformations
Fade
DatasetDescription
Label
RenderType
BillboardSet
Title
Axis
LocationMark
Constel
Boundaries
ParticleSet
StarSet
Attitude
ParticleExtra
Mesh
Focus
Raymarching
Star rendering
Pseudo-size determination
Star shader and rendering
Level-of-detail catalogs
Data format
Metadata file
Version 0
Version 1
Particle files
Version 0
Version 1
Version 2
Catalog processing
Distances
Magnitude/color corrections
Defining an extrasolar system
Initial set up
Defining the objects
Stars
Planets
Cubemaps
Virtual Textures
Overview
Creating Virtual Texture Datasets
Preparing the tiles
Tools
Limitations
Mesh warping
Gaia Sky VR
System requirements
Set-up
Windows
Linux
Downloading datasets
Controls
Caveats
Common problems
Tutorials and workshops
Video tutorials
Written tutorials/workshops
Video production tutorial (2020)
Before starting…
The User Interface of Gaia Sky
Loading datasets
Camrecorder: recording and playing back camera files
Keyframe system
Frame output system
Scripting
General tutorial (2021)
Before starting…
Basic controls
Movement
Selection
The User Interface
Control panel
Quick info bar
Debug panel
Time controls
Camera modes
Special render modes
Toggle visibility of components
Velocity vectors
Visual settings
Loading external datasets
Working with datasets
External information
Camera paths
Keyframe system
Frame output system
Scripting
Conclusion
Video & scripting workshop (2023)
Before starting…
Introduction
Dataset manager
Basic controls
Movement
Selection
The User Interface
Control panel
Quick info bar
Debug panel
Time controls
Camera modes
Special render modes
Component visibility
Velocity vectors
Visual settings
External datasets
Working with datasets
External information
Scripting
Camera paths
Keyframe system
Frame output system
Videos with ffmpeg
Frequently Asked Questions
Q: What is the base-data package?
Q: Why do you have two different download pages?
Q: Why so many Gaia-DR catalogs?
Q: Gaia Sky crashes at start-up, what to do?
Q: I’m running out of memory, what to do?
Q: I can’t see the elevation data on Earth or other planets!
Q: What is the internal reference system used in Gaia Sky?
Q: Can I contribute?
Q: I like Gaia Sky so much, can I donate to contribute to the project?
API reference
Changelog
About
Contact
Author
Acknowledgements
Gaia Sky
»
Index
Index
Other Versions
v: 3.5.4-1
Tags
1.0.1
1.0.2
1.0.3
1.0.4
1.5.0
2.0.0
2.0.1
2.0.2
2.0.3
2.1.0
2.1.1
2.1.2
2.1.5
2.1.7
2.2.0
2.2.1
2.2.2
2.2.3
2.2.4
2.2.4-1
2.2.5
2.2.6
2.3.0
2.3.1
3.0.0
3.0.1
3.0.2
3.0.3
3.1.0
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.1.6
3.2.0
3.2.1
3.3.0
3.3.1
3.3.2
3.4.0
3.4.1
3.4.2
3.5.0
3.5.1
3.5.2
3.5.3
3.5.4
3.5.4-1
3.5.5
3.5.6
3.5.7
3.5.8
Branches
master