Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

mirfiller.getoptions - Function

	Package	bima
	Module	mirfiller
	Tool	mirfiller

return the current filler options

Synopsis
getoptions()

Description
mirfiller supports a variety of options that can be set to control the filling, and this function returns their state as a Glish record. The currently supported options are:

• scanlim -- the scan time jump limit (quantity). If the jump in time between two consecutive Miriad records is greater than this limit the scan number that gets written out for that record will be incremented. A change in source will always increment the scan number unless scanlim is negative; in this case, all records are forced to have the same scan number. The default is 5 minutes ('5min').
• obslim -- the observation ID time jump limit (quantity). The observation ID is meant to delimit two tracks that might appear in the same file. If the jump in time between two consecutive Miriad records is greater than this limit the scan number that gets written out for that record will be incremented. The ID will always be incremented if there is a change in telescope or array configuration unless obslim is negative, in which case, all records will be forced to have the same observation ID. The default is four hours ('4h').
• tilesize -- the tiling size to use for storing data in the MS using the TiledStorageManager. If the value is <= 0, the standard (non-tiled) storage manager will be used. The default is 32.
• verbose -- If true, extra messages will be sent to the logger.
• wideconv -- a string representing the convention to use for interpreting the wideband channels. The allowed values are ``bima'' and ``none.'' In the ``bima'' convention, the first two wideband channels are the lower & upper sideband averages and the remaining channels represent averages of each of the spectral line windows. Currently, this option only affects the writing out of window associations: if wideconv=``bima'', the associations linking wideband windows to spectral line windows will be written according to the convention.
• joinpol -- If false (the default), visibilities of different polarization correlation types will be loaded into different records. This is appropriate for uncalibrated BIMA data. If this option is true, the different polarizations observed at the same time will be gathered into a output record. This is appropriate for BIMA polarization measurement data that has been calibrated and time-averaged or data from a telescope with dual-polarization receivers. See section on Polarization in mirfiller module description for further discussion.
• tsyswt -- If true (the default), the system temperatures will be used to estimate the theoretical noise for the data which will subsequently be used (automatically) as weights during imaging. If false, system temperature weighting will be disabled. (System temperatures will be loaded regardless.)
• compress -- If true, the data will be written in compressed form. Compression reduces the size of the output MS by about a factor of two but also limits the dynamic range to 65000:1 (well above what is achievable with typical BIMA data). The default is currently false.
• updmodelint -- A time quantity representing how often a new planet model should be written. Default is 8 hours ('8h'). For observations of planets, a record is entered into the SOURCE_MODEL column of the SOURCE subtable which points to the planet model. A new model is written after every interval, 'updmodelint' has passed.

Example
The example shows a Glish session demonstrating getoptions() and setoptions(). Text to the right of the ``- '' represents the user input.

- frommir := mirfiller('3c273')
- frommir.getoptions()
[tilesize=32, scanlim=[value=5, unit=min], obslim=[value=4, unit=h],
wideconv=bima, joinpol=F, tsyswt=T, planetfit=4, movfield=T, 
updmodelint=[value=8, unit=h], verbose=F]
- frommir.setoptions(verbose=T, scanlim='2min')
T
- frommir.getoptions()
[tilesize=32, scanlim=[value=2, unit=min], obslim=[value=4, unit=h],
wideconv=bima, joinpol=F, tsyswt=T, planetfit=4, movfield=T, 
updmodelint=[value=8, unit=h], verbose=T]
- frommir.setoptions(obslim='0.5h')
T
- frommir.getoptions();
[tilesize=32, scanlim=[value=2, unit=min], obslim=[value=0.5, unit=h], 
wideconv=bima, joinpol=F, tsyswt=T, planetfit=4, movfield=T, 
updmodelint=[value=8, unit=h], verbose=T]
- frommir.setoptions(updmodelint='30min');
T
- frommir.getoptions();
[tilesize=32, scanlim=[value=5, unit=min], obslim=[value=4, unit=h], 
wideconv=bima, joinpol=F, tsyswt=T, planetfit=4, movfield=T, 
updmodelint=[value=0.5, unit=h], verbose=F]
- frommir.setoptions(verbose=T, reset=T)
T
- frommir.getoptions();
[tilesize=32, scanlim=[value=5, unit=min], obslim=[value=4, unit=h], 
wideconv=none, joinpol=F, tsyswt=T, planetfit=4, movfield=T, 
updmodelint=[value=8, unit=h], verbose=T]