Installation
System requirements
Download
Installation
Linux
Windows
macOS
Compressed (TGZ) package
System Directories
Dataset location
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
Graphics configuration
Resolution and mode
Graphics settings
Graphics quality
Antialiasing
Point cloud style
Line style
Bloom effect
Unsharp mask factor
Lens flare
Star glow
Fade time
Elevation representation
Shadows
Image levels
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
Music
Bottom buttons
Minimap
Load dataset
Preferences window
Log
About/help
Exit
Search objects
Focus panel
Focus object
Mouse pointer location
Camera information
Object visiblity
Catalogs
Preparing catalogs
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
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
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
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
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
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
Top-level objects
Model objects
Coordinates
Rotation
Model
Clouds
Atmospheric scattering parameters
Mesh objects
Orbits
Grids and other special objects
Creating your own catalog loaders
Loading data using scripts
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
Gaia Sky VR
Running Gaia Sky VR
Pre-requisites
Windows
Linux
Getting the data
Controls
Caveats
Common problems
More info
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
Gaia Sky tutorial (DPAC 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
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?
Javadocs
Changelog
About
Contact
Author
Acknowledgements
Gaia Sky
»
Changelog
View page source
Previous
Next
Changelog
Comprehensive version history
Detailed changelog
Full commit history
Other Versions
v: 3.3.1
Tags
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.5
3.5.6
3.5.7
3.5.8
3.5.9
3.6.0
3.6.1
3.6.2
3.6.3
3.6.4
3.6.5
3.6.6
3.6.7
Branches
master