appendantab

appendantab(vis, outvis, antab, overwrite=False, append_tsys=True, append_gc=True)[source]

Append syscal and gaincurve data from an antab file

[Description] [Examples] [Development] [Details]

Parameters

  • vis (path) - Name of input visibility file

  • outvis (string) - Name of output visibility file

  • antab (path) - Name of the input antab file

  • overwrite (bool=False) - Allow overwrite of outvis

  • append_tsys (bool=True) - Append the SYSCAL subtable

  • append_gc (bool=True) - Append the GAIN_CURVE subtable

Allow users to append information available in antab files directly to a ms. Use a ms generated from importfitsidi and then use this task to append tsys and gain curve information to the ms.

Warning

WARNING: The parser for the antab files can be quite strict which may effect some instruments disproportionately. If you had success with the vlbi tools version this parser is the same. This task also MUST be used with importfitsidi filled data. It is also recommended that, if using an ms generated from multiple fitsidi files, constobsid should be set to True if the resulting ms will be used in conjunction with this task.

Parameters

vis

Specify the name of the MS created from a fits file as a string

outvis

Specify the name of the output vis that will have the antab information appended to it

antab

Specify the antab file to be appended to the vis as a string

overwrite

If True then the task will overwrite existing values in the GAIN_CURVE and SYSCAL tables if overlapping data is present in the antab file. Data in the antab file that does not overlap with a value in existing tables will be appended as normal.

append_tsys

Using the tsys information available in the antab file append to the SYSCAL subtable when this is True

append_gc

Using the gain curve information available in the antab file append to the GAIN_CURVE subtable when this is True

Examples

This example will take a ms and output one with the name “appended_data.ms” by appending the tys and gc infromation from an antab file:

appendantab(vis='imported_fits.ms', outvis='appended_data.ms, overwrite=False,
 append_tsys=True, append_gc=True)
Development

No additional development details

Parameter Details

Detailed descriptions of each function parameter

vis (path) - Name of input visibility file
Default: none
Example: vis=’ngc5921.ms’
outvis (string) - Name of output visibility file. If the file name specified already exists it will be replaced
Default: none
Example: caltable=’ngc5921.ms’
antab (path) - Name of antab file to append info from
Default: none
Example: caltable=’bc246b.antab’
overwrite (bool=False) - Allows the outvis file to be overwritten
Default: False
append_tsys (bool=True) - Use the information from the antab file to create and fill the SYSCAL subtable
Default: True
append_gc (bool=True) - Use the information from the antab file to create and fill the GAIN_CURVE subtable
Default: True