#
# stub function definition file for docstring parsing
#
[docs]def exportasdm(vis, asdm='', datacolumn='data', archiveid='S0', rangeid='X1', subscanduration='24h', sbduration='2700s', apcorrected=False, verbose=True, showversion=False, useversion='deprecated'):
r"""
Convert a CASA visibility file (MS) into an ALMA or EVLA Science Data Model
[`Description`_] [`Examples`_] [`Development`_] [`Details`_]
Parameters
- vis_ (path) - Name of input visibility file
- asdm_ (path='') - >Name of output ASDM directory (on disk)
- datacolumn_ (string='data') - Which data column(s) to process.
- archiveid_ (string='S0') - The X0 in uid://X0/X1/X2
- rangeid_ (string='X1') - The X1 in uid://X0/X1/X2
- subscanduration_ (string='24h') - Maximum duration of a subscan in the output ASDM
- sbduration_ (string='2700s') - Maximum duration of a scheduling block (and therefore exec block) in the output ASDM
- apcorrected_ (bool=False) - Data to be marked as having atmospheric phase correction
- verbose_ (bool=True) - Produce log output
- showversion_ (bool=False) - Deprecated: Report the version of ASDM class set being used
- useversion_ (string='deprecated') - Deprecated: Selects the version of MS2asdm to be used
.. _Description:
Description
This task serves to convert a CASA visibility file (MS) into an
ALMA or EVLA `Science Data
Model <../../notebooks/casa-fundamentals.ipynb#Science-Data-Model>`__
dataset. They are mostly identical and mostly use the general SDM
and ALMA ASDM terms interchangibly. A description of the SDM
format can be found
`here <../../notebooks/casa-fundamentals.ipynb#Science-Data-Model>`__.
The main purpose of creating this task was to (a) enable the
creation of simulated ASDMs and (b) facilitate the testing of
(A)SDM to MS conversion. The user may think of other purposes.
The *sbduration* parameter controls the number of execution blocks
(EBs) into which **exportasdm** subdivides the visibilities from
your input MS. If the total observation time in the MS is shorter
than what is given in *sbduration*, a single EB will be created.
Note concerning ALMA data: **exportasdm** presently is not able to
export from MSs containing WVR data. If you attempt to export such
an MS, you will receive an error message saying that you can only
export data of processor type "CORRELATOR". It will also give you
the list of SPWs which contain CORRELATOR data. You will then have
to split out these SPWs using the task **split** and run
**exportasdm** on the resulting MS.
Also EVLA data can be exported. Note here that **exportasdm** does
not produce online flags and that a subsequent re-import of the
data must be done with *online=False*.
.. _Examples:
Examples
To produce an ASDM named 'uid___S021_X1418_X1' using the
datacolumn 'corrected' in the MS 'ngc4826.ms' with minimal log
output:
::
exportasdm(vis=’ngc4826.ms’, asdm=’uid___S021_X1418_X1’,
datacolumn=’corrected’, archiveid=’S021’, rangeid=’X1418’,
verbose=False)
.. _Development:
Development
No additional development details
.. _Details:
Parameter Details
Detailed descriptions of each function parameter
.. _vis:
| ``vis (path)`` - Name of input visibility file
| Default: none
| Example: vis='ngc5921.ms'
.. _asdm:
| ``asdm (path='')`` - Name of output ASDM directory (on disk)
| Default: none
.. _datacolumn:
| ``datacolumn (string='data')`` - Which data column(s) to use for processing
| (case-insensitive).
| Default: 'corrected'
| Options: 'data', 'model', 'corrected',
| 'all','float_data', 'lag_data',
| 'float_data,data', 'lag_data,data'
| Example: datacolumn='data'
|
| NOTE: 'all' = whichever of the above that are
| present. If the requested column does not exist,
| the task will exit with an error.
.. _archiveid:
| ``archiveid (string='S0')`` - The X0 in uid://X0/X1/X2
| Default: 'S0'
.. _rangeid:
| ``rangeid (string='X1')`` - The X1 in uid://X0/X1/X2
| Default: 'X1'
.. _subscanduration:
| ``subscanduration (string='24h')`` - Maximum duration of a subscan in the output ASDM
| Default: 24h
.. _sbduration:
| ``sbduration (string='2700s')`` - Maximum duration of a scheduling block (and therefore
| exec block) in the output ASDM
| Default: '2700s'
| The sbduration parameter controls the number of
| execution blocks (EBs) into which exportasdm
| subdivides the visibilities from your input
| MS. If the total observation time in the MS is
| shorter than what is given in sbduration, a
| single EB will be created.
.. _apcorrected:
| ``apcorrected (bool=False)`` - Data to be marked as having atmospheric phase correction
| Default: False
| Options: False|True
.. _verbose:
| ``verbose (bool=True)`` - Produce log output?
| Default: True
| Options: True|False
.. _showversion:
| ``showversion (bool=False)`` - Deprecated. This parameter will be removed in a future release, this is no longer relevant.
| Report the version of ASDM class set being used
| Default: False
| Options: True|False
.. _useversion:
| ``useversion (string='deprecated')`` - Deprecated. This parameter will be removed in a future release. This is no longer relevant.
| Selects the version of MS2asdm to be used
| Default: 'deprecated'
| Options: deprecated, v3
"""
pass