Getting Started Documentation Glish Learn More Programming Contact Us
Version 1.9 Build 1488
News FAQ
Search Home


next up previous contents index
Next: iramcalibrater.amp - Function Up: iramcalibrater - Tool Previous: iramcalibrater.phase - Function


iramcalibrater.flux - Function



Package alma
Module alma
Tool iramcalibrater


perform flux calibration on the data


Synopsis
flux(fieldnames, fixed, freqgrp, timerange, plot, gibb, drop, numchancont)



Description

This function performs a flux density scale calibration using the selected calibration sources and spectral windows. Previously bandpassed and phase calibrated data are used to find the flux calibration needed. If fixed is unspecified, the function will execute in interactive mode, and the user will be queried for names and flux densities of known calibrators (at least one of the fields specified in fieldnames must be specified). The flux densities of the remaining fields and the efficiencies of the antennas will be derived and reported. In this mode, the user can iteratively change the flux density(ies) of the fixed-flux density calibrators to achieve the efficiencies expected.

If fixed is specified with any flux densities, this function will run in NON-interactive mode, and the user will have no opportunity to iterate as described above. This mode is useful if flux densities are confidently known a priori. In fixed, specify flux densities as a vector of string quantities (i.e., with units, e.g., '5Jy', or "5Jy 3.4Jy"). The values will be matched one-for-one with the field names in fieldnames. If only a subset of fields have known flux densities which the user desires fixed, list these fields first in fieldnames, or specify '-1Jy' for the flux densities of fields that should be derived. This mode assumes that the user is confident in the specification of known flux densities, and the fixed and derived flux densities/efficiencies will be automatically applied.

Timerange(s) may be specified to limit the range of data used in the calculation by using the timerange parameter. Specify these as pairs of times in a string. The format for the times can be: YYYY/MM/DD/hh:mm:ss, hh:mm:ss, hh:mm, or HH.xxh. In the latter two cases, the date will be assumed from the dataset. Note that the trailing 'h' in the third option specifies units of hours (e.g., 19:30:00 is the same as 19.5h ; in fact any appropriate time quantity (as string) may be specified). The number of time values specified must be even, with each pair representing a different timerange.

Use the numchancont parameter to specify (if necessary) the number of channels in the spectral window(s) that should be used for determining the flux scale.



Returns
A list of flux densities in Jy.



Arguments

fieldnames   Field names of calibrators to be used
    Allowed: Vector of Strings
fixed   Fixed flux densities for known calibrators (as string quantities)
    Allowed: Vector of Strings
freqgrp   spectral windows to be used in the bandpass calibration
    Allowed: '3mm-LSB' || '3mm-USB' || '1mm' || '1mm-LSB' || '1mm-USB'
    Default: '3mm-LSB'
timerange   Timerange(s) specified in pairs
    Allowed: String
    Default: ' '
plot   Display flux renormalized amplitudes
    Allowed: Bool
    Default: F
gibb   number of central channels to reject in solution
    Allowed: Int
    Default: 2
drop   percentage of channels to ignore on edges of band
    Allowed: Int
    Default: 5
numchancont   Number of channels in continuum spectral window
    Allowed: Int
    Default: 64



Example
myic:=iramcalibrater('10feb97-g067.ms')      
myic.phcor(F)
myic.rf(fieldname='0528+134', freqgrp='3mm-LSB')
myic.phase(fieldnames=['0528+134', '0415+379'], freqgrp='3mm-LSB')
myic.flux(fieldnames=['0528+134', '0415+379', 'MWC349'], 
          fixed=['2.92Jy','6.25Jy'],
          freqgrp='3mm-LSB', 
          timerange='18:30 19:00 21.25h 21.5h',
          plot=T)
myic.done()

In the example, data for three fields in the 3mm lower sideband during the time intervals 18:30-19:00 and and 21:15-21:30 are used in the flux density scale calibration, and only the first two fields have fixed flux densities specified (the third will be derived).





next up previous contents index
Next: iramcalibrater.amp - Function Up: iramcalibrater - Tool Previous: iramcalibrater.phase - Function   Contents   Index
Please send questions or comments about AIPS++ to aips2-request@nrao.edu.
Copyright © 1995-2000 Associated Universities Inc., Washington, D.C.

Return to AIPS++ Home Page
2006-08-01