Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

measures.doframe - Function

	Package	general
	Module	measures
	Tool	measures

save a measure as frame reference

Synopsis
doframe(v)

Arguments

v	in	measure to be set in frame
		Allowed:	measure

Returns
bool

Description
doframe will set the measure specified as part of a frame. The Frame it button on the different measure GUI's has the same effect.

If conversion from one type to another is necessary (either in the GUI with the Convert- > button or with the measure function), the following frames should be set if one of the reference types involved in the conversion is as in the following lists.
Epoch

 UTC		
 TAI
 LAST	position
 LMST 	position
 GMST1 
 GAST 
 UT1 
 UT2 
 TDT 
 TCG 
 TDB 
 TCD

Direction

 J2000
 JMEAN		epoch 
 JTRUE 		epoch
 APP 		epoch
 B1950 
 BMEAN 		epoch
 BTRUE 		epoch
 GALACTIC 	
 HADEC 		epoch	position
 AZEL		epoch 	position
 SUPERGALACTIC
 ECLIPTIC
 MECLIPTIC      epoch
 TECLIPTIC	epoch
 PLANET		epoch   [position]

Position

 WGS84
 ITRF

Radial Velocity

 LSRK 		direction
 LSRD 		direction
 BARY 		direction
 GEO 		direction	epoch
 TOPO 		direction	epoch	position
 GALACTO	direction

Doppler

 RADIO 
 OPTICAL 
 Z 
 RATIO 
 RELATIVISTIC 
 BETA 
 GAMMA

Frequency

 REST 		direction			radialvelocity
 LSRK 		direction
 LSRD 		direction
 BARY 		direction
 GEO 		direction	epoch
 TOPO 		direction	epoch	position
 GALACTO

Example

- print a := dm.epoch('utc', 'today') 			# a time
[type=epoch, refer=utc, m0=[value=50451.2, unit=d]]
- dm.doframe(a)						# set time in frame
T