1.3.1.0 measures.touvw

1.3.1 calculate a uvw measure from a baseline
Description

touvw calculates a uvw measure from a baseline. Note that the baseline does not have to be a proper baseline, but can be a series of positions (to call positions baselines see asbaseline ) for speed reasons: operations are linear and can be done on positions, which are converted to baseline values at the end (with expand ).

Whatever the reference code of the baseline, the returned uvw will be given in J2000. If the dot argument is given, that variable will be filled with a quantity array consisting of the time derivative of the uvw (note that only the sidereal rate is taken into account; not precession, earth tides and similar variations, which are much smaller). If the xyz variable is given, it will be filled with the quantity values of the uvw measure.

The values of the input baselines can be given as a quantity vector per x, y or z value.

uvw coordinates are calculated for a certain direction in the sky; hence the frame has to contain the direction for the calculation to work. Since the baseline and the sky rotate with respect of each other, the time should be specified as well.


Outputs
dot	uvw-dot (quantity array)
	allowed:	any
	Default:	record
xyz	uvw (quantity array)
	allowed:	any
	Default:	record
Inputs
v	baseline measure
	allowed:	any
	Default:	record

print "\t----\t touvw Ex 1 \t----"
print me.doframe(me.observatory(’atca’))
#True
print me.doframe(me.source(’1934-638’))
#True
print me.doframe(me.epoch(’utc’,qa.unit(’today’)))
#True
b=me.baseline(’itrf’,’10m’,’20m’,’30m’)
print me.touvw(b)
#{’dot’: {’unit’: ’m/s’,
#         ’value’: [-0.0011912452908351659,
#                   -0.00098731747136827593,
#                   -0.00048769097314181744]},
# ’return’: {’m0’: {’value’: -0.094777304811312649, ’unit’: ’rad’},
#            ’m1’: {’value’: -1.1509286139398101, ’unit’: ’rad’},
#            ’m2’: {’value’: 37.416573867739416, ’unit’: ’m’},
#            ’refer’: ’J2000’,
#            ’type’: ’uvw’},
# ’xyz’: {’unit’: ’m’,
#         ’value’: [15.184026188402472,
#                   -1.4434256399579168,
#                   -34.166677788919138]}}
print me.getvalue(me.touvw(b))
#{’m0’: {’value’: -0.094777304811312649, ’unit’: ’rad’},
# ’m1’: {’value’: -1.1509286139398101, ’unit’: ’rad’},
# ’m2’: {’value’: 37.416573867739416, ’unit’: ’m’}}
print me.getvalue(me.touvw(b))[’m0’]
#{’value’: -0.094777304811312649, ’unit’: ’rad’}

measures.touvw - Function