Units

Listed below are Units of Measurement, supported by TMT observatory framework and are available as Enumerated values. Units are optionally attached to Parameter Keys.

Default Units for Keys

The default unit for UTCTimeKey and TAITimeKey (in Scala and Java both) is utc & tai respectively. For all the remaining keys, default unit is NoUnits.

SI Units

Name	Abbreviation	Description
angstrom	Angstrom	10 -1 nm
arcmin	arcmin	arc minute; angular measurement
arcsec	arcsec	arc second: angular measurement
day	d	day - 24 hours
degree	deg	degree: agular measurement 1/360 of full rotation
elvolt	eV	electron volt 1.6022x10-19 J
gram	g	gram 10-3 kg
hour	h	hour 3.6x10+3 s
hertz	Hz	frequency
joule	J	Joule: energy N m
kelvin	K	Kelvin: temperature with a null point at absolute zero
kilogram	kg	kilogram, base unit of mass in SI
kilometer	km	kilometers - 10+3 m
liter	l	liter, metric unit of volume 10+3 cm+3
meter	m	meter: base unit of length in SI
marcsec	mas	milli arc second: angular measurement 10-3 arcsec
millimeter	mm	millimeters - 10-3 m
millisecond	ms	milliseconds - 10-3 s
micron	µm	micron: alias for micrometer
micrometer	µm	micron: 10-6 m
minute	min	minute 6x10+1 s
newton	N	Newton: force
pascal	Pa	Pascal: pressure
radian	rad	radian: angular measurement of the ratio between the length of an arc and its radius
second	s	second: base unit of time in SI
sday	sday	sidereal day is the time of one rotation of the Earth: 8.6164x10+4 s
steradian	sr	steradian: unit of solid angle in SI - rad+2
microarcsec	µas	micro arcsec: angular measurement
volt	V	Volt: electric potential or electromotive force
watt	W	Watt: power
week	wk	week - 7 d
year	yr	year - 3.6525x10+2 d

CGS Units

Name	Abbreviation	Description
coulomb	C	coulomb: electric charge
centimeter	cm	centimeter
erg	erg	erg: CGS unit of energy

Astrophysical Units

Name	Abbreviation	Description
au	AU	astronomical unit: approximately the mean Earth-Sun distance
jansky	Jy	Jansky: spectral flux density - 10-26 W/Hz m+2
lightyear	lyr	light year - 9.4607x10+15 m
mag	mag	stellar magnitude

Imperial Units

Name	Abbreviation	Description
cal	cal	thermochemical calorie: pre-SI metric unit of energy
foot	ft	international foot - 1.2x10+1 inch
inch	inch	international inch - 2.54 cm
pound	lb	international avoirdupois pound - 1.6x10+1 oz
mile	mi	international mile - 5.28x10+3 ft
ounce	oz	international avoirdupois ounce
yard	yd	international yard - 3 ft

Datetime units

Name	Abbreviation	Description
tai	tai	TAI Time unit
utc	utc	UTC Time unit

Others - Engineering

Name	Abbreviation	Description
NoUnits	none	scalar - no units specified
encoder	enc	encoder counts
count	ct	counts as for an encoder or detector
pix	pix	pixel

Usage Examples

Scala

copysource// declare keyname
val s1: String = "encoder"

// making 3 keys
val k1: Key[Boolean] = KeyType.BooleanKey.make(s1)
val k2: Key[Short]   = KeyType.ShortKey.make("RandomKeyName")
val k3: Key[String]  = KeyType.StringKey.make(s1)

// storing a single value, default unit is NoUnits
val bParam: Parameter[Boolean] = k1.set(true)
val bDefaultUnitSet: Boolean   = bParam.units === Units.NoUnits // true

// default unit for UTCTimeKey
val utcParam: Parameter[UTCTime] = KeyType.UTCTimeKey.make("now").set(UTCTime.now())
// default unit for TAITimeKey
val taiParam: Parameter[TAITime] = KeyType.TAITimeKey.make("now").set(TAITime.now())

// storing multiple values
val paramOfShorts: Parameter[Short] = k2.set(1, 2, 3, 4)

// values to store
val weekDays: Array[String] = Array("Sunday", "Monday", "Tuesday")

// default units via set
val paramWithUnits1: Parameter[String] = k3.setAll(weekDays)
// associating units via withUnits
val paramWithUnits2: Parameter[String] = k3.setAll(weekDays) withUnits Units.day
// change existing unit
val paramWithUnits3: Parameter[Short] = paramOfShorts.withUnits(Units.meter)

Java

copysource//declare keyname
String s1 = "encoder";

//making 3 keys
Key<Boolean> k1 = JKeyType.BooleanKey().make(s1);
Key<Short> k2 = JKeyType.ShortKey().make("RandomKeyName", JUnits.NoUnits);
Key<String> k3 = JKeyType.StringKey().make(s1, JUnits.NoUnits);

//storing a single value, default unit is NoUnits()
Parameter<Boolean> bParam = k1.set(true);
boolean bDefaultUnitSet = bParam.units() == JUnits.NoUnits; //true

//default unit for UTCTimeKey
Parameter<UTCTime> utcParam = JKeyType
        .UTCTimeKey()
        .make("now")
        .set(UTCTime.now());

//default unit for TAITimeKey
Parameter<TAITime> taiParam = JKeyType
        .TAITimeKey()
        .make("now")
        .set(TAITime.now());


//storing multiple values
Parameter<Short> paramOfShorts = k2.set(
        (short) 1,
        (short) 2,
        (short) 3,
        (short) 4
);

//values to store
String[] weekDays = {"Sunday", "Monday", "Tuesday"};

//defaults units via set
Parameter<String> paramWithUnits1 = k3.setAll(weekDays);
//associating units via withUnits
Parameter<String> paramWithUnits2 = k3.setAll(weekDays).withUnits(JUnits.day);
//change existing unit
Parameter<Short> paramWithUnits3 = paramOfShorts.withUnits(JUnits.meter);

Source Code for Examples

• Scala Example
• Java Example