Units Of Measurement
Overview
When querying for variables, certain systems require the developer to specify the type of units of the value to be retrieved or set. See the Systems that Support Variable Access to determine whether units are needed when querying for a variable.
Notes
In certain circumstances, the unit type can also dictate the variable's data type such as the unit type: "STRING".
The following table gives the strings that are accepted by the SDK for units. All
the strings in the same row are identical in meaning. Note that some strings have
"per" spelled out, and some use "/", and note that a few contain hyphens or underscores.
Notes
When making object definitions in SimConnect, it is possible to request
the units that the values are to be received in. All the units in the tables below
under one heading (such as Frequency or Speed) can be used as appropriate to the
client application, except those under Miscellaneous Units. See the
SimConnect documentation for more details.
| Distance |
Details |
|
meter, meters, m
|
~
|
|
centimeter, centimeters, cm
|
~
|
|
kilometer, kilometers, km
|
~
|
|
millimeter, millimeters
|
~
|
|
mile, miles
|
~
|
|
decimile, decimiles
|
One tenth of a mile
|
|
nautical mile, nautical miles, nmile, nmiles
|
Nautical mile, 2024 yards
|
|
decinmile, decinmiles
|
One tenth of a nautical mile
|
|
foot, feet, ft
|
~
|
|
inch, inches, in
|
~
|
|
yard, yards
|
~
|
Area |
Details |
|
square inch, square inches, sq in, in2
|
~
|
|
square feet, square foot, sq ft, ft2
|
~
|
|
square yard, square yards, sq yd, yd2
|
~
|
|
square meter, square meters, sq m, m2
|
~
|
|
square centimeter, square centimeters, sq cm, cm2
|
~
|
|
square kilometer, square kilometers, sq km, km2
|
~
|
|
square millimeter, square millimeters, sq mm, mm2
|
~
|
|
square mile, square miles
|
~
|
Volume |
Details |
|
cubic inch, cubic inches, cu in, in3
|
~
|
|
cubic foot, cubic feet, cu ft, ft3
|
~
|
|
cubic yard, cubic yards, cu yd, yd3
|
~
|
|
cubic mile, cubic miles
|
~
|
|
cubic millimeter, cubic millimeters, cu mm, mm3
|
~
|
|
cubic centimeter, cubic centimeters, cu cm, cm3
|
~
|
|
meter cubed, meters cubed, cubic meter, cubic meters, cu m, m3
|
~
|
|
cubic kilometer, cubic kilometers, cu km, km3
|
~
|
|
liter, liters
|
~
|
|
gallon, gallons
|
~
|
|
quart, quarts
|
~
|
Temperature |
Details |
|
kelvin
|
Same graduations as Centigrade but zero degrees Kelvin corresponds to a temperature
of -273.15C (Absolute Zero).
|
|
rankine
|
Same graduations as Fahrenheit but zero degrees Rankine corresponds to a temperature
of -459.67F
|
|
farenheit, fahrenheit
|
~
|
|
celsius
|
~
|
Angle |
Details |
|
radian, radians
|
~
|
|
round, rounds
|
~
|
|
degree, degrees
|
Float
|
|
degree latitude
|
~
|
|
degree longitude
|
~
|
|
grad, grads
|
~
|
Global Position |
Details |
|
degree latitude, degrees latitude
|
~
|
|
degree longitude, degrees longitude
|
~
|
|
meter latitude, meters latitude
|
~
|
Angular Velocity |
Details |
|
radian per second, radians per second
|
~
|
|
revolution per minute, revolutions per minute, rpm, rpms
|
~
|
|
minute per round, minutes per round
|
~
|
|
nice minute per round, nice minutes per round
|
~
|
|
degree per second, degrees per second
|
~
|
Speed |
Details |
|
meter per second, meters/second, m/s
|
~
|
|
meter per minute, meters per minute
|
~
|
|
feet/second
|
~
|
|
feet/minute, ft/min
|
~
|
|
kilometer/hour, kilometers/hour, kilometers per hour, kph
|
~
|
|
knot, knots
|
Nautical mile per hour
|
|
mile per hour, miles per hour, mph
|
~
|
|
mach, machs
|
~
|
Acceleration |
Details |
|
meter per second squared meters per second squared
|
~
|
|
Gforce, G Force
|
Unit of acceleration equal to the acceleration of gravity.
|
|
feet per second squared, foot per second squared
|
~
|
Time |
Details |
|
second, seconds
|
~
|
|
minute, minutes
|
~
|
|
hour, hours
|
~
|
|
day, days
|
~
|
|
hour over 10, hours over 10
|
~
|
Power |
Details |
|
Watt, Watts
|
~
|
|
ft lb per second
|
~
|
Volume Rate |
Details |
|
meter cubed per second, meters cubed per second
|
~
|
|
gallon per hour, gallons per hour, gph
|
~
|
|
liter per hour, liters per hour
|
~
|
Weight |
Details |
|
kilogram, kilograms, kg
|
~
|
|
slug, slugs, geepound, geepounds
|
A unit of mass to which a force of one pound imparts an acceleration of one foot
per second squared. One geepound, or slug, equals about 14.59 kg or 32.2 lb.
|
|
pound, pounds, lbs
|
~
|
Weight Rate |
Details |
|
kilogram per second, kilograms per second
|
~
|
|
pound per hour, pounds per hour, pph
|
~
|
|
pound per second, pounds per second, pps
|
~
|
Electrical Current |
Details |
|
ampere, amperes, amp, amps
|
~
|
Electrical Potential |
Details |
|
volt, volts
|
~
|
Frequency |
Details |
|
Hertz, Hz,
|
~
|
|
Kilohertz, KHz
|
~
|
|
Megahertz, MHz
|
~
|
|
Frequency BCD32
|
Frequency in 32 bit binary coded decimal
|
|
Frequency BCD16
|
Frequency in 16 bit binary coded decimal
|
|
Frequency ADF BCD32
|
~
|
Density |
Details |
|
kilogram per cubic meter, kilograms per cubic meter
|
~
|
|
Slug per cubic feet, Slugs per cubic feet, Slug/ft3, slug per cubic foot, slugs per
cubic foot
|
~
|
|
pound per gallon, pounds per gallon, lbs/gallon
|
~
|
Pressure |
Details |
|
pascal, pascals, Pa
|
~
|
|
Newton per square meter, newtons per square meter
|
~
|
|
kilopascal, kpa
|
~
|
|
kilogram force per square centimeter, KgFSqCm
|
~
|
|
millimeter of mercury, millimeters of mercury, mmHg
|
~
|
|
centimeter of mercury, centimeters of mercury, cmHg
|
~
|
|
inch of mercury, inches of mercury, inHg
|
~
|
|
atmosphere, atmospheres, atm
|
~
|
|
millimeter of water, millimeters of water
|
~
|
|
pound-force per square inch, psi
|
~
|
|
pound-force per square foot, psf
|
~
|
|
bar, bars
|
~
|
|
millibar, millibars, mbar, mbars, hectopascal, hectopascals
|
~
|
|
boost cmHg
|
~
|
|
boost inHg
|
~
|
|
boost psi
|
~
|
|
slug feet squared, slugs feet squared
|
~
|
|
kilogram meter squared, kilograms meter squared
|
~
|
|
millibar, millibars, mbar, mbars, hectopascal, hectopascals
|
~
|
Torque |
Details |
|
Newton meter, Newton, meters, nm
|
~
|
|
foot-pound, foot pound, ft-lbs, foot-pounds
|
~
|
|
lbf-feet
|
One lbf-foot equals 1.36 Newton meters
|
|
kilogram meter, kilogram meters, kgf meter, kgf meters
|
~
|
|
poundal feet
|
One poundal foot equals 0.042 Newton meters
|
Miscellaneous Units |
Details |
|
part
|
~
|
|
half, halfs
|
~
|
|
third, thirds
|
~
|
|
percent, percentage
|
Normally a value between 0 and 100, though sometimes values outside this range are
possible (reverse thrust, for example).
|
|
percent over 100
|
Normally a value between 0.0 and 1.0, though sometimes values outside this range
are possible (reverse thrust, for example).
|
|
bel, bels
|
~
|
|
decibel, decibels
|
~
|
|
more_than_a_half
|
~
|
|
times
|
~
|
|
ratio
|
~
|
|
number, numbers
|
~
|
|
scaler
|
~
|
|
position
|
Equivalent to Percent over 100
|
|
position 16k
|
Normally a value between -16384 and 16384
|
|
position 32k
|
Normally a value between 0 and 32767
|
|
Enum
|
A positive or negative integer corresponding to the member of the enum
|
|
Bool, Boolean
|
The only reliable numeric equivalent is that 0 is returned for False. Non-zero values,
especially both 1 and -1, are used to indicate True.
|
|
Bco16
|
~
|
|
mask
|
~
|
|
flags
|
~
|
|
string
|
~
|
|
per radian
|
~
|
|
per degree
|
~
|