<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">
<tool module="calanalysis" name="calanalysis">
Get and fit data from a calibration table (CASA 3.4 and later).
<include>calanalysis_forward.h</include>
<include>calanalysis_private.h</include>
The calibration analysis (ca) tool is a standardized interface to the new format
(CASA 3.4 and later) calibration tables. It is designed to handle all types of
tables, e.g., gain, bandpass, Tsys, etc. The ca tool takes advantages of newly
implemented features in the CASA C++ code tree, e.g., iteration and parameter
selection, which means that calibration tables can be accessed in a manner very
similar to measurement sets.
The ca tool was originally designed to facilitate getting and/or processing data
from an entire calibration table in an organized fashion so that the information
could be written to other files. Additional features, e.g. introspective member
functions, were added so that scripters and general users can easily employ the
ca tool without using iteration (get one piece of data at a time).
Like the imaging tool (im), image analysis tool (ia), calibration tool (cb),
etc., a native calibration analysis tool (ca) is created when CASA starts up.
Other instances of the calibration analysis tool can be created, if required,
caLoc = casac.calanalysis()
**Open/Close Member Functions**
The purpose of the open() and close() member functions is obvious, i.e., they
open and close the new format calibration table. Each ca tool instance can have
only one open table. If no table has been opened, the other member functions
The member function definitions are:
ca.open( '<caltable name>' ) - This member function opens the calibration
table. If successful True is returned, otherwise False is returned.
ca.close() - This member function closes the calibration table. If a table was
open True is returned, otherwise False is returned.
**Introspective Member Functions**
The introspective member functions provide information about the shape and
contents of the file. For example, the numchannel() member function returns the
number of channels corresponding to each spectral window. Also, the field()
member function returns the field names or numbers. With this information,