Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

almatifiller - Function

	Package	alma
	Module	alma

Convert ALMA-TI fits files to an MS

Synopsis
almatifiller(msfile, fitsdir, pattern, append, compress, combinebaseband, obsmode, chanzero, dophcor)

Description

This global function packages common operations using the almati2ms tool and, in addition, permits multiple ALMA-TI files to be filled per run, as specified by a FITS directory name and file modifier string.

It also allows you do do a 'phcor' at the end of the filling. Usually the DATA column hold the 'atmospheric phase-corrected' data. But it does happen at times that this process is not right and the non phase-corrected data amplitude is higher than the one that has been corrected. The process of 'phcor' compare the phase-corrected data to the non phase-corrected data on calibrators (at the 3mm bands) and whenever the latter is higher, data $\pm$ 20 minutes around that scan is replaced with the non phase-corrected data.

This function returns T is everything went well and F otherwise.

Arguments

msfile		Output MS file name
		Allowed:	Table name
		Default:	''
fitsdir		Input ALMA-TI FITS directory
		Allowed:	String
		Default:	''
pattern		File modifier string e.g. 18-feb*
		Allowed:	String
append		True if appending to an existing MS
		Allowed:	Boolean
		Default:	F
compress		True if compressed MS output required
		Allowed:	Boolean
		Default:	F
combinebaseband		True if sub-bands are to be combined
		Allowed:	Boolean
		Default:	F
obsmode		Observing mode (from ALMA-TI DATAPAR)
		Allowed:	String
		Default:	''
chanzero		Channel-zero selection options
		Allowed:	String:'NONE'|'TIME_AVG'|'TIME_SAMPLED'
		Default:	'NONE'
dophcor		Do the phcor process after filling
		Allowed:	Boolean
		Default:	F

Returns
T or F

Example

    include 'almati2ms.g'                                              #1
    almatifiller(msfile='ALMA.ms', fitsdir='.', pattern='G067*",
                 append=F, compress=F, obsmode='CORR', 
                 chanzero='TIME_AVG', dophcor=T)                       #2

This example fills all ALMA-TI fits files starting with the file name G067 from the current working directory, and creates a new MS named ALMA.ms. The output MS will not be compressed. Only data from the observing mode CORR will be filled and all but the time-averaged channel-zero data will be rejected. Also, as the dophcor parameter is set to 'T', it will do the phcor process at the end of the filling process.