AIPS HELP file for WETHR in 31DEC25
As of Mon Feb 10 9:50:46 2025
WETHR: Task to plot selected contents of WX file.
INPUTS
INNAME UV data (name).
INCLASS UV data (class).
INSEQ 0.0 9999.0 UV data (seq. #). 0 => high
INDISK 0.0 9.0 Disk unit #. 0 => any
INVERS Input table file version no.
TIMERANG Time range to plot
ANTENNAS Antennas to plot 0=>all
SUBARRAY 0.0 90.0 Subarray 0 => all
PIXRANGE Range to plot: 0 => self
scale each antenna separately
NPLOTS 0.0 28.0 Number of plots per page
XINC 0.0 5000.0 Plot every XINC'th point
SMOOTH Smooth the data in time
OPTYPE Data to be plotted:
'TEMP','PRES','DEWP','WVEL',
'WDIR','WGUS','PREC','H2OC'
'IONC','RHUM','CH2O','KZOP',
'QZOP','WCOS','WSIN','DDEP'
'MULT' several/antenna
'FLAG' flag data instead
DOWEIGHT 0.0 1.0 Weight to assign to weather
in opacity
APARM List of parameters to be
plotted by # in order above
FLAGVER -1.0 Input flag file version
OUTFGVER 0.0 Output FG table version
BPARM Flag data above these values
for parameters in APARM
DETIME 0.0 Extend times by DETIME mins
FACTOR -10.0 10.0 Scale plot symbols by FACTOR
0 -> 1. < 0 -> connect points
LTYPE -410.0 410.0 Type of labeling: 1 border,
2 no ticks, 3 - 6 standard,
7 - 10 only tick labels
<0 -> no date/time
DOTV -1.0 1.0 > 0 Do plot on the TV, else
make a plot file
GRCHAN 0.0 88.0 Main graphics channel
+ 10 * label graphics chan
BADDISK Disks to avoid for scratch
HELP SECTION
WETHR
Type: Task
Use: Plots selected weather data versus time from a specified WX
table.
Adverbs:
INNAME.....UV file name (name). Standard defaults.
INCLASS....UV file name (class). Standard defaults.
INSEQ......UV file name (seq. #). 0 => highest.
INDISK.....Disk unit #. 0 => any.
INVERS.....Version number of table to plot, 0=>highest no.
TIMERANG...Time range of the data to be plotted. In order: Start day,
hour, min. sec, end day, hour, min. sec. Days relative to
reference date. If a start and stop time are given, then
all plots will be from the given start time to the given
stop time. Otherwise, the X-axis is plotted over the
range of X values found in the data. All plots in a
given execution will be on the same X scale in any case.
ANTENNAS...A list of the antennas to be plotted. All 0 => all. If any
number is negative then all antennas listed are NOT to be
plotted and all others are. Note that some WX tables do
not differentiate between antennas (that column is 0
meaning the same weather is associated with all
antennas). In this case the plot will be labeled "all
antennas" and this adverb ignored.
SUBARRAY...Restrict to subarray number SUBARRAY. 0 => no
restriction.
PIXRANGE...If PIXR(1) < PIXR(2), all plots will be from PIXR(1) to
PIXR(2). Otherwise each plot will be self-scaling.
NPLOTS.....Number of antennas/parameters to plot per page (try 5).
XINC.......Plot every XINC'th point, 0 => 1.
SMOOTH.....(1) = type of smoothing to apply:
0 => no smoothing
1 => Hanning
2 => Gaussian
3 => Boxcar
4 => Sinc (i.e. sin(x)/x)
5 - 8 => 1-4 as with uv data.
(2) = the "diameter" of the function in minutes, i.e.
full width between first nulls of Hanning triangle
and sinc function, FWHM of Gaussian, full width of
Boxcar. NO DEFAULT: 0 -> NO SMOOTHING.
(3) = the diameter over which the convolving function has
value - in minutes. Defaults: 1, 3, 1, 4 times
SMOOTH(2) used when input SMOOTH(3) < SMOOTH(2).
OPTYPE.....Data to be plotted:
1. 'TEMP' temperature in degrees Centigrade
2. 'PRES' Pressure in millibars
3. 'DEWP' Dew point temperature in degrees Centigrade
4. 'WVEL' Wind velocity in m/s
5. 'WDIR' Wind direction in degrees
6. 'WGUS' Wind gusts in m/s
7. 'PREC' Precipitation since midnight in cm
8. 'H2OC' H2O column in m^(-2)
9. 'IONC' Ionosphere column in m^(-2)
Computed values
10. 'RHUM' Relative humidity in per cent
11. 'CH2O' Computed H2O column in mm
12. 'KZOP' Zenith opacity at K band
13. 'QZOP' Zenith opacity at Q band
14. 'WCOS' Wind speed * cos (wind direction) - North
15. 'WSIN' Wind speed * sin (wind direction) - East
16. 'DDEP' Dew point depression = Temp - DewPoint
'MULT' several/antenna: plot without flagging
'FLAG' flag data instead: as MULT but flag instead of plot
DOWEIGHT...Used in OPTYYPEs CH20, KZOP, QZOP. The weight assigned to
current weather in the model (0 to 1). Weight 1-DOWEIGHT
is assigned to the seasonal model. DOWEIGHT <= 0 or > 1
changed to 0.5 as is the default in INDXR and FILLM.
APARM......List of parameters to be plotted by number shown above.
Used in MULT mode, first 0 stops list. For example,
NPLOTS=5; APARM=12,10,4,2,1 plots (from top to bottom)
optical depth, relative humidity, wind velocity, pressure
and surface temperature with one antenna per page.
FLAGVER....FG version copied to a new FG file before the weather
flags are appended. -1 => no copy, 0 => highest.
OUTFGVER...Flag table version to be used on output for both single-
and multi-source data sets. If OUTFGVER is <= 0 or
greater than FGmax (the previously highest FG version
number), then a new FG table will be created for the new
flags with version FGmax+1. This new table will also
contain the flags applied on input (if any) from FG
version FLAGVER. If OUTFGVER specifies a pre-existing FG
version, then the input flags are not copied even if
OUTFGVER and FLAGVER are not equal.
BPARM......If parameter APARM(i) is greater than BPARM(i), flag the
data. Absolute value is used for parameters 14, 15, and
16.
DETIME.....If the weather value is bad at time t1 through t2, the
data will be flagged from t1-DETIME through t2+DETIME.
DETIME is in minutes and <= 0 will default to 1/2 of the
interval between the first two points in the WX table.
FACTOR.....Scale plot symbols by FACTOR. 0 -> 1.
If FACTOR < 0, draw lines between the points and use
abs(FACTOR) to scale the points plotted.
If FACTOR > 0, values less than 0.1 are made 1.0.
If FACTOR < 0, abs(FACTOR) may be arbitrarily small
(making the points essentially disappear).
CUTOFF.....If >= 0, the task will examine the weight column of the
table and if the weight <= CUTOFF, the task will not plot
that sample. If = 0, will plot all good points; flagged
data are not plotted. CUTOFF is ignored for TY and PC
tables and OPTYPEs MDEL, ATM, GEO, and CCAL.
LTYPE......Labelling type, see HELP LTYPE for details:
1 = border, 2 = no ticks, 3 or 7 = standard, 4 or 8 =
relative to ref. pixel, 5 or 9 = relative to subimage
(BLC, TRC) center, 6 or 10 = pixels. 7-10 all labels
other than tick numbers and axis type are omitted.
Less than 0 is the same except that the plot file
version number and create time are omitted.
Add n * 100 to alter the metric scaling.
DOTV.......> 0 => plot directly on the TV device, otherwise make a
plot file for later display on one or more devices
(including the TV if desired).
GRCHAN.....Graphics channel (1 - 7) to use for line drawing.
A value of 0 causes more than one graphics channel to be
used. To specify a channel to be used for plot labels
add 10 * that graphics channel number. If the label
channel is zero, it is set to GRCHAN. See HELP GRCHAN
for additional discussion.
BADDISK....The disk numbers to avoid for scratch files (sorting
tables mostly).
EXPLAIN SECTION