NRAO Home > CASA > CASA Task Reference Manual

0.1.44 importasdm

Requires:

Synopsis
Convert an ALMA Science Data Model observation into a CASA visibility file

Arguments





Inputs

asdm

Name of input asdm directory (on disk)

allowed:

string

Default:

vis

Root name of the ms to be created. Note the .ms is NOT added

allowed:

string

Default:

singledish

Set true to output single-dish data format

allowed:

bool

Default:

False

antenna

antenna name or id

allowed:

any

Default:

variant 0

corr_mode

specifies the correlation mode to be considered on input. A quoted string containing a sequence of ao, co, ac,or all separated by whitespaces is expected

allowed:

string

Default:

all

srt

specifies the spectral resolution type to be considered on input. A quoted string containing a sequence of fr, ca, bw, or all separated by whitespaces is expected

allowed:

string

Default:

all

time_sampling

specifies the time sampling (INTEGRATION and/or SUBINTEGRATION) to be considered on input. A quoted string containing a sequence of i, si, or all separated by whitespaces is expected

allowed:

string

Default:

all

ocorr_mode

output data for correlation mode AUTO_ONLY (ao) or CROSS_ONLY (co) or CROSS_AND_AUTO (ca)

allowed:

string

Default:

ca

compression

Flag for turning on data compression

allowed:

bool

Default:

False

asis

Creates verbatim copies of the ASDMtables in the ouput measurement set. Value given must be a string of table names separated by spaces; A * wildcard is allowed.

allowed:

string

Default:

wvr_corrected_data

Specifies which values are considerd in the SDM binary data to fill the DATA column in the MAIN table of the MS. Expected values for this option are: no, for uncorrected data (default), yes, for the corrected data, and both, for for corrected and uncorrected data. Note if both is selected two measurement sets are created, one with uncorrected data and the other with corrected data.

allowed:

string

Default:

no

scans

processes only the specified scans. This value is a semicolon separated list of scan specifications. A scan specification consists in an exec bock index followed by the : character; followed by a comma separated list of scan indexes or scan index ranges. A scan index is relative to the exec block it belongs to. Scan indexes are 1-based while exec blocks are 0-based. ”0:1” or ”2:2~6” or ”0:1,1:2~6,8;2:,3:24~30” ”1,2” are valid values for the option. ”3:” alone will be interpreted as, all the scans of the exec block#3. An scan index or a scan index range not preceded by an exec block index will be interpreted as, all the scans with such indexes in all the exec blocks. By default all the scans are considered.

allowed:

string

Default:

ignore_time

All the rows of the tables Feed, History, Pointing, Source, SysCal, CalDevice, SysPower, and Weather are processed independently of the time range of the selected exec block / scan.

allowed:

bool

Default:

False

process_syspower

The SysPower table is processed if and only if this parameter is set to true.

allowed:

bool

Default:

True

process_caldevice

The CalDevice table is processed if and only if this parameter is set to true.

allowed:

bool

Default:

True

process_pointing

The Pointing table is processed if and only if this parameter is set to true.

allowed:

bool

Default:

True

verbose

Output lots of information while the filler is working

allowed:

bool

Default:

False

overwrite

Over write an existing MS

allowed:

bool

Default:

False

showversion

Report the version of asdm2MS being used

allowed:

bool

Default:

False

useversion

Selects the version of asdm2MS to be used (’v3’ (default, works for all ALMA data) or ’v2’ (only for ALMA data taken before May 2011))

allowed:

string

Default:

v3

Returns
void

Example

 
Convert an ALMA Science Data Model observation into a CASA visibility file (MS) or single-dish data format (Scantable).  
The conversion of the ALMA SDM archive format into a measurement set.  This version  
is under development and is geared to handling many spectral windows of different  
shapes.  
 
Keyword arguments:  
asdm -- Name of input ASDM file (directory)  
        default: none; example: asdm=’ExecBlock3’  
 
vis       -- Root ms or scantable name, note a prefix (.ms or .asap) is NOT appended to this name  
             default: none  
 
singledish   -- Set True to write data as single-dish format (Scantable)  
                default: False  
 
            >>> singledish expandable parameter  
                 antenna -- antenna name or id.  
 
corr_mode -- correlation mode to be considered on input. Could  
     be one or more of the following, ao, co, ac, or all  
     default: ’all’  
 
srt       -- spectral resolution type. Could be one or more of  
     the following, fr, ca, bw, or all  
     default: ’all’  
 
time_sampling -- specifies the time sampling, INTEGRATION and/or  
                 SUBINTEGRAION. could be one or more of the following  
                 i, si, or all.  
 default: ’all’  
 
ocorr_mode    -- output data for correlation mode AUTO_ONLY  
                 (ao) or CROSS_ONLY (co) or CROSS_AND_AUTO (ca)  
 default: ’ca’  
 
 
compression  -- produces comrpressed columns in the resulting measurement set.  
                default: False  
 
 
asis         --  creates verbatim copies of the ASDM tables in  
                 the output measurement set. The value given to  
 this option must be a list of table names separated  
 by space characters; the wildcard character ’*’ is  
                 allowed in table names.  
                default: none  
 
wvr_corrected_data -- specifies wich values are considered in the  
                      ASDM binary data to fill the DATA column in  
                      the MAIN table of the MS. Expected values for  
                      this option are ’no’ for the uncorrected data  
                      (this is the default), ’yes’ for the corrected  
                      data and ’both’ for corrected and uncorrected  
                      data. In the latter case, two measurement sets  
                      are created, one containing the uncorrected  
                      data and the other one, whose name is suffixed  
                      by ’-wvr-corrected’, containing the corrected  
                      data.  
                  default: ’no’  
 
scans --  processes only the scans specified in the option’s value. This value is a semicolon  
                  separated list of scan specifications. A scan specification consists in an exec bock index  
                  followed by the character ’:’ followed by a comma separated list of scan indexes or scan  
                  index ranges. A scan index is relative to the exec block it belongs to. Scan indexes are  
                  1-based while exec blocks’s are 0-based. ’0:1’ or ’2:2~6’ or ’0:1,1:2~6,8;2:,3:24~30’ ’1,2’  
                  are valid values for the option. ’3:’ alone will be interpreted as ’all the scans of the  
                  exec block#3’. An scan index or a scan index range not preceded by an exec block index will  
                  be interpreted as ’all the scans with such indexes in all the exec blocks’.  By default  
                  all the scans are considered.  
                    default: none (all scans)  
 
ignore_time -- All the rows of the tables Feed, History, Pointing, Source, SysCal, CalDevice, SysPower,  
               and Weather are processed independently of the time range of the selected exec block / scan.  
                    default: False  
 
process_syspower -- The SysPower table is processed if and only if this parameter is set to True.  
                    default: True  
 
process_caldevice -- The CalDevice table is processed if and only if this parameter is set to True.  
                    default: True  
 
process_pointing -- The Pointing table is processed if and only if this parameter is set to True.  
                    default: True  
 
verbose     -- produce log output as asdm2MS is being run  
                    default: False  
 
showversion -- report the version of the asdm2MS being used.  
                    default: False  
 
useversion -- Selects the version of asdm2MS to be used (\’v3\’ (default) or \’v2\’ (version before May 2011))  
              default: v3  
 


More information about CASA may be found at the CASA web page

Copyright 2010 Associated Universities Inc., Washington, D.C.

This code is available under the terms of the GNU General Public Lincense


Home | Contact Us | Directories | Site Map | Help | Privacy Policy | Search