Set units of measure.
Units_Set <ScenarioPath> {Option} <Parameters>
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!
Note: 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. |
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.
The Date units JulDateOffset and MissionElapsed will accept an additional value entered on the command line, including this value is optional:
JulDateOffset <Offset><Offset> is entered in seconds. "<UTCG Date>" is a UTC Gregorian date.
To set the connect Distance unit to statute miles:
Units_Set * Connect Distance "Statute Miles"
To set the UI Date unit to epoch seconds, the angle unit to radians and mass unit to pounds:
Units_Set * GUI Date EpSec Angle Radian Mass lb
To set the Report units to the Internal values:
Units_Set * Report Internal
To set the Date units to MissionElapsed, with the lift-off time specified:
Units_Set * GUI Date MissionElapsed "17 Jan 2015 12:35:54.000"
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
11
STK Programming Interface 11.0.1