<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" ?>
<casaxml xmlns="http://casa.nrao.edu/schema/psetTypes.html"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://casa.nrao.edu/schema/casa.xsd
file:///opt/casa/code/xmlcasa/xml/casa.xsd">
<task type="function" name="cvel2" category="manipulation" visibility="experimental">
<shortdescription>Regrid an MS or MMS to a new spectral window, channel structure or frame</shortdescription>
The intent of cvel2 is to transform channel labels and the
visibilities to a spectral reference frame which is appropriate for
the science analysis, e.g. from TOPO to LSRK to correct for Doppler
shifts throughout the time of the observation. Naturally, this will
change the shape of the spectral feature to some extent. According to
the Nyquist theorem you should oversample a spectrum with twice the
numbers of channels to retain the shape. Based on some tests, however,
we recommend to observe with at least 3-4 times the number of channels
for each significant spectral feature (like 3-4 times the
linewidth). This will minimize regridding artifacts in cvel2.
If cvel2 has already established the grid that is desired for the
imaging, tclean should be run with exactly the same frequency/velocity
parameters as used in cvel2 in order to avoid additional regridding in
Hanning smoothing is optionally offered in cvel2, but tests have shown
that already the regridding process itself, if it involved a
transformation from TOPO to a non-terrestrial reference frame, implies
some smoothing (due to channel interpolation) such that Hanning
smoothing may not be necessary.
This version of cvel2 also supports Multi-MS input, in which case it
will create an output Multi-MS too.
The parameter passall is not supported in cvel2. The user may
achieve the same results of passall=True by splitting out the data
that will not be regridded with cvel2 and concatenate regridded
and non-regridded sets at the end. In the case of Multi-MS input,
the user should use virtualconcat to achieve a concatenated MMS.
<param type="string" name="vis" mustexist="true">
<shortdescription>Name of input visibility file</shortdescription>
<description>Name of input visibility file
Example: vis='ngc5921.ms'
<param type="string" name="outputvis">
<shortdescription>Name of output visibility file</shortdescription>
<description>Name of output visibility file or Multi-MS
Example: vis='ngc5921_out.ms'
<param type="bool" name="keepmms">
<shortdescription>Create a Multi-MS as the output if the input is a Multi-MS</shortdescription>
<description>If the input is a Multi-MS the output will also be a
By default it will create a Multi-MS when the
input is a Multi-MS. The output Multi-MS will
have the same partition axis of the input
MMS. See 'help partition' for more information on
NOTE: It is not possible to combine the spws if
the input MMS was partitioned with
separationaxis='spw'. In this case, the task will
<param type="bool" name="passall" subparam="true" visibility="hidden">
<shortdescription>Hidden parameter</shortdescription>
<description>HIDDEN parameter. Pass through (write to output MS) non-selected data with no change</description>