Coverage for /wheeldirectory/casa-6.7.0-12-py3.10.el8/lib/py/lib/python3.10/site-packages/casatasks/fixvis.py: 100%
27 statements
« prev ^ index » next coverage.py v7.6.4, created at 2024-11-01 07:19 +0000
« prev ^ index » next coverage.py v7.6.4, created at 2024-11-01 07:19 +0000
1##################### generated by xml-casa (v2) from fixvis.xml ####################
2##################### 2a2a5ff8548784bd9160433c24381183 ##############################
3from __future__ import absolute_import
4import numpy
5from casatools.typecheck import CasaValidator as _val_ctor
6_pc = _val_ctor( )
7from casatools.coercetype import coerce as _coerce
8from casatools.errors import create_error_string
9from .private.task_fixvis import fixvis as _fixvis_t
10from casatasks.private.task_logging import start_log as _start_log
11from casatasks.private.task_logging import end_log as _end_log
12from casatasks.private.task_logging import except_log as _except_log
14class _fixvis:
15 """
16 fixvis ---- Recalculates (u, v, w) and/or changes Phase Center
19 Recalculates (u, v, w) and/or changes Phase Center.
21 If the phase center is changed, the corresponding modifications
22 are applied to the visibility columns given by the parameter
23 "datacolumn" which is by default set to "all" (DATA, CORRECTED,
24 and MODEL).
26 --------- parameter descriptions ---------------------------------------------
28 vis Name of input visibility file
29 Default: none
31 Example: vis='ngc5921.ms'
32 outputvis Name of output visibility file
33 Default: '' (same as vis)
35 Example: outputvis='ngc5921_out.ms'
36 field Select field using field id(s) or field name(s)
37 Default: '' (all fields)
39 Use 'go listobs' to obtain the list id's or
40 names. If field string is a non-negative integer,
41 it is assumed a field index, otherwise, it is
42 assumed a field name.
44 Examples:
45 field='0~2'; field ids 0,1,2
46 field='0,4,5~7'; field ids 0,4,5,6,7
47 field='3C286,3C295'; field named 3C286 and
48 3C295
49 field = '3,4C*'; field id 3, all names
50 starting with 4C
51 refcode Reference frame to convert UVW coordinates to
52 Default: '' (refcode of PHASE_DIR in the FIELD
53 table)
55 Example: refcode='B1950'
56 reuse Base UVW calculation on the old values?
57 Default: True
58 Options: True|False
60 Note: ignored if parameter 'phasecenter' is set
61 phasecenter If set to a valid direction: change the phase center for
62 the given field to this value
63 If given without the equinox, e.g. '0h01m00s
64 +00d12m00s', the parameter is interpreted as a
65 pair of offsets in RA and DEC to the present
66 phasecenter.
68 Example: phasecenter='J2000 9h25m00s
69 -05d12m00s'
71 Note: The RA offset can be given in units of time
72 or angle. If given as a time (i.e. as a single
73 number with a time unit as in, e.g., 12s or in
74 the XXhXXmXXs or XX:XX:XX.XXX formats), it is
75 applied as is. If given as an angle (e.g.,
76 0.01deg), it is divided by the cos(DEC) before it
77 is applied.
78 distances (experimental) List of the distances (as quanta) of the
79 fields selected by field.
80 Default: [] (the distances of all fields are
81 assumed to be infinity.)
83 If not a list but just a single value is given,
84 this is applied to all fields.
86 Examples:
87 distances=['2E6km', '3E6km']
88 distances='15au'
89 datacolumn when applying a phase center shift, modify visibilities
90 only in this/these column(s)
91 Default: 'all' (DATA, CORRECTED, and MODEL)
93 Example: datacolumn='DATA,CORRECTED' (will not
94 modify MODEL)
96 --------- examples -----------------------------------------------------------
100 For more information, see the task pages of fixvis in CASA Docs:
102 https://casa.nrao.edu/casadocs/
105 """
107 _info_group_ = """manipulation"""
108 _info_desc_ = """Recalculates (u, v, w) and/or changes Phase Center """
110 def __call__( self, vis='', outputvis='', field=[ ], refcode='', reuse=True, phasecenter='', distances=[ ], datacolumn='all' ):
111 schema = {'vis': {'type': 'cReqPath', 'coerce': _coerce.expand_path}, 'outputvis': {'type': 'cStr', 'coerce': _coerce.to_str}, 'field': {'type': 'cVariant', 'coerce': [_coerce.to_variant]}, 'refcode': {'type': 'cStr', 'coerce': _coerce.to_str}, 'reuse': {'type': 'cBool'}, 'phasecenter': {'type': 'cStr', 'coerce': _coerce.to_str}, 'distances': {'type': 'cVariant', 'coerce': [_coerce.to_variant]}, 'datacolumn': {'type': 'cStr', 'coerce': _coerce.to_str}}
112 doc = {'vis': vis, 'outputvis': outputvis, 'field': field, 'refcode': refcode, 'reuse': reuse, 'phasecenter': phasecenter, 'distances': distances, 'datacolumn': datacolumn}
113 assert _pc.validate(doc,schema), create_error_string(_pc.errors)
114 _logging_state_ = _start_log( 'fixvis', [ 'vis=' + repr(_pc.document['vis']), 'outputvis=' + repr(_pc.document['outputvis']), 'field=' + repr(_pc.document['field']), 'refcode=' + repr(_pc.document['refcode']), 'reuse=' + repr(_pc.document['reuse']), 'phasecenter=' + repr(_pc.document['phasecenter']), 'distances=' + repr(_pc.document['distances']), 'datacolumn=' + repr(_pc.document['datacolumn']) ] )
115 task_result = None
116 try:
117 task_result = _fixvis_t( _pc.document['vis'], _pc.document['outputvis'], _pc.document['field'], _pc.document['refcode'], _pc.document['reuse'], _pc.document['phasecenter'], _pc.document['distances'], _pc.document['datacolumn'] )
118 except Exception as exc:
119 _except_log('fixvis', exc)
120 raise
121 finally:
122 task_result = _end_log( _logging_state_, 'fixvis', task_result )
123 return task_result
125fixvis = _fixvis( )