hifv_mstransform

hifv_mstransform(vis=None, outputvis=None, outputvis_for_line=None, field=None, intent=None, spw=None, spw_line=None, chanbin=None, timebin=None, omit_contline_ms=None) → ResultsList[Results][source]

Create new MeasurementSets for science target imaging.

Create new MeasurementSets for imaging from the corrected column of the input MeasurementSet via calling mstransform with all data selection parameters. By default, all science target data is copied to the new MS(s). The new MeasurementSet is not re-indexed to the selected data and the new MS will have the same source, field, and spw names and ids as it does in the parent MS.

The first MeasurementSet that is produced is intended for continuum imaging and will end in targets_cont.ms. If there are spws that have been detected or specified as spectral line spws in the input MeasurementSet, an MS for science target line imaging will also be produced, which will end in _targets.ms.

Parameters:

  • vis --

    The list of input MeasurementSets. Defaults to the list of MeasurementSets specified in the hifv_importdata task. '': use all MeasurementSets in the context

    Examples: 'ngc5921.ms', ['ngc5921a.ms', ngc5921b.ms', 'ngc5921c.ms']

  • outputvis --

    A list of output MeasurementSets that will contain the transformed and flagged data for continuum imaging. This list must have the same length as the input list.

    Default Naming: By default, an input MS named <msrootname>.ms will produce an output named <msrootname>_targets_cont.ms.

    Examples

    • outputvis='ngc5921_targets_cont.ms'

    • outputvis=['ngc5921a_targets_cont.ms', 'ngc5921b_targets_cont.ms', 'ngc5921c_targets_cont.ms']

  • outputvis_for_line --

    A list of output MeasurementSets for line detection and imaging, created without RFI flagging. This list must have the same length as the input list.

    Default Naming: By default, an input MS named <msrootname>.ms will produce an output named <msrootname>_targets.ms.

    Examples

    • outputvis_for_line='ngc5921_targets.ms'

    • outputvis_for_line=['ngc5921a_targets.ms', 'ngc5921b_targets.ms', 'ngc5921c_targets.ms']

  • field --

    Select fields name(s) or id(s) to transform. Only fields with data matching the intent will be selected.

    Examples: '3C279', 'Centaurus*', '3C279,J1427-421'

  • intent --

    Select intents for which associated fields will be imaged. By default only TARGET data is selected.

    Examples: 'PHASE,BANDPASS'

  • spw -- Select spectral window/channels to include for continuum imaging. By default all science spws for which the specified intent is valid are selected.

  • spw_line -- Select spectral window/channels to include for line imaging. If specified, these will override the default, which is to use the spws identified as specline_windows in hifv_importdata or hifv_restoredata.

  • chanbin -- Width (bin) of input channels to average to form an output channel. If chanbin > 1 then chanaverage is automatically switched to True.

  • timebin -- Bin width for time averaging. If timebin > 0s then timeaverage is automatically switched to True.

  • omit_contline_ms -- If True, don't make the contline ms (_targets.ms). Only make cont MS (_targets_cont.ms). Default is False.

Returns:

The results object for the pipeline task is returned.

Examples

  1. Create a science target MS from the corrected column in the input MS:

>>> hifv_mstransform()

2. Make a phase and bandpass calibrator targets MS from the corrected column in the input MS:

>>> hifv_mstransform(intent='PHASE,BANDPASS')