Description | Example | Return Message | Group

SetUnits

Set date, distance and time units for data transfer during the Connect session (Deprecated Command)

Syntax

SetUnits <ApplicationPath> {Unit1} [{Unit2}] [{Unit3}]

ATTENTION: THIS COMMAND IS DEPRECATED and has been replaced by:

Units_Set, Units_SetConnect

Description

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

Example

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

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Scenarios

Deprecated Commands

Version

10.1

STK Programming Interface 11.0.1