AIPS NRAO AIPS HELP file for BLPOLCAL in 31DEC25



As of Wed Dec 11 5:45:54 2024


BLPOLCAL: Procedure for spectral BLCAL for I, Q, U, V models

INPUTS

INNAME                             Input UV data name (name)
INCLASS                            Input UV data name (class)
INSEQ             0.0     9999.0   Input UV data name (seq. #)
INDISK            0.0        9.0   Input UV data disk unit #
IN2NAME                            Input I model name (name)
IN2CLASS                           Input I model name (class)
IN2SEQ            0.0     9999.0   Input I model name (seq. #)
IN2DISK           0.0        9.0   Input I model disk unit #
IN3NAME                            Input Q model name (name)
IN3CLASS                           Input Q model name (class)
IN3SEQ            0.0     9999.0   Input Q model name (seq. #)
IN3DISK           0.0        9.0   Input Q model disk unit #
IN4NAME                            Input U model name (name)
IN4CLASS                           Input U model name (class)
IN4SEQ            0.0     9999.0   Input U model name (seq. #)
IN4DISK           0.0        9.0   Input U model disk unit #
IN5NAME                            Input V model UV (name)
IN5CLASS                           Input V model UV (class)
IN5SEQ            0.0     9999.0   Input V model UV (seq. #)
IN5DISK           0.0        9.0   Input V model disk unit #
SRCNAME                            Source to calibrate with
SUBARRAY          0.0     1000.0   Subarray, 0=>1
                                   Cal. info for input:
DOCALIB          -1.0      101.0   > 0 calibrate data & weights
                                   > 99 do NOT calibrate weights
GAINUSE                            CAL table to apply.
                                   CLEAN map (optional)
FLAGVER                            Flag table version
DOBAND           -1.0       10.0   If >0 apply bandpass cal.
                                   Method used depends on value
                                   of DOBAND (see HELP file).
BPVER                              Bandpass table version
DOPOL            -1.0       10.0   If >0 correct polarization.
PDVER                              PD table to apply (DOPOL>0)
SMOOTH                             Smoothing function. See
                                   HELP SMOOTH for details.
OUTVERS                            Output BD table version
                                      <0 -> none, 0 -> new
OUTNAME                            Output UV data name (name)
OUTCLASS                           Output UV data name (class)
OUTSEQ                             Output UV data name (seq)
OUTDISK                            Output UV data disk unit #
BADDISK                            Disk to avoid for scratch
P_DEBUG                            > 0 -> inquire at each task
                                   < 0 -> delete temp files

HELP SECTION

BLPOLCAL
Procedure:  It makes matching model data sets in I, Q, U, and,
            optionally, V polarization with SPLIT and UVSUB.  Then it
            divides a circular polarization model into the RR/LL/RL/LR
            input data and solves for the time average.  It applies
            these baseline-polarization-channel multiplicative
            corrections to the input data and saves them in a BD table.

            The input images should contain Clean Component files for
            computing the Stokes model visibilities.
Adverbs:
  INNAME.....Input UV file name (name).      Standard defaults.
  INCLASS....Input UV file name (class).     Standard defaults.
  INSEQ......Input UV file name (seq. #).    0 => highest.
  INDISK.....Disk drive # of input UV file.  0 => any.
  IN2NAME....Input I image name (name).       Standard defaults.
  IN2CLASS...Input I image name (class).      Standard defaults.
  IN2SEQ.....Input I image name (seq. #).     0 => highest.
  IN2DISK....Disk drive # of input I image.   0 => any.
  IN3NAME....Input Q image name (name).       Standard defaults.
  IN3CLASS...Input Q image name (class).      Standard defaults.
  IN3SEQ.....Input Q image name (seq. #).     0 => highest.
  IN3DISK....Disk drive # of input Q image.   0 => any.
  IN4NAME....Input U image name (name).       Standard defaults.
  IN4CLASS...Input U image name (class).      Standard defaults.
  IN4SEQ.....Input U image name (seq. #).     0 => highest.
  IN4DISK....Disk drive # of input U image.   0 => any.
  IN5NAME....Input V UV model name (name).       Standard defaults.
                only if not blank
  IN5CLASS...Input V UV model name (class).      Standard defaults.
  IN5SEQ.....Input V UV model name (seq. #).     0 => highest.
  IN5DISK....Disk drive # of input V UV model.   0 => any.
  SRCNAME....Calibration source name.  Must specify if INNAME is a
             multi-source data set.
  SUBARRAY...Subarray number to use. 0 => 1.  can only do one at a
             time.
  DOCALIB....If true (>0), calibrate the data using information in the
             specified Cal (CL) table for multi-source or SN table for
             single-source data.  Also calibrate the weights unless
             DOCALIB > 99 (use this for old non-physical weights).
  GAINUSE....version number of the CL table to apply to
             multi source files or the SN table for single
             source files.  0 => highest.
  FLAGVER....Specifies the version of the flagging table to be
             applied. 0 => highest numbered table.  <0 => no flagging
             to be applied.
  DOBAND.....If true (>0) then correct the data for the shape of the
             antenna bandpasses using the BP table specified by BPVER.
             The correction has five modes:
             (a) if DOBAND=1 all entries for an antenna in the table
             are averaged together before correcting the data.
             (b) if DOBAND=2 the entry nearest in time (including
             solution weights) is used to correct the data.
             (c) if DOBAND=3 the table entries are interpolated in
             time (using solution weights) and the data are then
             corrected.
             (d) if DOBAND=4 the entry nearest in time (ignoring
             solution weights) is used to correct the data.
             (e) if DOBAND=5 the table entries are interpolated in
             time (ignoring solution weights) and the data are then
             corrected.
  BPVER......Specifies the version of the BP table to be applied if
             DOBAND > 0.  0 => highest numbered table.
             <0 => no bandpass correction to be applied.
  BADDISK....Disk drives to avoid for scratch files.
  DOPOL......If > 0 then correct data for instrumental polarization as
             represented in the AN or PD table.  This correction is
             only useful if PCAL has been run or feed polarization
             parameters have been otherwise obtained.  See HELP DOPOL
             for available correction modes: 1 is normal, 2 and 3 are
             for VLBI.  1-3 use a PD table if available; 6, 7, 8 are
             the same but use the AN (continuum solution) even if a PD
             table is present.
  PDVER......PD table to apply if PCAL was run with SPECTRAL true and
             0 < DOPOL < 6.  <= 0 => highest.
  SMOOTH.....Specifies the type of spectral smoothing to be applied to
             a uv database . The default is not to apply any smoothing.
             The elements of SMOOTH are as follows:
             SMOOTH(1) = type of smoothing to apply: 0 => no smoothing
               To smooth before applying bandpass calibration
                 1 => Hanning, 2 => Gaussian, 3 => Boxcar, 4 => Sinc
               To smooth after applying bandpass calibration
                 5 => Hanning, 6 => Gaussian, 7 => Boxcar, 8 => Sinc
             SMOOTH(2) = the "diameter" of the function, i.e. width
               between first nulls of Hanning triangle and sinc
               function, FWHM of Gaussian, width of Boxcar. Defaults
               (if < 0.1) are 4, 2, 2 and 3 channels for SMOOTH(1) =
               1 - 4 and 5 - 8, resp.
             SMOOTH(3) = the diameter over which the convolving
               function has value - in channels.  Defaults: 1,3,1,4
               times SMOOTH(2) used when input SMOOTH(3) < net
               SMOOTH(2).
  OUTVERS....BD table output version. <0 => do not write one.
             0 => write a new one.  = N > 0 => add to version N.
  OUTNAME....Output UV file name (name).     Standard defaults.
  OUTCLASS...Output UV file name (class).    Standard defaults.
  OUTSEQ.....Output UV file name (seq. #).   0 => highest unique
  OUTDISK....Disk drive # of output UV file. 0 => highest w room
  P_DEBUG....> 0 => show the inputs for each task before running the
                    task and ask if you want to stop (answer 0) or
                    simply go on (anything else)
             < 0 => Clean out all data sets made during the procedure.

EXPLAIN SECTION


AIPS