Content-type: text/html Manpage of calflag

calflag

Section: User Commands (1)
Index Return to Main Contents
 

NAME

calflag - Display raw calibration data with user interaction  

CATEGORIES

calibration  

PERSON RESPONSIBLE

pjt  

DESCRIPTION

CALFLAG is a MIRIAD task which displays the raw calibration data and optionally a fit. CALFLAG reads the data and fit from a ``gcal'' file and displays the result graphically. The phases and amplitudes for both sidebands and all baselines are simultaneously shown, but individual plots or groups of plots can be zoomed. The fit is displayed as a line over the points, and all the axes are labeled, with ticks. The user may interactively pick different plots to zoom on, and can mark individual points as good or bad. Breakpoints in time can be added and deleted as well. To make new polynomial fits, the program CALFIT has to be rerun, possibly by using ``DELHD IN=file/PDATA'' to remove a bad polynomial fit.

    Commands in cursor mode are:

      d/D -- flag the nearest point as bad (uppercase only one band)
      a/A -- flag the nearest point as good (uppercase only one band)
      x   -- zoom/unzoom toggle on the current column
      y   -- zoom/unzoom toggle on the current row
      z   -- zoom/unzoom toggle on the current plot
      b/B -- insert breakpoint (uppercase only one band)
      c/C -- delete breakpoint (uppercase only one band)
      +/- -- moving around in zoom mode
      q   -- quit (no save)
      e   -- exit (save flags and breakpoints if modifications done)
      ?   -- this help and redraw screen
 

PARAMETERS

gcal
Input calibration dataset produced by calmake. No default.
source
Source names to be selected. Default is all sources selected.
flags
Use flags for scaling? If set to false, all points are selected for viewing, including the ones previously flagged bad. Default: true
close
Use closure? If set to true, closure will be applied to the phases, Also note that in closure mode breakpoints must be at the same time accross baselines. Default: false. Note: *** this mode is under development ***
taver
Taver consists of two numbers, TGAP and TTOT, both in minutes; they are used for vector averaging. If the time interval between any two successive data points is greater than TGAP, or if the total time between the first data point in a vector average and any succeeding data point exceeds TTOT, then a new vector average is started. The time-(X)-axis on top of your plot should be labeled in (UT) hours-minutes and seconds. The bottom is labelled in fractional days, offset from the date in the plot-header. Default: 0.0,1000.0 (no vector averaging)
device
This keyword is used to specify the plotting device. It uses the normal PGPLOT format of

  file/type

 or

  device/type

Usually there exists a default file name or device name. The part after the slash gives the plotter type. Examples of the type are:

  xs    X-windows output. This window is resizeable and
        persistent. Prepending a number allows you to use multiple
        windows, e.g. 1/xs, 2/xs etc.
  xd    X-windows output. A transient window that disappears
        when your task exists.
  ps    Postscript (landscape mode).
  vps   Postscript (portrait mode).
  cps   Color postscript (landscape mode).
  gif   gif files. Only supported with g77, not gfortran.
  vcps  Color postscript (portrait mode).
  tek   Tektronix 4010 or equivalent.
  xterm Xterm window (better for simple plots over slow X links).

A `?' as device name generates a complete list of the recognized types (which will most likely vary from system to system).

Files created for hardcopy devices must be spooled to the printer separately. The command needed for this is site and device specific. No default.

reset
Reset all flags to true or false, or leave them alone. If set to 't' or 'f' all flags in the file are set as such. When a flag is set to false, it means it is marked as bad. If flags are reset, there is no further interaction possible, and the programs quits after the flags have been altered. This is a quick and dirty way to reset all flags in the calibration dataset. Default: not used.
clip
If used it is the clip value above which the gains (Jy/K) are flagged bad. Default: not used. Note: you can only use clip= in Jy/K units. See next keyword.
units
Units to work in. Options are: K, K/Jy, Jy/K. Note: since CALAPPLY assumes Jy/K any other units are nice to look at, but produce badly calibrated files. Default: Jy/K.
ampmax
If supplied, the amplitude scale is fixed from 0 to ampmax, otherwise autoscaling is done. Default is autoscaling.
phminmax
If supplied, the phases are plotted from phmin to phmax. Note that the units are degrees, though the plot is given in radians. Default is independent autoscaling in lower and upper sideband.


 

Index

NAME
CATEGORIES
PERSON RESPONSIBLE
DESCRIPTION
PARAMETERS

This document was created by man2html, using the manual pages.
Time: 18:35:38 GMT, July 05, 2011