Units_Set
Set units of measure.
Syntax
Units_Set <ScenarioPath> {Option} <Parameters>
Related commands
Description
Set units of measure for the user interface, connect, and reports.
| {Options} | <Parameters> | Description |
|---|---|---|
| GUI | {Internal | {Dimension} {Unit}... } | Set units of measure for entering data via the graphical user interface. |
| Report | {Internal | {Dimension} {Unit}... } | Set the units used when generating and displaying reports from the graphical user interface. |
| Connect | {Internal |{Dimension} {Unit}... } | Set the units used when entering Connect commands. The only valid dimensions for Connect units are: Distance, Date, Time, Latitude, and Longitude. For other dimensions the GUI units will be used, but check the command descriptions for exceptions!
Angle values should be entered in degrees. |
| ConnectReport | {Internal | {Dimension} {Unit}... } | Set units used when generating and displaying reports during the current Connect session. The units set by this command will only be used if the ConnectReportUnitsFlag has been set to On. When the flag has been set to true, any report/graph generated via connect will use the connect report units, overriding any units set for the report style. |
| All | {Internal |{Dimension} {Unit}... } | Set the specified units for Connect, GUI, Report and ConnectReport. |
| ConnectReportUnitsFlag | {On | Off} | Enter On to use the units set by the ConnectReport command when generating and displaying reports during the current Connect session. |
When {Option} is GUI, Report, Connect, ConnectReport, or All:
Enter Internal to set all units to the STK internal units.
Enter one or more {Dimension} {Unit} pair to set specific units values.
For valid {Dimension} names see the Scenario - Units UI or use the Units_Get command.
For {Unit} enter the registered unit name or abbreviation. For valid unit names use the Units_Get command with the UnitNames option. For units existing prior to STK 10.1 the command will also check for plurals and non-plural values.
Any {Unit} that contains spaces must be enclosed in double quotes.
Use the Units_Get command to get the available dimensions and current unit settings for those dimensions.
Use the Units_Get command with the Internal option to get what the internal units are.
Use the Units_Get command with the UnitNames option to get valid unit names for a specified dimension.
Date units with Additional Values
The Date units JulDateOffset and MissionElapsed will accept an additional value entered on the command line, including this value is optional:
JulDateOffset <Offset>MissionElapsed "<UTCG Date>"<Offset> is entered in seconds. "<UTCG Date>" is a UTC Gregorian date.
Examples
To set the connect Distance unit to statute miles:
To set the UI Date unit to epoch seconds, the angle unit to radians and mass unit to pounds:
To set the Report units to the Internal values:
To set the Date units to MissionElapsed, with the lift-off time specified:
Return message
Group membership
This command belongs to the following group(s):
Version
11.7