Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

measures.position - Function

	Package	general
	Module	measures
	Tool	measures

define a position measure

Synopsis
position(rf, v0, v1, v2, off)

Arguments

rf	in	reference code
		Allowed:	coded string
v0	in	longitude or x
		Allowed:	quantity
		Default:	0..
v1	in	latitude or y
		Allowed:	quantity
		Default:	90..
v2	in	height or z
		Allowed:	quantity
		Default:	0m
off	in	optional offset
		Allowed:	position measure
		Default:	F

Returns
string

Description
position defines a position measure from the CLI. It has to specify a reference code, position quantity values (see introduction for the action on a scalar quantity with either a vector or scalar value, and when a vector of quantities is given), and optionally it can specify an offset, which in itself has to be a position. Allowable reference codes are: WGS84 ITRF (World Geodetic System and International Terrestrial Reference Frame).
Note that additional ones may become available. Check in Glish with:

            
- dm.listcodes(dm.position())  
[normal=ITRF WGS84, extra=]

The position quantity values should be either longitude (angle), latitude(angle) and height(length); or x,y,z (length). See quantity for possible angle formats.

Example

- dm.position('wgs84','30deg','40deg','10m')
[type=position, refer=wgs84, m2=[value=10, unit=m], 
	m0=[value=0.523599, unit=rad], m1=[value=0.698132, unit=rad]]
- dm.observatory('ATCA')
[type=position, refer=ITRF, m2=[value=6.37296e+06, unit=m],
	m0=[value=2.61014, unit=rad], m1=[value=-0.526138, unit=rad]]