Enable you to specify the beam direction(s) and null direction(s) in ASCII text files.
Beam Direction Provider File Format
Keywords used in Beam Direction Provider files follow:
| Keyword | Description |
|---|---|
| BeamAsciiDataDirectionProvider v2 | Indicates the data format and version of the data format. This is a required keyword and must be the first line in the file. |
| <AntennaCoordinateSystem> | Text string that specifies how the Az/El angles are measured. Valid strings are "SphericalAzEl", "Polar", and “Rectangular”. For more information, see Antenna Coordinate Systems. |
| <Sampling Mode> | Text string that specifies how STK determines direction values for time steps between what is specified in the file. SampleAndHold is the only option available. SampleAndHold causes STK to continue to use the direction(s) specified by the file's time that is less than the current analysis time. STK switches to a new direction when the analysis time becomes greater than the next time entry within the file. When there are no future entries, the antenna continues to hold the last specified direction. |
| <Direction Information> |
Time-specified pointing direction information. The Direction Information consists of many rows of space-separated data sets, one row for each time step. Azimuth and elevation are in degrees. Each row has the following format:
|
Beam Direction Provider File Sample Format
Following is an example of a beam direction provider file:
# File format is as follows: # If first character of a line is '#' the entire line is treated as a comment. # First non-comment line is a tag indicating the type of file followed by the file format version. # Second non-comment line is the antenna coordinate system. Valid keywords are "SphericalAzEl", "Polar", or “Rectangular”. See STK help on Antenna Coordinate Systems. # Third non-comment line is the sampling mode. Only 'SampleAndHold' is supported. # Remaining non-comment lines are time specified pointing directions with the following format: # <time> <number of directions> <direction 1 Az> <direction l El> ... <direction n Az> <direction n El> # where time is in epoch seconds, and Az/El are in degrees and in Antenna's body reference frame. # # This example has two beam directions and holds one at 0.0 deg azimuth, -26.0 deg elevation and the other beam at 0.0 deg # azimuth, 20.0 deg elevation for all time. Add more rows in between for explicit dynamic beam steering directions. # BeamAsciiDataDirectionProvider v2 SphericalAzEl SampleAndHold -1e300 2 0.0 -26.0 0.0 20.0 1e300 2 0.0 -26.0 0.0 20.0
Null Direction Provider File Format
Keywords used in Null Direction Provider files follow:
| Keyword | Description |
|---|---|
| NullAsciiDataDirectionProvider v2 | Indicates the data format and version of the data format. This is a required keyword and must be the first line in the file. |
| <AntennaCoordinateSystem> | Text string that specifies how the Az/El angles are measured. Valid strings are "SphericalAzEl", "Polar",and “Rectangular”. For more information, see Antenna Coordinate Systems. |
| <Sampling Mode> |
Text string that specifies how STK determines direction values for time steps between what is specified in the file. SampleAndHold is the only option available. SampleAndHold causes STK to continue to use the direction(s) specified by the file's time that is less than the current analysis time. STK switches to a new direction when the analysis time becomes greater than the next time entry within the file. When there are no future entries, the antenna continues to hold the last specified direction. |
| <Metric Scale> | Text string that specifies the scale of the <MetricValue> field. Options are Logarithmic or Linear. |
| <Direction Information> |
Time-specified pointing direction information. The Direction Information consists of many rows of space-separated data sets, one row for each time step. Azimuth and elevation are in degrees. Each row has the following format:
|
Null Direction Provider File Sample Format
Following is an example of a null direction provider file:
# File format is as follows: # If first character of a line is '#' the entire line is treated as a comment. # First non-comment line is a tag indicating the type of file followed by the file format version. # Second non-comment line is the antenna coordinate system. Valid keywords are "SphericalAzEl", "Polar", or “Rectangular”. See STK help on Antenna Coordinate Systems. # Third non-comment line indicates the scale of the metric values. Can be "Logarithmic" or "Linear". # Fourth non-comment line is the sampling mode. Only 'SampleAndHold' is supported. # Remaining non-comment lines are time specified pointing directions with the following format: # <time> <number of directions> <direction 1 Az> <direction l El> <direction 1 metric> ... # <direction n Az> <direction n El> <direction n metric> # where time is in epoch seconds, and Az/El are in degrees and in Antenna's body reference frame. # # This example has two null directions and holds one at 0.0 deg azimuth, -46.0 deg elevation with a weight of 10 dB and the # other null at 0.0 deg azimuth, 66.0 deg elevation with a weight of 10 dB for all time. Add more rows in between for # explicit dynamic null steering directions. # NullAsciiDataDirectionProvider v2 SphericalAzEl SampleAndHold Logarithmic -1e300 2 0.0 -46.0 10.0 0.0 66.0 10.0 1e300 2 0.0 -46.0 10.0 0.0 66.0 10.0