Set date, distance and time units for data transfer during the Connect session (Deprecated Command)
SetUnits <ApplicationPath> {Unit1} [{Unit2}] [{Unit3}]
Note: This command was deprecated in STK 10.1, it should no longer be used. This command has been replaced by the Units_Set and Units_SetConnect command.
Each Connect session maintains units settings for data transferred. These unit settings are independent of the unit settings defined for STK. The SetUnits command allows you to set units of measure for data transferred during the current Connect session.
Connect recognizes a number of <Unit> abbreviations. Use the abbreviated or alternative forms described in the table below to set units. You can also change the units used to input data via the user interface using the SetGUIUnits command or the units used to report information using the SetReportUnits command.
For Distance, Time, and Date the {Unit} is unique enough so that you don't have to specify the Dimension. The Dimension should only be included when setting the Latitude and Longitude units separately.
Hint: Units set through Connect using the Connect units format are independent of the units set through the user interface. For example, if you use Connect to set the Time Units to Hours and entered a value of 1.5, yet the user interface has Time Units set to Minutes, the user interface displays a value of 90 minutes (equivalent to 1.5 hours).
Warning: Some Date units use an offset value (JulianOffset and MissionElapsed). This Offset can not be set using the SetUnits command. If one of these date types is being used it will use the Offset that was set using the SetGUIUnits command, or set via the UI.
When setting the Date unit to Local, the time zone date and time displayed will be in whichever Date format was previously set. For instance, if you had previously set the Date to display in Gregorian format and change the Date unit to Local, then the local Gregorian date/time format is used.
Note: Unit Values are NOT case-sensitive.
| {Dimension} | {Unit} |
|---|---|
| Distance |
FEET | FT METER NAUTICALMILE | NM KILOMETER | KM STATUTEMILE | SM | MI ASTRONOMICALUNIT | ASTRONOMICAL | AU EARTHRADII | RE KILOFEET | KFT FURLONG |
| Time |
SECOND | SEC MINUTE | MIN HOUR | HR DAY CENTIDAY | CD FORTNIGHT EARTHCANONICAL | EARTHTU SUNCANONICAL | SUNTU |
| Date |
Gregorian | GREG GregorianLOCAL | GregorianLCL | GregLCL GregorianUTC | GregUTC | UTCG GregorianTAI | GregTAI | TAIG GregorianTDT | GregTDT | TDTG GregorianTDB | GregTDB | TDBG GregorianGPSTIME | GregGPSTIME | GregGPS |GPSG GPSTIME | GPS Julian | JUL JulianLOCAL | JulianLCL | JulLCL | LCLJ JulianUTC | JulUTC | UTCJ Julian4UTC | Julian4 | Jul4 | UTCJFOUR JulianDATE | JulDate | JDate JulianOffset | JDateOffset | JDateOff ModifiedJulianDATE | ModJulDate | ModJDate JulianEphemerisDate | JulEphemDate | JED JulianTAI | JULTAI | TAIJ GMTSYSTEM | GMT | ZULU LOCAL | LOC EPOCHSECOND | EPOCHSEC | EPSEC EPOCHMINUTE | EPOCHMIN | EPMIN EPOCHHOUR | EPOCHHR | EPHR EPOCHDAY | EPDAY EPOCHYEAR | EPOCHYR DD/MM/YYYY YYDDD YYDDD.DDD YYYYDDD YYYYDDD.HHMMSS YYYYMMDD YYYYMMDD.DDD YYYY/MM/DDTIME YYYY/MM/DD YYYY:MM:DD YYYY:MM:DD:HH:MM:SS.sss ISO-YD ISO-YMD MissionElapsed | MISELAP Note: For more information on date formats, see the Scenario Units of Measure section in STK Help. |
| Lat/Lon |
Enter one of these values to set both latitude and longitude units. Degree | Deg Radian | Rad HrMinSec | HMS DegMinSec | DMS DegMinSecDir | DMSDir |
| Latitude |
Enter the keyword Latitude with the {LatUnit} value to set only latitude units (see example 2 below). Valid {LatUnit} values are: Degree | Deg Radian | Rad HrMinSec | HMS DegMinSec | DMS DegMinSecDir | DMSDir |
| Longitude |
Enter the keyword Longitude with the {LonUnit} value to set only longitude units (see example 2 below). Valid {LonUnit} values are: Degree | Deg Radian | Rad HrMinSec | HMS DegMinSec | DMS DegMinSecDir | DMSDir DegEast | Deg0-360 DegEastWest | Deg180 |
To set the date units used during this Connect session to be Gregorian, the distance unit to be kilometers, and the time units to be hours:
SetUnits / km hour GregUTC
To set the latitude units to be degrees and the longitude units to be Deg 0-360:
SetUnits / Latitude Degree Longitude DEG0-360
To set the distance unit to be kilometers, and the latitude and longitude units to be Deg:Min:Sec
SetUnits / km DMS
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1