<?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="flagmanager" category="editing">
<shortdescription>Enable list, save, restore, delete and rename flag version files.</shortdescription>
The flag version files are copies of the flag column for a measurement
set. They can be restored to the data set to get back to a previous
flag version. On running importvla, a flag version call 'Original' is
automatically produced. It is recommended to save a flagversion at the
beginning or after serious editing.
<param type="string" name="vis" mustexist="true">
<shortdescription>Name of input visibility file</shortdescription>
<description>Name of input visibility file
Example: vis='ngc5921.ms'
<example>vis='ngc5921.ms'</example>
<param type="string" name="mode">
<shortdescription>Operation: list, save, restore, delete, rename</shortdescription>
<description>Flag version operation
Options: list, save, restore, delete, rename
* 'list': it will list in the logger the existing
flag versions of the MS. This option will also
return by default a dictionary containing the
name of the MS, the name of the flag version
and the comment. This information is taken from
the FLAG_VERSION_LIST file inside the
* 'save': will save the FLAG column from vis to a
specified flag file. If the name given in
versionname already exists, the task will give
a warning and rename it to a name with a suffix
'.old.timestamp'. The respective entry in
FLAG_VERSION_LIST will also be updated.
* 'restore': will place the specified flag file
* 'delete': will delete specified flag file
* 'rename': will rename a specified flag file
<param type="string" name="versionname" subparam="true">