NRAO Home > CASA > CASA Task Reference Manual

0.1.65 listcal

Requires:

Synopsis
List antenna gain solutions

Description

This task lists antenna gain solutions in tabular form. The table is organized as follows. Solutions are output by 1) Spectral window, 2) Antenna, 3) Time, 4) Channel, 5) and Polarization; where the inner-most loop is over polarization.

The listcal output table contains two table headers. The top-level header is printed each time the spectral window changes. This header lists the spectral window ID (SpwID), the date of observation (Date), the calibration table name (CalTable), and the measurement set name (MS name).

A lower-level header is printed when the the top-level header is printed, when the antenna names change, and every ‘pagerows’ of output. The lower-level header columns are described here:

Column Name Description ———– ———– Ant Antenna name (contains sub-columns: Amp, Phs, F) Time Visibility timestamp corresponding to gain solution Field Field name Chn Channel number Amp Complex solution amplitude Phs Complex solution phase F Flag

Elements of the “F” column contain an ‘F’ when the datum is flagged, and ‘ ’ (whitespace) when the datum is not flagged.

Presently, the polarization mode names (for example: R, L) are not given, but the ordering of the polrization modes (left-to-right) is equivalent to the order output by task listobs (see “Feeds” in listobs output).

Input Parameters:

vis Name of input visibility file default: none; example: vis=’ngc5921.ms’

caltable Name of input calibration table default: none; example: caltable=’ngc5921.gcal’

field Select data based on field ID(s) or name(s) default: ”==¿all; example: field=’1’ field=’0~2’ field ids inclusive from 0 to 2 field=’3C*’ all field names starting with 3C

antenna Select calibration data based on antenna default: ”–¿all; example: antenna=’5’ antenna=’5,6’ antenna index 5 and 6 solutions antenna=’VA05’,’VA06’ VLA antenna 5 and 6

spw Select spectral window, channel to list default: ” –¿ All spws and channels; spw=’2:34’ spectral window 2, channel 34 will only list one spw, one channel at a time

listfile write output to disk; will not overwrite default: ” –¿ write to screen

pagerows rows per page of listing default: 50; 0 –¿ do not paginate



Arguments





Inputs

vis

Name of input visibility file

allowed:

string

Default:

caltable

Input calibration table to list

allowed:

string

Default:

field

Field name or index; ”==>all

allowed:

string

Default:

antenna

Antenna name or index; ”==>all; antenna=’3’

allowed:

string

Default:

spw

Spectral window and channel: ”==>all; spw=’5:0~10’

allowed:

string

Default:

listfile

Disk file to write output: ”==>to terminal

allowed:

string

Default:

pagerows

Rows per page

allowed:

int

Default:

50

Returns
void

Example

 
 
This task lists antenna gain solutions in tabular form.  The table  
is organized as follows.  Solutions are output by  
    1) Spectral window,  
    2) Antenna,  
    3) Time,  
    4) Channel,  
    5) and Polarization;  
where the inner-most loop is over polarization.  
 
The listcal output table contains two table headers.  The top-level header  
is printed each time the spectral window changes.  This header lists  
the spectral window ID (SpwID), the date of observation (Date),  
the calibration table name (CalTable), and the measurement set name (MS name).  
 
A lower-level header is printed when the the top-level header is printed,  
when the antenna names change, and every ‘pagerows’ of output.  
The lower-level header columns are described here:  
 
Column Name    Description  
-----------    -----------  
Ant            Antenna name (contains sub-columns: Amp, Phs, F)  
Time           Visibility timestamp corresponding to gain solution  
Field          Field name  
Chn            Channel number  
Amp            Complex solution amplitude  
Phs            Complex solution  phase  
F              Flag  
 
Elements of the ‘‘F’’ column contain an ‘F’ when the datum is flagged,  
and ‘ ’ (whitespace) when the datum is not flagged.  
 
Presently, the polarization mode names (for example: R, L)  
are not given, but the ordering of the polrization modes (left-to-right) is  
equivalent to the order output by task listobs (see ‘‘Feeds’’ in listobs  
output).  
 
Input Parameters:  
 
vis         Name of input visibility file  
            default: none; example: vis=’ngc5921.ms’  
 
caltable    Name of input calibration table  
            default: none; example: caltable=’ngc5921.gcal’  
 
field       Select data based on field ID(s) or name(s)  
            default: ’’==>all; example: field=’1’  
            field=’0~2’ field ids inclusive from 0 to 2  
            field=’3C*’ all field names starting with 3C  
 
antenna     Select calibration data based on antenna name  
            default: ’’-->all; example: antenna=’5’;  
            antenna=’5,6’ antenna index 5 and 6 solutions  
            antenna=’VA05’,’VA06’  VLA antenna 5 and 6  
 
spw         Select spectral window(s), channel(s) to list  
            default: ’’ --> All spws and channels;  
            spw=’2:34’ spectral window 2, channel 34;  
            spw=’1:5,3~5:7~9’ spectral window 1, channel  
            5 and spectral windows 3 thru 5, channels  
            7 thru 9.  
 
listfile    write output to disk; will not overwrite  
            default: ’’ --> write to screen  
 
pagerows    rows per page of listing  
            default: 50; 0 --> do not paginate  
 
Example:  
 
# Get path to CASA home dir  
pathname=os.environ.get(’CASAPATH’).split()[0]  
# Select uv-data (FITS) file  
fitsdata=pathname+’/data/demo/NGC5921.fits’  
# MS name; write to current directory  
msdata=’NGC5921.ms’  
# import FITS data to MS  
importuvfits(fitsfile=fitsdata, vis=msdata)  
# Create model data for flux calibrator  
setjy(vis=msdata)  
# Calibration table name  
caldata=msdata+’.bcal’  
# Bandpass calibration  
bandpass(vis=msdata, caltable=caldata)  
# List a subset of calibration factors  
listcal(vis=msdata, caltable=caldata, field=’N5921_2, 0, 1’,  
        antenna=’1,2,5;10~14’, spw=’0:1,0:22~25’, pagerows=0)  
 
Example Output:  
 
SpwID = 0, Date = 1995/04/13,  CalTable = NGC5921.ms.bcal (B Jones), MS name = /users/jcrossle/NRAO/casa/NGC5921.ms  
-------------------------------------------------------------------------------------------------------------------------------------------------------  
                              | Ant = 1                     | Ant = 2                     | Ant = 5                     | Ant = 10                    |  
Time       Field           Chn|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  
----------|---------------|---|--------------|--------------|--------------|--------------|--------------|--------------|--------------|--------------|  
09:21:46.0 1331+30500002_0   1|0.165    7.9   0.117   21.3   0.168   98.8   0.161 -116.8   0.146  -24.6   0.153 -109.7   0.163 -158.6   0.139    3.9  
10:05:27.9 1445+09900002_0   1|0.260   10.3   0.185   20.0   0.266  102.3   0.250 -116.1   0.233  -20.4   0.245 -108.6   0.255 -156.5   0.217    4.1  
10:09:05.3         N5921_2   1|0.047   54.2   0.030   50.7   0.057  -64.6   0.041   36.5   0.050   93.5   0.035  -13.9   0.079   97.5   0.048 -107.0  
                              | Ant = 11                    | Ant = 12                    | Ant = 13                    | Ant = 14                    |  
Time       Field           Chn|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  
----------|---------------|---|--------------|--------------|--------------|--------------|--------------|--------------|--------------|--------------|  
09:21:46.0 1331+30500002_0   1|0.156 -112.6   0.128   -5.5   0.156 -178.4   0.169 -146.2   0.160 -177.4   0.148  -89.1   0.173 -117.0   0.145  141.5  
10:05:27.9 1445+09900002_0   1|0.243 -110.6   0.199   -5.7   0.251 -175.4   0.272 -146.9   0.249 -175.0   0.238  -89.5   0.268 -113.5   0.228  142.5  
10:09:05.3         N5921_2   1|0.054   47.1   0.056  105.5   0.042  -84.9   0.043  -18.9   0.058   72.4   0.055  155.6   0.040  -35.0   0.044 -153.6  
SpwID = 0, Date = 1995/04/13,  CalTable = NGC5921.ms.bcal (B Jones), MS name = /users/jcrossle/NRAO/casa/NGC5921.ms  
-------------------------------------------------------------------------------------------------------------------------------------------------------  
                              | Ant = 1                     | Ant = 2                     | Ant = 5                     | Ant = 10                    |  
Time       Field           Chn|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  
----------|---------------|---|--------------|--------------|--------------|--------------|--------------|--------------|--------------|--------------|  
09:21:46.0 1331+30500002_0  22|0.319    4.6   0.323   -6.8   0.311  109.6   0.315 -109.0   0.286  -26.8   0.324 -106.8   0.303 -146.6   0.303    4.3  
09:21:46.0 1331+30500002_0  23|0.318    4.4   0.323   -6.8   0.309  109.7   0.315 -108.8   0.285  -26.8   0.325 -106.5   0.304 -146.2   0.304    4.6  
09:21:46.0 1331+30500002_0  24|0.318    4.2   0.323   -6.6   0.309  109.8   0.316 -108.6   0.285  -26.8   0.324 -106.6   0.302 -146.1   0.304    5.0  
09:21:46.0 1331+30500002_0  25|0.319    4.3   0.323   -6.6   0.308  109.5   0.315 -108.4   0.285  -26.7   0.323 -106.7   0.301 -145.9   0.303    5.1  
10:05:27.9 1445+09900002_0  22|0.502    7.0   0.508   -7.9   0.483  112.2   0.499 -108.5   0.451  -24.2   0.515 -106.2   0.481 -144.1   0.489    4.6  
10:05:27.9 1445+09900002_0  23|0.498    7.2   0.509   -8.2   0.489  112.6   0.502 -108.8   0.455  -23.9   0.513 -106.2   0.477 -144.0   0.480    5.0  
10:05:27.9 1445+09900002_0  24|0.496    6.3   0.506   -7.1   0.487  111.9   0.502 -108.3   0.450  -23.8   0.517 -106.1   0.473 -144.6   0.478    4.0  
10:05:27.9 1445+09900002_0  25|0.489    6.3   0.512   -8.2   0.483  113.0   0.498 -108.7   0.456  -24.3   0.507 -105.5   0.470 -144.4   0.476    4.3  
10:09:05.3         N5921_2  22|0.089   53.9   0.084   38.8   0.135  -84.0   0.148   54.9   0.100   94.2   0.112    4.4   0.112   90.6   0.115 -124.0  
10:09:05.3         N5921_2  23|0.068   50.4   0.073   31.5   0.117  -80.7   0.150   50.5   0.103   90.3   0.120    2.6   0.104  103.6   0.104 -121.5  
10:09:05.3         N5921_2  24|0.068   51.4   0.080   45.1   0.125  -89.0   0.146   47.3   0.106   99.9   0.122    8.8   0.102   95.9   0.099 -121.4  
10:09:05.3         N5921_2  25|0.060   45.8   0.060   42.5   0.124  -85.4   0.146   47.8   0.110   93.4   0.125    7.2   0.088  100.9   0.096 -115.9  
                              | Ant = 11                    | Ant = 12                    | Ant = 13                    | Ant = 14                    |  
Time       Field           Chn|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  Amp    Phs F   Amp    Phs F|  
----------|---------------|---|--------------|--------------|--------------|--------------|--------------|--------------|--------------|--------------|  
09:21:46.0 1331+30500002_0  22|0.302  -99.8   0.301  -10.5   0.341  169.8   0.350 -137.6   0.306 -167.6   0.308  -84.8   0.319 -103.6   0.316  143.7  
09:21:46.0 1331+30500002_0  23|0.301  -99.9   0.302  -10.6   0.341  169.7   0.349 -138.0   0.306 -167.4   0.307  -84.5   0.318 -103.6   0.316  143.8  
09:21:46.0 1331+30500002_0  24|0.300 -100.0   0.301  -10.9   0.342  169.6   0.348 -138.4   0.305 -167.4   0.306  -84.3   0.319 -103.4   0.317  143.4  
09:21:46.0 1331+30500002_0  25|0.301 -100.1   0.300  -11.0   0.339  169.9   0.347 -138.5   0.305 -167.4   0.306  -84.0   0.317 -103.2   0.315  143.5  
10:05:27.9 1445+09900002_0  22|0.478  -97.3   0.482   -9.7   0.535  171.3   0.544 -138.1   0.480 -165.1   0.487  -86.0   0.502 -100.2   0.503  144.6  
10:05:27.9 1445+09900002_0  23|0.481  -97.4   0.479  -10.4   0.531  171.4   0.549 -138.9   0.483 -165.3   0.489  -84.3   0.498  -99.7   0.501  144.7  
10:05:27.9 1445+09900002_0  24|0.482  -97.6   0.484  -10.1   0.532  172.7   0.544 -139.3   0.489 -165.3   0.476  -84.6   0.498 -100.3   0.502  144.6  
10:05:27.9 1445+09900002_0  25|0.479  -98.4   0.484  -10.1   0.534  172.4   0.553 -139.0   0.481 -165.4   0.479  -84.3   0.498 -100.3   0.497  145.0  
10:09:05.3         N5921_2  22|0.127   44.8   0.142  128.9   0.090  -94.4   0.090  -48.5   0.112   41.3   0.103  109.0   0.075    7.2   0.095 -120.1  
10:09:05.3         N5921_2  23|0.135   43.1   0.132  126.0   0.087  -89.3   0.103  -38.2   0.112   39.3   0.100  117.8   0.076   -3.4   0.098 -113.5  
10:09:05.3         N5921_2  24|0.135   49.4   0.137  136.1   0.092  -95.9   0.084  -42.7   0.104   49.9   0.120  117.6   0.087    2.9   0.097 -121.2  
10:09:05.3         N5921_2  25|0.144   49.8   0.119  130.0   0.086  -96.5   0.074  -42.8   0.109   41.5   0.124  120.8   0.087    0.4   0.104 -117.3  
 
Listed 120 antenna solutions.  
 


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

Copyright © 2016 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