|
|||
NRAO Home > CASA > CASA Task Reference Manual |
|
0.1.141 vishead
Requires:
Synopsis
List, summary, get, and put metadata in a measurement set
Description
List, summary, get, and put ”header” information in a measurement set.
Arguments
Inputs |
| ||
vis |
| Name of input visibility file
| |
| allowed: | string |
|
| Default: |
| |
mode |
| options: list, summary, get, put
| |
| allowed: | string |
|
| Default: | summary |
|
listitems |
| items to list ([] for all)
| |
| allowed: | stringArray |
|
| Default: | telescope observer project field freq_group_name spw_name schedule schedule_type release_date
|
|
hdkey |
| keyword to get/put
| |
| allowed: | string |
|
| Default: |
|
|
hdindex |
| keyword index to get/put, counting from zero. ”==>all
| |
| allowed: | string |
|
| Default: |
|
|
hdvalue |
| value of hdkey
| |
| allowed: | any |
|
| Default: | variant
|
|
This task allows the user to manipulate some meta-data parameters in a
measurement set. The mode=’list’ shows those keywords that are
presently implemented, with their values. The contents associated
with the keywords can be obtained (get) and changed (put).
The modes that are available are:
list --- List all keywords that are recognized, and list the
value(s) for each. Only these keywords can be obtained
(get) or changed (put)
summary --- Equivalent to running taskname=’listobs’; verbose=F
get --- Get the specified keyword value(s) from the ms
put --- Put the specified keyword value(s) into the ms
Parameters currently implemented are (June 1, 2009):
cal_grp
field Field names
fld_code Field Observing codes
freq_group_name
log
observer Observer name
project Project name
ptcs Phase tracking centers for each field
release_date
schedule
schedule_type
spw_name Spectral parameters?
source_name Source Names (=Field Names?)
telescope Telescope Name
Keyword arguments:
vis --- Name of input visibility file
default: none, example: vis=’my.ms’
mode --- Mode of operation for vishead
default = ’list’; example: mode=’get’
hdkey--- keyword to get or put from the ms (used in get/put mode only)
ex: hdkey=’telescope’
hdindex--- index (counting from 0) if keyword is an array (used in get/put
mode only)
ex: hdindex=’2’; hdindex=’’->put/get full array;
hdvalue --- value to be put in the MS (used in put mode only)
ex: hdvalue=array([’MyTelescope’])
Examples:
To transfer the parameters to useful python items requires some care.
taskname = ’vishead’
default()
vis = ’3C84C.ms’
mode = ’get’
to get a field name (string),
hdkey = ’field’; hdindex = ’2’; hdvalue=vishead();
print hdvalue[0] = the name for field=’2’
to get an phase center (number)
hdkey = ’ptcs’; hdindex = ’1’; hdvalue = vishead();
hdvalue[0][0] gives the ra, hdvalue[0][1] gives the dec in field ’1’
taskname = ’vishead’
default()
vis = ’3C84C.ms’
mode = ’put’
To change a string,
hdkey = ’field’; hdindex = ’2’; hdvalue = ’junk’; vishead()
field=’2’ is renamed ’junk’
To change a number, (egs. ra of field=1 to 0.5 radian)
is too complicated to figure out!
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