The Deck Access tool allows you to compute access to a set of objects, not currently defined within the STK scenario, from a single object within the scenario. Deck access operations are useful when you have a large number of objects that no longer need to be in the STK scenario but for which you would like visibility information. Using deck access can greatly reduce load and save time for such scenarios and minimize graphical clutter.
The definitions of the objects outside of the scenario are supplied via external target deck file or from a star collection. The format of the file is defined by the class of object and the file extension. For example, you could use the deck access tool to compute access to a set of satellites, defined by two line element sets contained in a file, from a facility in the STK scenario. Star collections are defined by specifying a set of constraints on the contents of a star catalog. If an appropriate star collection is not available, click Create to create a new collection with the desired set of constraints and star catalog.
To open the Deck Access tool, select Deck Access... from the Analysis menu.
Use the Input options to define the access computation task.
| Option | Description |
|---|---|
| Start Time and Stop Time | Indicate the time period over which the access opportunities will be computed. |
| Type | Indicate the type of object which is defined by the data in the specified file. |
| File | Displayed when an STK object class is selected as the type.
Specify the file containing the target deck file, or use the
button to browse for a
file.The appropriate file extension will be the default file type
in the file selection window. |
| Name | Displayed when a star collection is selected as the type. Specify the star collection to be used as the source of star object information. Use the Create… button to create a new star collection or to view/modify the configuration of existing star collections. |
Note: All objects must be of the same type during a single deck access run.
The file extension is important to the deck access process since it is used to define the format of the data in the file. The file extensions and formats for each type are given below.
File extensions and formats
| Type | Extension | Format Description |
|---|---|---|
| Satellite | .tce/.tle | Files contain a set of two line element sets. |
| Facility/Target | .lla | Files contain lines of the following format: [Name] Latitude
Longitude [Altitude], where Latitude and Longitude are given in
degrees and Altitude is given in meters. If the Name is given, then Altitude must also be given. [Name] must have at least one non-numeric character (see warning below). If no [Name] is given, then the target deck objects are identified as Point_NUM, where NUM is an index of unnamed definitions in the file. |
| Star | .str | Files contain lines of the following format: [Name]
Right_Ascension Declination [Parallax] [RA_Proper_Motion
Dec_Proper_Motion [Epoch]], where Right_Ascension and Declination
are given in degrees, Parallax is given in arcseconds, proper
motion is given in arcseconds/year and the Epoch is specified in
Julian Ephemeris Date. If proper motion is given, then the Epoch may be given. If proper motion is given and the Epoch is omitted, the Epoch is set to J2000. [Name] must have at least one non-numeric character (see warning below). If the [Name] is omitted, then the target deck objects are identified as Star_NUM, where NUM is an index of unnamed definitions in the file. |
| Star Collection | n/a | n/a |
| Area Target | .shp | GIS shape file containing polygon information. Target deck objects are identified via the NAME field of the shape file entries if it exists. Otherwise, the target deck objects are identified as AreaTarget_NUM, where NUM is an index of unnamed definitions in the file. |
Warning: Star and Facility/Target files cannot have [Names] that are strictly numeric. STK attempts to read values that must be specified numerically in order. Since [Name] is an optional parameter, if an object [Name] is strictly numeric, STK will assume that the [Name] has been omitted and that the first number is the first required value (Right_Ascension for a star, or Latitude for facility/target).
For example, if you created a star file containing the following information:
123 1.23124 2.234124
STK would read it as:
| [Name] | No value specified |
|---|---|
| Right_Ascension | 123 |
| Declination | 1.23124 |
| [Parallax] | 2.234124 |
| [RA_Proper_Motion DEC_Proper_Motion] | No value specified |
| [Epoch] | No value specified |
In this example, the name of the star is supposed to be "123", and the file should have been read as:
| [Name] | 123 |
|---|---|
| Right_Ascension | 1.23124 |
| Declination | 2.234124 |
| [Parallax] | No value specified |
| [RA_Proper_Motion DEC_Proper_Motion] | No value specified |
| [Epoch] | No value specified |
To prevent this from happening, be sure you use names that contain at least one non-numeric character. For example, if you created a star file containing the same information, but you added an alphabetic character to the name, like so:
123b 1.23124 2.234124
STK would read it as:
| [Name] | 123b |
|---|---|
| Right_Ascension | 1.23124 |
| Declination | 2.234124 |
| [Parallax] | No value specified |
| [RA_Proper_Motion DEC_Proper_Motion] | No value specified |
| [Epoch] | No value specified |
which would be accurate.
If the Specify Constraint Source option is ON, you can select an instance of the target deck class (set using the Select Target Deck class option) from which a set of access constraints will be copied. This set of constraints are associated with the target deck objects and used in the deck access computations.
The results of the deck access, initiated by clicking Compute Accesses, may be presented in a report window or written directly to file. In any case, the format is defined by the DeckAccess report style associated with the object from which the Deck Access tool was launched.
Use the Sort and Output options here to define the presentation of deck access results.
| Option | Description |
|---|---|
| By Object | Reported access intervals will be sorted first by object and then by start time. |
| By Start Time | Reported access intervals will be sorted first by start time. |
| Option | Description |
|---|---|
| Create Report | The results of the deck access, initiated by clicking Compute Accesses, will be presented in a report window. |
| Create File | The results of the deck access, initiated by clicking Compute Accesses, will be written directly to file. It is often desirable to write the results of a deck access run directly to a file since the number of access intervals can be very large. |