Return data in a specified report style.
Report_RM <ObjectPath> ({Option} <Value>)...
The Report_RM command returns a report, based on the style specified, over the Connect socket
The Report_RM command will return one blank line (zero length) at the end of the report.
Certain options can be set for output created using the Report_RM command. For example, the delimiter between data items and whether or not headers are returned. To set these options use the ExportConfig command.
{Option} <Value> | Description |
---|---|
Style "<ReportStyleName>" | Enter the name of the report style to
create, the style must match an existing report style within STK.
Available styles display in the STK Report & Graph Manager
window.
For details on how to specify "<ReportStyleName>" see Report Style Names Note: The Style option is required. |
TimePeriod {{TimeInterval} | UseAccessTimes | Intervals {"<FilePath>" | "<IntervalListSpec>"}} | Enter {TimeInterval} to define the
start time and stop time for the report span. For valid
{TimeInterval} values see Time Options.
Or specify UseAccessTimes to only report data during access times between the <ObjectPath> and an AccessObject, but you must also specify at least one AccessObject. Or use the Intervals option to specify an STK interval file for the time period or an Interval List component specification. For help on creating the STK interval file, see Create & Import External Files - Interval List in STK Help. For information about "<IntervalListSpec>" see Component Specification. |
TimeStep {<Value> | Bound <Value> | "<TimeArraySpec>"} | Enter the time step <Value> to be
used in creating the report. This value is entered in seconds and
must be between 0.000001 and 1000000000.0 seconds.
Or enter Bound <Value> to have the report steps calculated on a specific time boundary. This value is entered in seconds and must be between 0 and 3600 seconds. If 0 is entered then the default time step (usually 60 seconds) is used. Or enter a Time Array component specification to use the array times as time steps. For information about "<TimeArraySpec>" see Component Specification. |
AccessObject <AccessObjectPath> | If reporting access, specify the object to which access will be calculated. Access will be calculated from the object for which the command is being issued (specified using the <ObjectPath> parameter). This option can be entered multiple times, to specify multiple access objects. |
AdditionalData "<Data>" | Some Report Styles require additional data, such as a comparison object for the RIC report for a Satellite. For these types of reports you must include this option. More information on styles that require AdditionalData can be found at "Report Additional Data". |
Summary {Include | Only} | Use this option to have summary data, if specified in the report style, included with the report data. Enter the Include value to have the summary data included with the rest of the report; use the Only value to have only the summary data reported. By default, summary data is not included in the report data. |
AllLines {On | Off} | Entering On for this option will return a report that includes all headers, spaces, tabs, and blank lines based on the report Style specified in the command. |
To return a Lighting Times report for the Shuttle satellite that only addresses four hours:
Report_RM */Satellite/Shuttle Style "Lighting Times" TimePeriod "1 Nov 2000 00:00:00.00" "1 Nov 2000 04:00:00.00" TimeStep 30
To return a Cartesian Position report for the Perth facility:
Report_RM */Facility/Perth Style "Cartesian Position"
To return a Receiver report of Antenna Gain:
Report_RM */Satellite/mySat/Receiver/rcvr1 Style "Antenna Gain" AdditionalData "GainCutType Azimuth MinElevation 0.0 MaxElevation 10.0 ElevationStep 1.0 AzimuthValue 10.0"
To generate an AER position report only when the satellite has access to Facility/Facility1:
Report_RM */Satellite/Satellite1 Style "AER" AccessObject Facility/Facility1 TimePeriod UseAccessTimes
To return the full AER access report, including all lines and spaces, etc:
Report_RM */Satellite/Satellite1 Style "AER" AccessObject Facility/Facility1 TimePeriod UseAccessTimes AllLines On
GETREPORT 2
3
GETREPORT 26
"x (km)","y (km)","z (km)"
GETREPORT 36
1116.630008, -4842.889882, 3984.11923
GETREPORT 0
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1