casa6

<casaxml xsi:schemaLocation="http://casa.nrao.edu/schema/casa.xsd file:///opt/casa/code/xmlcasa/xml/casa.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://casa.nrao.edu/schema/psetTypes.html">

​

<task category="manipulation" name="testconcat" type="function">

<shortdescription>Concatenate the subtables of several visibility data sets, not the MAIN bulk data.</shortdescription>

​

<input>

  <param mustexist="true" name="vis" type="pathVec">

    <description>Name(s) of input visibility files to be test-concatenated</description>

    <value/>

  </param>

​

  <param name="testconcatvis" type="string">

    <description>Name of output MS containing the merged subtables</description>

    <value/>

  </param>

  <param name="freqtol" type="any">

    <description>Frequency shift tolerance for considering data as the same spwid</description>

    <any type="variant"/>

    <value type="string"/>

  </param>

​

  <param name="dirtol" type="any">

    <description>Direction shift tolerance for considering data as the same field</description>

    <any type="variant"/>

    <value type="string"/>

  </param>

​

  <param name="copypointing" type="bool">

    <description>Copy all rows of the POINTING table.</description>

    <value>True</value>

  </param>

​

</input>

<example>

​

The list of data sets given in the vis argument are concatenated into an output

data set in testconcatvis without the bulk data of the MAIN table.  

This is useful for obtaining the information in the merged subtables without

actually performing a time-consuming concatenation of the MAIN tables on disk.

​

​

Keyword arguments:

vis -- Name of input visibility files for which the subtables are to be combined

        default: none; example: vis = 'mydata.ms',

             vis=['src2.ms','ngc5921.ms','ngc315.ms']

testconcatvis -- Name of MS that will contain the concatenated subtables

        default: none; example: testconcatvis='test.ms'

​

freqtol -- Frequency shift tolerance for considering data to be in the same

           spwid.  The number of channels must also be the same.

        default: ''  do not combine unless frequencies are equal

        example: freqtol='10MHz' will not combine spwid unless they are

           within 10 MHz.

        Note: This option is useful to conbine spectral windows with very slight

           frequency differences caused by Doppler tracking, for example.

​

dirtol -- Direction shift tolerance for considering data as the same field

        default: '' means always combine.

        example: dirtol='1.arcsec' will not combine data for a field unless

           their phase center differ by less than 1 arcsec.  If the field names

           are different in the input data sets, the name in the output data

           set will be the first relevant data set in the list.

​

copypointing -- Make a proper copy of the POINTING subtable (can be time consuming).

                If False, the result is an empty POINTING table.

         default: True

​

</example> 

​

<returns>void</returns></task>

</casaxml>