|Top Previous Next|
The StarField object stores star data including the stars' GCI positions and magnitudes. Stars can be visualized in the 3D View, Celestial Sphere, Sensor View, or Star Map Viewpoint types. You can use the built-in stars, or define your own set of stars. For a summary of the coverage and contact output methods in FreeFlyer organized by observer and target object type, see the Contact Method Summary.
Using the Built-In Stars
The global Stars object exists in every Mission Plan and is pre-populated with a standard catalog of stars. These default Stars are shown automatically in the background of every view you create in FreeFlyer.
You can access information about the built-in stars using syntax such as:
You can hide the built-in stars from any ViewWindow using the syntax:
You can also change how the built-in stars are displayed; for example, you can turn on the star names, or change their colors or font settings.
When defining a custom StarField, create the StarField object in the object browser or FreeFlyer script and choose the appropriate input type:
StarField from Star Catalog File
Reading from a Catalog
To populate a StarField object from a star catalog file, you can specify the Star Catalog Filename in the object editor, or use the StarField.LoadCatalog() method in FreeFlyer script. The following star catalog file formats are supported:
To populate a StarField object from a catalog file using FreeFlyer script, use the StarField.LoadCatalog() method as shown below, or use the Get command.
Creating a Custom StarField
To create a Custom Star Field:
Custom StarField Object Editor
To configure a custom set of stars in a StarField object using FreeFlyer script, use the following syntax:
Note: If Evenly Distributed is chosen in the Star Source drop-down, the positions of the stars are computed for you.