openspace.exoplanets
Functions overview
Name |
Documentation |
---|---|
Add a specific exoplanet system to the scene, based on a star name |
|
Add multiple exoplanet systems to the scene, based on a list of names |
|
Deprecated in favor of ‘listOfExoplanets’ |
|
Lists the names of the host stars of all exoplanet systems that have sufficient data for generating a visualization, and prints the list to the console |
|
Returns a list with names of the host star of all the exoplanet systems that have sufficient data for generating a visualization, based on the module’s loaded data file |
|
Load a set of exoplanets based on custom data, in the form of a CSV file, and add them to the rendering |
|
Load a set of exoplanet information based on custom data in the form of a CSV file |
|
Remove a loaded exoplanet system |
|
Return an object containing the information needed to add a specific exoplanet system |
Functions
addExoplanetSystem
Add a specific exoplanet system to the scene, based on a star name.
Note that the formatting of the name must match the one in the dataset. That is, it must match the name as given in the NASA Exoplanet Archive.
starName
String
The name of the star
Return type: void
openspace.exoplanets.addExoplanetSystem(starName)
addExoplanetSystems
Add multiple exoplanet systems to the scene, based on a list of names.
Note that the formatting of the name must match the one in the dataset. That is, they must match the names as given in the NASA Exoplanet Archive.
listOfStarNames
String[]
A list of star names for which to create the exoplanet systems
Return type: void
openspace.exoplanets.addExoplanetSystems(listOfStarNames)
getListOfExoplanets
Deprecated in favor of ‘listOfExoplanets’
Return type: String[]
openspace.exoplanets.getListOfExoplanets()
listAvailableExoplanetSystems
Lists the names of the host stars of all exoplanet systems that have sufficient data for generating a visualization, and prints the list to the console.
Return type: void
openspace.exoplanets.listAvailableExoplanetSystems()
listOfExoplanets
Returns a list with names of the host star of all the exoplanet systems that have sufficient data for generating a visualization, based on the module’s loaded data file.
Return type: String[]
openspace.exoplanets.listOfExoplanets()
loadExoplanetsFromCsv
Load a set of exoplanets based on custom data, in the form of a CSV file, and add them to the rendering. Can be used to load custom datasets, or more recent planets than what are included in the internal data file that is released with OpenSpace.
The format and column names in the CSV should be the same as the ones provided by the NASA Exoplanet Archive.
We recommend downloading the file from the Exoplanet Archive’s Composite data table, where multiple sources are combined into one row per planet.
Please remember to include all columns in the file download, as missing data columns may lead to an incomplete visualization.
Also, avoid loading too large files of planets, as each added system will affect the rendering performance.
csvFile
String
A path to a .csv file that contains the data for the exoplanets
Return type: void
openspace.exoplanets.loadExoplanetsFromCsv(csvFile)
loadSystemDataFromCsv
Load a set of exoplanet information based on custom data in the form of a CSV file.
The format and column names in the CSV should be the same as the ones provided by the NASA Exoplanet Archive.
When dowloading the data from the archive we recommend including all columns, since a few required ones are not selected by default.
csvFile
String
A path to the CSV file to load the data from.
Return type: Table[]
A list of objects of the type ExoplanetSystemData, that can be used to create the scene graph nodes for the exoplanet systems
openspace.exoplanets.loadSystemDataFromCsv(csvFile)
removeExoplanetSystem
Remove a loaded exoplanet system.
starName
String
The name of the host star for the system to remove.
Return type: void
openspace.exoplanets.removeExoplanetSystem(starName)
systemData
Return an object containing the information needed to add a specific exoplanet system. The data is retrieved from the module’s prepared datafile for exoplanets. This file is in a binary format, for fast retrieval during runtime.
starName
String
The name of the star to get the information for.
Return type: Table
An object of the type ExoplanetSystemData that can be used to create the scene graph nodes for the exoplanet system
openspace.exoplanets.systemData(starName)