- FDN, Retrieved Variable for Plot.
- FDN is the variable name
of the field to be plotted. It must be identical to the one
defined in the data descriptor.
Characters beyond the first 8 characters of the string are ignored.
Type: Character*8
Default: First field encountered in data file
- FNM, Data File Name.
- FNM is the pathname for the accessed datafile.
FNM must be set explicitly by the user.
Type: Character*80
Default: None; must be provided by the user
Slice specification for plot
- IPJ, Projection.
-
Selected projection for
horizontal plots.
Settings:
1 -> Cylindrical Equidistant
2 -> Polar Stereographic (Northern Hemisphere)
3 -> Polar Stereographic (Southern Hemisphere)
4 -> Lambert Conformal Conic
For lambert
5 -> Mollenweide-type (global plots only)
Type: Integer
Default: 1
- LAT, Latitude.
-
LAT selects the
latitude for the appropriate cross-sections and time series plots.
If the
specified latitude does not correspond to an actual grid point value for
the grid in use, the nearest grid point is used.
To match correctly the selected latitude with the grid point value,
the type of grid must be specified
with the keyword GEO (see description for GEO in Section 4.8).
Type: Integer
Default: First latitude in file.
- LON, Longitude.
-
LON selects the
longitude for the appropriate cross-sections and time series plots.
If the
specified longitude does not correspond to an actual grid point value for
the grid in use, the nearest grid point is used.
To match correctly the selected longitude with the grid point value,
the starting longitude must be specified
with the keywords
XG1 and
XG2.
Type: Integer
Default: First longitude in file
- LG1, West Longitude Limit.
-
LG1 defines
the western (left) longitude limit for horizontal plots, zonal cross-sections, and Hovmoller plots.
LG1 must lie between -180 degrees and 360 degrees and the difference
between LG2 and LG1 may not exceed 360 degrees (180 degrees for Lambert
conformal conic projections).
LG1 is defined in increments of 5 degrees. For all other relevant plot types
LG1 is interpreted as the western bound for zonal averaging when
AVG is set to 1.
Type: Real
Default: Nearest integer value to (XG1+XG2)/2 - [90 or 180] depending on the projection
- LG2, East Longitude Limit.
-
LG2 specifies
the eastern (right) longitude limit for horizontal plots, zonal cross-sections, and Hovmoller plots.
LG2 must lie between -180 degrees and 540 degrees and the difference
between LG2 and LG1 may not exceed 360 degrees (180 degrees for Lambert
conformal conic projections).
For polar stereographic
projections it is permissible to set
LG2= LG1 (the value of the
central meridian). Otherwise the central meridian is defined as the
mean of LG1 and LG2.
LG2 is defined in increments of 5 degrees. For all other relevant plot types
LG2 is interpreted as the eastern bound for zonal averaging when
AVG is set to 1.
Type: Real
Default: Nearest integer value to (XG1+XG2)/2 + [90 or 180] depending on the projection
- LSW, Latitude Pole Switch.
-
LSW allows the user
to reverse the plotting direction for meridional cross-sections.
Settings:
1 -> NP to SP cross-section
2 -> SP to NP cross-section
Type: Integer
Default: 0
- LT1, South Latitude Limit.
-
LT1 defines
the southern (bottom) latitude limit for horizontal plots, latitude-time series, and meridional cross-sections (right).
LT1 must lie between -90 degrees and 90 degrees and the difference
between LT2 and LT1 may not exceed 180 degrees (90 degrees for polar
stereographic and Lambert
conformal conic projections). Note that
LT1 is always
set to -90 for S.H. polar stereographic
projections.
LT1 is defined in increments of 5 degrees.
For all other relevant plot types
LT1 is interpreted as the southern bound for meridional averaging when
AVG is set to 1.
This parameter is ignored for Mollenweide-type projections.
Type: Real
Default: Same value as YG1 (0 degree for N.H. polar stereographics and Lambert conformal conic projections).
- LT2, North Latitude Limit.
-
LT2 specifies
the northern (top) latitude limit for horizontal plots, latitude-time series, and meridional cross-sections (left).
LT2 must lie between -90 degrees and 90 degrees and the difference
between LT2 and LT1 may not exceed 180 degrees (90 degrees for polar
stereographic and Lambert conformal conic projections).
Note that
LT2
is always set to 90 for N.H. polar stereographic
projections.
LT2 is defined in increments of 5 degrees.
For all other relevant plot types
LT2 is interpreted as the northern bound for meridional averaging when
AVG is set to 1.
This parameter is ignored for Mollenweide-type projections.
Type: Real
Default: Same value as YG2 (0 degree for S.H. polar stereographics and 80 degrees for Lambert conformal conic projections).
- MAV,Meridional Averaging.
- Meridional
averaging may
be used for the relevant cross-sections by setting the parameter MAV to
1. Depending on the type of grid
in use, the actual bounds may not correspond exactly to the specified
limits for the plot. The grid points closest to the selected
bounds are used so as to enclose the specified area.
The actual bounds used are written to
standard output.
If MAV is set to 1 and the limits are not specified
by the user, averaging will be performed for the entire
latitude circle.
Type: Integer
Default: 0
- PLV, "First" Pressure/Sigma Level.
-
PLV defines:
(1) the selected pressure/sigma level
for horizontal plots, Hovmoller plots, and latitude-time series;
Type: Real
Default: First pressure/sigma level found in data file
(2) the lowest pressure/sigma level to be retrieved for height-time series, meridional, and zonal
cross-sections.
Type: Real
Default: First pressure/sigma level found in data file
- PL2, Second Pressure/Sigma Level.
-
PL2 is the highest
pressure/sigma level to be retrieved for height-time series, meridional, and zonal cross-sections. For vector plots PL2 is the pressure level for the data associated with the second variable.
Type: Real
Default: Last pressure/sigma level found in data file; for vector plots: same as PLV
- TSP, "First" Time Step.
-
TSP defines:
(1) the selected time step for
horizontal plots, zonal and meridional cross-sections;
Type: Integer
Default: First time step found in data file
(2) the first time step to be used for
all time series plots.
Type: Integer
Default: First time step found in data file
- TS2, Second Time Step.
-
TS2 is the last time
step to be used for time series. For vector plots TS2 is the time step for
the data associated with the second variable.
Type: Integer
Default: Last time step found in data file; for vector plots: same as TSP
- TSW, Time Axis Switch.
-
TSW allows the user to reverse the plotting direction for Hovmoller plots.
Settings:
0 -> Time increasing from bottom to top
1 -> Time increasing from top to bottom
Type: Integer
Default: 0
- ZAV, Zonal Averaging.
- Zonal
averaging may
be used for the relevant cross-sections by setting the parameter ZAV to
1. Depending on the type of grid
in use, the actual bounds may not correspond exactly to the specified
limits for the plot. The grid points closest to the selected
bounds are used so as to enclose the specified area. For instance, if the
bounds 160E to 260E are given for a T42 gaussian grid, the grid points corresponding to longitudes
157.5E and 261.6E will be used. The actual bounds used are written to
standard output.
If ZAV is set to 1 and the limits are not specified
by the user, averaging will be performed for the entire
longitude circle.
Type: Integer
Default: 0
Plot and viewport scaling
- ASR, Aspect Ratio.
-
Scaling of the vertical
plot width relative to the horizontal plot width (not used for horizontal plots-
scaling is controlled by the projection). It may have a value larger than
1 as long as the size of the resulting window defined by the plot remains within the maximum dimension allowed for the frame. The aspect ratio is
computed after horizontal scaling
( HVS) has been performed.
Type: Real
Default: 1.0
- HVS, Horizontal Scaling.
-
Scaling of the horizontal
axis relative to the window width (not used for horizontal plots-scaling
is controlled by the projection). Its value must be 1.0 or less.
Type: Real
Default: 1.0
- RDF, Plot Reduction Factor.
-
Every object
is magnified or shrunk by the amount specified by RDF. It may
have a value larger
then 1 as long as the resulting window defined by the plot
is fully contained in the
viewport. Even so, too large a value may result in the title and/or
subtitles being clipped. EZPLOT always tries to fill the maximum useful
area defined by the window for the default aspect ratio, horizontal scale factor and number of plots per frame.
Therefore, a RDF value of 1.0 is adequate in most cases except, perhaps,
when more than one plot per frame is required.
Note that the magnification is
always performed after
ASR,
HVS, and
SLC have been set
and the
necessary resizing performed.
Type: Real
Default: 1.0
- SLC, Number of Plots per Frame.
-
Settings:
1 -> 1 plot per frame
2 -> 2 plots per frame
Type: Integer
Default: 1
- YDY, Multiplier for Vertical Separation Between Plots.
-
YDY controls the vertical separation between plots for
SLC=2. It causes
the nominal distance between plots to be multiplied by the
specified amount. Note that for horizontal plots
the size of each plot depends on the projection used and,
therefore,
the nominal vertical separation for limited-area plots
may not yield the best result.
The user may have
to experiment with different settings of YDY in order to select the best value
for his/her application.
Type: Real
Default: 1.0
Side panel attributes
- RNG,Multiplier of Incremental Value for Side Panel.
-
By default, the values given by the contour interval, contour low and
high
are used
to set the incremental value and bounds for the side panel.
RNG scales the contour interval up or down for use as an incremental
value (represented as a tick mark) on the side plot.
A corresponding increase or decrease in the range of values
displayed also occurs as a result.
Type: Real
Default: 1.0
- SPT, Side Panel Option Switch.
-
The side panel consists
of a line plot showing field values averaged along
the x-axis as a function of the y-axis. For
example, in the case of a global plot on a
cylindrical-equidistant projection, the side panel
would represent the zonal mean profile
running from pole to pole. All averages are based on
the (unsmoothed) values that are included within the
viewport (which may only show a
limited area). For horizontal plots,
the zonal average does not include values in masked
areas.
The side plot option is available for any cross-section, but not
for overlays.
Settings:
0 -> No side panel
1 -> Side panel enabled
Type: Integer
Default: 0
- YDM, Reference Value for Side Panel.
-
The default breakpoint value for the side panel is the same as that
defined by the demarcation contour for the contour plot. The user may
override this setting by choosing any arbitrary value as long as it
corresponds to a valid (scaled) incremental value.
Type: Real
Default: Same value as
CDM
Setting attributes for tick marks, labels, grid overlay
Labels are drawn for the left axis only, except
when the ordinate is height: pressure level labels are drawn on
the left side and geometric height labels are drawn on the right side.
- DTK, Tick Mark Orientation.
-
DTK specifies the direction for tick marks.
Settings:
0 -> Tick marks pointing outward
1 -> Tick marks pointing inward
Type: Integer
Default: 0
- GRD, Grid Overlay.
-
GRD turns on the grid overlay.
Grid lines coincide with labeled (major) tick marks.
Settings:
0 -> Grid off
1 -> Grid on
Type: Integer
Default: 1 (Lambert and Mollenweide projections); 0 for all other plot types.
- ITH, Tick Mark Positioning for Time Series.
-
The parameter ITH operates in conjunction with
ITP,
YRS, and
YRE.
For ITP=1, ITH defines the number of subdivisions between
major tick marks. YRS and YRE determine the value for the first and last
major tick marks. The first major tick mark is always positioned flush
with the left (top) edge while the position of the last major tick mark depends on the
total number of tick marks defined.
Labels are positioned between each major tick mark. For ITP=2
ITH is the incremental value on the time axis between each major
tick mark.
YRS and YRE determine the first and last time values on the axis.
Numeric labels (and major tick marks)
will be positioned at integer dividers of ITH
along the time axis while character labels will correspond to the next
closest tick mark. This
scheme allows the first tick mark on the axis to be labeled when
YRS=1 (which is usually desired for character labels such as months).
For instance, let ITP=2, ITH=2, YRS=82, YRE=90.
The labels 82, 84, 86, 88, and 90 will be centered under each
major tick mark with one minor tick mark in between (the increment is
2).
By substituting ITP=1,
the labels 82, 83, 84, ..., 90 will be located between major divisions while each minor tick mark will
correspond to the six-month mark.
Type: Integer
Default: Variable
- ITP, Location of Time Step Labels.
-
ITP is the positioning of labels for time series plots only.
Settings:
0 -> Tick mark and label drawing disabled
1 -> Between major divisions (i.e. major tick marks)
2 -> Centered under major divisions (i.e. major tick marks)
Type: Integer
Default: 2
- LBT, Increment for Latitude Labels.
-
The smallest increment for latitude labels (and major tick marks)
is 5 degrees. Tick marks are drawn every 10 degrees for a label
spacing of 30 degrees or more. Otherwise, they are drawn every 5 degrees.
To minimize interference with plot features, latitude labels are not drawn
on polar stereographic projections. To disable tick mark and label drawing, set LBT to 0.
For Lambert conformal projections, LBT is ignored and the increment for
both latitude and longitude labels is determined by
LBG only.
To disable tick mark and label drawing, set LBT to 0.
Type: Integer
Default: 30
- LBG, Increment for Longitude Labels.
-
The smallest increment for longitude labels (and major tick marks)
is 5 degrees.
Tick marks are drawn every 10 degrees for a label
spacing of 30 degrees or more. Otherwise, they are drawn every 5 degrees.
To disable tick mark and label drawing, set LBG to 0.
Type: Integer
Default: 30
- LBH, Increment for Height Labels.
-
The smallest increment for height labels (and major tick marks)
is 2 kilometers.
Tick marks on the height axis are drawn every 2 kilometers.
To disable tick mark and label drawing, set LBH to 0.
Type: Integer
Default: 2
- TLB, Type of Time Step Labels.
-
TLB is the type of labels for time series plots.
Valid options are character strings for months (abbreviated as 1 or 3 uppercase
characters) or numeric values (for hours, days, years).
Settings:
0 -> month (1 letter abbreviation)
1 -> month (3 letter abbreviation)
2 -> numeral
Type: Integer
Default: 2
- YRE, Last Time Step Label.
-
YRE defines the value of the last time value
( ITP=2) or label (ITP=1) for time series plots.
For numerals the maximum allowable value is 999.
If character strings are used for months, an integer value corresponding
to the month index (which may be greater than 12) should be entered.
Type: Integer
Default: Last time step defined for plot
- YRS, First Time Step Label.
-
YRS defines the value of the first time value
( ITP=2) or label (ITP=1) for time series plots.
If character strings are used for months an integer value corresponding
to the month index (1-12) must be entered. A value of 0 is acceptable
for numerals.
Type: Integer
Default: 1
- XIN, Incremental Value for X-Axis Labels.
-
For xy contour plots XIN is the incremental value for major tick marks
and labels along the x-axis. The major tick marks and labels are
drawn at integer multiples of XIN along the axis. For instance, if
XMN has a value of 0.5
and XIN is set to 0.2, the first label will be drawn at a value corresponding
to 0.6 on the axis and for every increment of 0.2 thereafter.
Type: Real
Default: depends on the values of XMN and XMX
- XMN, Minimum value for X-axis.
-
For xy contour plots XMN sets the value for the beginning of the x-axis.
The absolute value of XMN must be less than 10000.
Type: Real
Default: Same as XG1
- XMX, Maximum value for X-axis.
-
For xy contour plots XMX sets the value for the end of the x-axis.
The absolute value of XMX must be less than 10000.
Type: Real
Default: Same as XG2
- XTK, Incremental Value for Minor Tick Marks Along the X-axis.
-
For xy contour plots XTK is the incremental value for minor tick marks
along the x-axis. Minor tick marks are
drawn at integer multiples of XIN along the axis. For instance, if
XMN has a value of 3.5
and XTK is set to 1.0, the first minor tick mark will be drawn at a value corresponding
to 4.0 on the axis and for every increment of 1.0 thereafter.
Type: Real
Default: Same as XIN
- YIN, Incremental Value for Y-Axis Labels.
-
For xy linear plots YIN is the incremental value for major tick marks
and labels along the y-axis. The major tick marks and labels are
drawn at integer multiples of YIN along the axis. For instance, if
YMN has a value of 0.5
and YIN is set to 0.2, the first label will be drawn at a value corresponding
to 0.6 on the axis and for every increment of 0.2 thereafter.
Type: Real
Default: depends on the values of YMN and YMX
- YMN, Minimum value for Y-axis.
-
For xy linear plots YMN sets the value for the beginning of the y-axis.
The absolute value of YMN must be less than 10000.
Type: Real
Default: Same as YG1
- YMX, Maximum value for Y-axis.
-
For xy linear plots YMX sets the value for the end of the y-axis.
The absolute value of YMN must be less than 10000.
Type: Real
Default: Same as YG2
- YTK, Incremental Value for Minor Tick Marks Along the Y-axis.
-
For xy linear plots YTK is the incremental value for minor tick marks
along the y-axis. Minor tick marks are
drawn at integer multiples of YIN along the axis. For instance, if
YMN has a value of 3.5
and YTK is set to 1.0, the first minor tick mark will be drawn at a value corresponding
to 4.0 on the axis and for every increment of 1.0 thereafter.
Type: Real
Default: Same as YIN
Scaling of the time axis
- NTS, Number fo Time Steps Defined by Grid.
-
NTS is the number of time steps defined by the entire grid (which may
be different from the number of time steps defined by the plot). This
control parameter in conjunction with
TP1 and
TPN positions the plot
within the "box" defined by the grid. Thus, it is possible to
generate plots which do not fill the entire "box". For instance, if a time series
contour plot of the period January 1982---October 1991 is to be
generated, it may be desirable to define a full "box" spanning
January 1982-December 1991 and leave a small blank strip for the months
of November and December, which do not have data. This approach may be
useful for comparative purposes when the horizontal scale is to be
preserved for time series of varying lengths. Alternately, one may
use the parameter HVS to shrink the "box" to fit the plot exactly.
Type: Integer
Default: 1000
- TP1, Grid Index for First Time Step.
-
TP1 is the grid index corresponding to the beginning of the plot (time series only).
See description for the parameter
NTS.
Type: Integer
Default: 1
- TPN, Grid Index for Last Time Step.
-
TPN is the grid index corresponding to the end of the plot (time series only).
See description for the parameter
NTS.
Type: Integer
Default: Value for NTS
Setting color and pattern fill attributes
EZPLOT recognizes 9
primary colors
and any combination thereof:
- 1. white
- 2. magenta
- 3. red
- 4. green
- 5. cyan
- 6. blue
- 7. yellow
- 8. black
- 9. gray
Any intermediate color shade can be obtained by using a combination of the
primary colors to form a new integer. For instance, if orange contours are desired, the combination
37 should be
used. Up to 9 colors can be mixed to obtain various
shades. Some examples are given below:
- light pink-> use 113
- 2. dark green-> use 48
- 3. darker green-> use 488
- 4. slate gray-> use 188
- etc...
- BGD, Background Color.
-
BGD selects standard or reverse video for the background.
Settings:
0 -> Reverse video (black)
1 -> Standard video (white)
Type: Integer
Default: 1
- CAB, Color Combination Index for Contours Above Demarcation Contour.
-
For standard contour plots
( ITY=0), this is the color of
the contours above the primary demarcation contour; for pattern fill (stipple/hatching) plots
( ITY=1), this is the color of
the contours and pattern fill above the secondary demarcation contour.
For solid fill plots (ITY=3),
this is the color of the solid fill above the secondary demarcation contour.
See the rules for combining colors at the beginning of this section.
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- CBL, Color Combination Index for Contours Below Demarcation Contour.
-
For standard contour plots
( ITY=0), this is the color of
the contours below the primary demarcation contour; for pattern fill (stipple/hatching) plots
( ITY=1), this is the color of
the contours and pattern fill below the primary demarcation contour.
For solid fill plots ( ITY=3),
this is the color of the solid fill below the primary demarcation contour.
See the rules for combining colors at the beginning of this section.
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- CBR, Color Bar Offset Multiplier.
-
CBR modifies the default offset between the color bar and the bottom
of the plot (horizontal bar), or the right edge of the plot
(vertical bar).
Type: Real
Default: 1.0
- CDR, Color Combination Index for Demarcation Contours.
-
CDR specifies the color of both the primary and secondary demarcation contours.
Settings:
1-9 -> Color Index
Type: Integer
Default: Value for CFR
- CFR, Color Combination Index for Frame and Labels.
-
CFR specifies the color for the perimeter of the plot,
grid overlay, tick marks, labels, title, and subtitles. If CGR is set (color for the grid overlay), it overrides the CFR setting.
See the rules for combining colors at the beginning of this section.
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- CGR, Color Combination Index for Grid.
-
CGR specifies the color for the grid overlay.
For polar stereographics projections CGR also controls the color of
the tick marks and labels for the latitude circles since they are located within the
plot perimeter.
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- CMG, Color Combination Index for Special Value Areas.
-
See the rules for combining colors at the beginning of this section.
\hfil\break
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- CNT, Color Combination Index for Ocean/Continent Fill.
-
See the rules for combining colors at the beginning of this section.
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- COC, Color Combination Index for Continent Outline.
-
See the rules for combining colors at the beginning of this section.
Settings:
1-9 -> Color Index
Type: Integer
Default: Background color complementary
- CPL, Color Spectrum for Palette.
-
The parameters CPL and
INC control the appearance of color fill plots
by selecting the number and shade intensity of the color components (elements) defined
in the color table. INC sets the number of color elements in the table. It is usually determined by the expected maximum number of contours. CPL is
a combination index analogous to that used to define the color
of individual objects. However, instead of mixing color intensities to
form a new color, CPL defines the color palette for the plot. Up to
9 primary color components can be combined to generate the palette. For instance, an index of 63 defines a blue-red palette. A few more examples are:
- blue-white-red->use 613 (default)
- rainbow-> use 2654738
- etc...
Another important consideration is the positioning of the
color palette against the set of all contour intervals for a given
plot. In the case of a blue-white-red spectrum, one would normally
want the blue and red portions of the spectrum
to correspond, say, to areas defining values
below and above zero respectively.
If negative and positive contour intervals are evenly spread abound
the center, this does not present a problem.
However, if the range is asymmetric with more negative contour
intervals than
positive ones, one can ``slide'' the color palette against the
ordered set of contour intervals by
setting the primary demarcation contour explicitly to 0 (see description for
CDM).
The maximum number of color elements allowed
for a solid fill color plot is 26, or 13 on each side of the primary demarcation
contour.
If there are less contour intervals than color components defined,
then only a proportional fraction of the color table is used.
On the other hand, if there are not enough color components for all
defined contour intervals, then the last color component at that end
of the table is used.
When the demarcation contour is set to a value beyond the range
of the data, the
center of the palette and middle contour will be closely lined up.
Additional information on the joint
use of INC and CPL is given in the description for
INC.
Settings:
1-8 -> Color combination index for spectrum
Type: Integer
Default: 613
- CVC, Color Combination Indec for Vectors.
-
See the rules for combining colors at the beginning of this section.
Settings:
1-9 -> Color combination index for vectors
Type: Integer
Default: Background color complementary
- DSC, Density of Ocean/Continent Fill.
-
DSC is the spacing between lines or dots for the pattern fill
SHC.
The value of DSC causes the default spacing of 0.004 inch to
be multiplied by the specified amount.
Type: Real
Default: 1
- DSH, Dash Pattern for Contours Below Demarcation.
-
DSH specifies a particular dash pattern below the primary demarcation
contour. A value of 0 turns off the drawing of all contours below
the primary demarcation contour.
Settings:
Click icon for a view of dash patterns available
Type: Integer
Default: 5 (for pattern- or solid-fill contour plots); 13 (for line contour plots below demarcation contour)
- DH2, Dash Pattern for Contours Above Demarcation.
-
DH2 specifies a particular dash pattern above the secondary demarcation
contour. A value of 0 turns off the drawing of all contours above
the secondary demarcation contour.
Settings:
Click icon for a view of dash patterns available
Type: Integer
Default: 5
- DSR, Dash Pattern for Demarcation Contours.
-
DSR specifies a particular dash pattern for both the primary and secondary demarcation contours (if applicable).
A value of 0 turns off the drawing of the demarcation contours.
Settings:
Settings:
Click icon for a view of dash patterns available
Type: Integer
Default: 5
- DST, Pattern Fill 1 Density Multiplier.
-
DST is the spacing between lines or dots for the pattern fill
determined by
SHD.
The value of DST causes the default spacing of 0.004 inch to
be multiplied by the specified amount.
Type: Real
Default: 1.
- DS2, Pattern Fill 2 Density Multiplier.
-
DS2 is the spacing between lines or dots for the pattern fill
determined by
SH2.
The value of DS2 causes the default spacing of 0.004 inch to
be multiplied by the specified amount.
Type: Real
Default: 1.
- IFC, Mask Option for Ocean/Continent Fill.
-
IFC specifies whether a mask is to be applied to the specified ocean/continent
fill.
Note that options 3 and 4 below have a slightly different meaning for
black-and-white plots. Option 3 selects a hollow fill
while option 4 selects a black solid fill which is normally
well rendered by high-resolution printers.
IFC operates in conjunction with
OCM
to determine which areas are to be filled.
Settings:
1 -> Pattern fill with mask
2 -> Pattern fill with no mask
3 -> Solid fill with mask
4 -> Solid fill with no mask
Type: Integer
Default: 3
- INC, Number of Color Cells for Palette.
-
INC determines the number of color elements defining the
color palette. The number of elements has to be at least as large as the
number of primary color components defining the color palette
(given by CPL),
but may not be larger than 26. Color shade and intensity for each
element of the color table is interpolated between the primary components.
Depending on the relationship between
the number of primary components and the size of the desired color table,
full intensity for one or more of the primary colors may
fall in between color elements.
This is not usually a problem for, say, a smooth blue-white-red spectrum
which must be symmetrical about the demarcation contour. In this case,
the full intensity for white is never achieved; instead we find a very light shade of
blue and read immediately to the left and right
of the demarcation contour respectively.
To ensure that the full intensity for each primary color component is included in
the color table, the user should
set the number of color elements
INC to CPL+n(CPL-1) where n is
the interpolation level (1,2,3, etc) and
CPL
is the number of primary
components declared.
Type: Integer
Default: 16
- ITY, Type of Contour Fill.
-
ITY is used to select the type of fill to be applied to a contoured
region.
Settings:
0 -> Dashed Contours below primary demarcation contour (can be overridden by user)
1 -> Pattern fill below primary demarcation contour and above secondary demarcation contour
2 -> Solid color fill for entire plot (using color palette)
3 -> Solid fill below primary demarcation contour and above secondary demarcation contour
Type: Integer
Default: 0
- LBB, Positioning Mode for Color Bar Labels.
-
The parameter LBB is used to modify the positioning mode for the color bar
labels.
A value of 1 (default) places the labels
between adjacent color boxes, while a value of 2
lines up the label with the center of the box. The centering option
causes the labels to be pushed to the right by one-half the
width of a color box; hence, the leftmost box is dropped as a result.
This is especially
useful for fields described by categorical values (e.g. 0,1,2, etc).
Settings:
1 -> Between color boxes
2 -> Center of color boxes
Type: Integer
Default: 1
- OCB, Orientation of Color Bar.
-
The color bar takes the place of the informational label for color
fill plots.
Settings:
1 -> Horizontal (below plot)
2 -> Vertical (right of plot)
3 -> Vertical (common to both plots for SLC=2)
Type: Integer
Default: 1
- OCM, Fill Option for Ocean/Continent.
-
OCM selects the type of area to be filled with
IFC.
Settings:
1 -> Ocean Fill
2 -> Continent Fill
3 -> No Fill
Type: Integer
Default: 3
- OTL, Dash Pattern for Continent Outline.
-
Settings:
0 -> No outline drawn
1 -> Solid, simple thickness
2 -> Dotted, simple thickness
3 -> Solid, double thickness
4 -> Dotted, double thickness
Type: Integer
Default: 1
- PCL, Black-and-White / Color Plot Switch.
-
Settings:
0 -> Black-and-White
1 -> Color
Type: Integer
Default: 0
- SCO, Type of Outlines.
-
Settings:
0 -> Simplified continental outlines
1 -> Standard continental outlines
2 -> Standard continental outlines and political boundaries (including U.S. states)
Type: Integer
Default: 1
- SHC, Type of Pattern Fill for Ocean/Continents.
-
SHC determines the type of shading to be used for ocean areas
( OCM=1) or
continental masses
( OCM=2).
Note that stippling (dot patterns) is generally more
computer intensive than hatching and increases the graphics metafile size
significantly.
Settings:
1 -> Hatching
2 -> Stippling
Type: Integer
Default: 1
- SHD, Type of Pattern Fill 1 for Contours.
-
SHD determines the shading to be applied below
the primary demarcation contour. See the description for
CDM.
Note that stippling (dot patterns) is generally more
computer intensive than hatching and increases the graphics metafile size
significantly.
Settings:
1 -> Hatching
2 -> Stippling
Type: Integer
Default: 1
- SH2, Type of Pattern Fill 2 for Contours.
-
SH2 determines the shading to be applied above the secondary demarcation
contour. See the description for
CD2.
Note that stippling (dot patterns) is generally more
computer intensive than hatching and increases the graphics metafile size
significantly.
Settings:
1 -> Hatching
2 -> Stippling
Type: Integer
Default: 2
- WTH, Line Thickness Multiplier.
-
WTH controls the thickness of any line or character drawn on the plot,
except those relating to continental outlines and fill (the parameter
OTL should be used to control line thickness for those).
It causes the preset value to be multiplied by the specified amount.
A value of 1 is generally adequate for plots displayed on a workstation
or routed to a Sparc Printer or Laser Writer. For color plots downloaded
to a color printer, a value of 2 will yield better results.
Type: Integer
Default: 1
Vector plot options
Vector plots are possible for all three projections.
The parameter
CVC
controls the color setting for vectors.
- FD2, Second Variable Retrieved for Vectors.
-
The second variable for the vector field must be specified
with FD2.
Type: Character*8
Default: Required input
- FN2, Second File Retrieved for Vectors.
- FN2 is the pathname for the accessed datafile containing the second variable.
Type: Character*80
Default: File given by FNM
- GDV, Spacing Between Vectors.
-
GDV is the grid point spacing between plotted vectors.
A value of 1, for instance, generates a vector for every grid point;
a value of 2, for every second grid point, etc. In the case of
polar stereographic projections an algorithm has been implemented to
reduce vector crowding at higher latitudes. The algorithm attempts
to preserve the vector density at all latitudes.
Type: Integer
Default: 2
- LSV, Magnitude of Reference Vector.
-
If LSV=0., the longest vector computed from the data will
correspond to a fixed length of
approximately 0.4 inch on the plot regardless of the size of the plot
(this length is shown by the
scaling vector).
If LSV > 0., the value of LSV corresponds to a fixed length of
approximately
0.4 inch on the plot.
In the case where overlap is a problem, the size of the vectors on
the plot can be scaled down
by setting LSV to a value larger than
the expected magnitude of the longest vector.
Type: Real
Default: 0.
- SC2, Second Scale Factor Retrieved for Vectors.
-
SC2 scales the data associated with the second variable by the specified value.
However, the scaling of the magnitudes (for the associated contour plot) is controlled by
SCF .
Only one significant digit is allowed for the scale factor.
For example, the values 0.1, 20., or 5.e6 are valid scale factors,
whereas
the values 15., 2.5e-2, or 0.45 are not.
Type: Real
Default: Same as SCF
- VEC, Vector Option Switch.
-
Vector plots are possible for horizontal plots, and zonal and meridional
cross-sections only. If contours for the magnitudes are also drawn
(which is the default setting),
the vectors plotted represent smoothed values for the field (when
smoothing is turned on). If the no contour option is requested,
smoothing is not allowed.
Settings:
0 -> Vector off
1 -> Vector on
Type: Integer
Default: 0
- VHC, Vector High Cutoff Value.
-
Prevents vectors greater than the specified magnitude from appearing
on the plot.
Type: Real
Default: Largest magnitude encountered
- VLC, Vector Low Cutoff Value.
-
Prevents vectors smaller than the specified magnitude from appearing
on the plot.
Type: Real
Default: 0.
- VPO, Vector Positioning Mode Option.
-
VPO specifies the position of the vector arrow in
relation to the grid point location of the vector component data.
Settings:
0 -> The center of the vector arrow is placed at the grid point location
1 -> The head of the vector arrow is placed at the grid point location
2 -> The tail of the vector arrow is placed at the grid point location
Type: Integer
Default: 0
Dataset manipulation and mapping
Control parameters defined in this subgroup allow the user
to map the rectangular coordinate system
onto the desired grid. Bounds for partial grids can also be specified.
Data smoothing and scaling are
other possible options. Note that scaling and/or smoothing do not
alter the dataset. They are only used for plotting purposes.
- DNS, Dense Grid Option.
-
DNS forces EZPLOT to interpolate from an array of data on the original grid to an array of data
on a dense rectangular grid. The dense grid option is enabled automatically if the number of data points is less than 1500.
However, the user may always override the default option.
Settings:
0 -> Original grid
1 -> Dense grid
Type: Integer
Default: 0 (more than 1500 grid points); 1 (less than 1500 grid points)
- FG1, Scale Factor Selction Flag.
-
The scale factor option is used only for plotting purposes.
A setting of 0 will display the minimum and maximum values found in the
data and will prompt the user for a suitable scale factor.
Settings:
0 -> Scale factor SCF entered during execution
1 -> Use value in input file for scale factor
2 -> Data is scaled automatically by EZPLOT
Type: Integer
Default: 2
- GEO, Type of Grid.
-
GEO specifies the type of horizontal grid describing the dataset.
For a gaussian grid, the number of latitudes must be even.
Settings:
1 -> Regular grid
2 -> Gaussian grid
3 -> CSMX2 Ocean Grid (currently implemented for horizontal contour plots only)
Type: Integer
Default: 1
- MSG, Special Value.
-
MSG identifies missing or special values in the dataset.
Special values are preserved when smoothing is performed.
Type: Real
Default: 1.e36
- SCF, Scale Factor for Plot.
-
SCF scales the data by the specified value.
The scaling factor used for the plot
is drawn as part
of the units label IUN .
Only one significant digit is allowed for the scale factor.
For example, the values 0.1, 20., or 5.e6 are valid scale factors,
whereas
the values 15., 2.5e-2, or 0.45 are not.
Type: Real
Default: 1.
- STH, Smoothing Option.
-
For horizontal plots the user may select a
9-point smoother by setting STH=n where n is an integer of 1 through 9.
The smoother removes 2-delta waves
in each direction and is applied n times.
For time series plots STH is the filter to be
applied to each time series
used for the plot.
The number of coefficients must be odd and they must be
concatenated in the form of an integer.
For example, a 1-3-4-3-1 filter (low-pass filter that removes
2-delta waves) would be entered
as the integer 13431.
The maximum number of coefficients allowed is 7
and the value of each individual coefficients must be 9 or less.
Settings:
0 -> 0 Smoothing off
1 -> 9-point smoother (horizontal plots)
1-7 digit integer -> Filter to be applied for time series
Type: Integer
Default: 0
- XG1, First Longitude for Grid.
-
XG1 defines the western (left) longitude for grids.
XG1 must
lie between -180 degrees and 360 degrees and the difference
between XG2 and XG1 may not exceed 360 degrees.
Note that for xy contour plots, XG1 is used to specify the grid point
index for the left edge on the plot. The real value is then converted
to an integer which must be 1 or greater.
Type: Real
Default: 0.
- XG2, Last Longitude for Grid.
-
XG2 defines the eastern (right) longitude for grids.
XG2 must
lie between -180 degrees and 540 degrees and the difference
between XG2 and XG1 may not exceed 360 degrees.
Note that for xy contour plots, XG2 is used to specify the grid point
index for the right edge on the plot. The real value is then converted
to an integer which must be 1 or greater.
Type: Real
Default: 0.
- YG1, First Latitude for Partial Grid.
-
YG1 defines the bottom (southern) latitude for partial grids.
YG1 must
lie between -90 degrees and 90 degrees.
YG1 and YG2 should not be set if the grid spans exactly 180 degrees in
latitude.
Note that for xy contour plots, YG1 is used to specify the grid point
index for the bottom edge on the plot. The real value is then converted
to an integer which must be 1 or greater.
Type: Real
Default: -90.
- YG2, Last Latitude for Partial Grid.
-
YG2 defines the top (northern) latitude for partial grids.
YG2 must
lie between -90 degrees and 90 degrees.
YG1 and YG2 should not be set if the grid spans exactly 180 degrees in
latitude.
Note that for xy contour plots, YG2 is used to specify the grid point
index for the top edge on the plot. The real value is then converted
to an integer which must be 1 or greater.
Type: Real
Default: 90.
Title and subtitle drawing attributes
- ATF, Font Option for Annotations.
-
Settings:
1 -> Roman
2 -> Roman Large
3 -> Italic
4 -> Double-lined
5 -> Bold
6 -> Bold Large
Type: Integer
Default: 1
- BLB, Bottom Label.
-
For linear xy contour plots, it is possible to define a bottom label
which is placed
immediately below the bottom edge of the plot.
Type: Character*80
Default: Blank
- CLF, Font Option for Contour and High/Low Labels.
-
Settings:
1 -> Roman
2 -> Roman Large
3 -> Italic
4 -> Double-lined
5 -> Bold
6 -> Bold Large
Type: Integer
Default: 1
- GMN, Global Mean Option.
-
The computation of the weighted mean for the unsmoothed grid-point
values
can be requested for horizontal
plots only. However, the plot need not be global: the weighted mean will
also be computed for limited-area plots. This option is ignored for
overlays. At this time, the computation does not take into
consideration ocean or continent masking (i.e. the computation
is carried out as if there was no mask).
The global mean label is placed at the upper right-hand corner
of the plot window.
Settings:
0 -> Global (areal) mean is not computed
1 -> Global (areal) mean is computed and printed
Type: Integer
Default: 0
- ITL, Plot Title.
-
The main title is centered at the top of the plot.
The convention for subscripts, superscripts, and symbols is as given in
IUN .
Type: Character*80
Default: Blank
- IUN, Right Subtitle (Units).
-
The right subtitle is placed flush with the right edge of the plot.
This subtitle combines the plot scale factor and units for the plot.
The plot scale factor may be omitted by preceding the string with
an ampersand (&).
The symbol for
degrees can be obtained by inserting deg in the string.
Both subscripting and superscripting are available.
Superscript characters
must be enclosed with the colon (:) punctuation marks while subscripts must be enclosed
with the semi-colon (;) punctuation marks. For expressions containing both
superscripts and subscripts, a combination of semi-colon and colon punctuation marks can be used as shown in the example below:
2
A would be generated as follows: A:2:;3;
3
Spaces within an expression are no longer ignored for the unit label.
Additional symbols have been defined for the convenience of the user.
to get degrees use deg
to get the divergence operator use divg
to get the gradient operator use grad
to get the delta operator use delt
to get the partial derivative symbol use derv
to get the integral symbol use intg
to get the asterisk (star) symbol use star
to get the tilda symbol use tilda (following the
accented letter)
Blank spaces after the symbol are not necessary
For instance, partial dT/dt should be coded as dervT/dervt.
The greek alphabet is also available for commonly used symbols:
alpha greeka
beta greekb
chi greekc
delta greekd
epsilon greeke
phi greekf
gamma greekg
eta greekh
iota greeki
kappa greekk
lambda greekl
mu greekm
nu greekn
omicron greeko
pi greekp
theta greekq
rho greekr
sigma greeks
tau greekt
upsilon greeku
omega greekw
xi greekx
psi greeky
zeta greekz
For uppercase greek latters, use the corresponding uppercase roman
letter after "greek". For instance, uppercase psi would be coded
as greekY.
Type: Character*80
Default: Only the scale factor is drawn
- POS, Positioning of Subtitles.
-
Subtitles are normally positioned immediately above the plot perimeter.
However, POS allows the user to place subtitles below the plot on the
same line as the informational label.
This is especially useful for plot overlays when
a separate line is necessary to describe the base plot and overlay(s).
Each additional line will be placed below the preceding one.
However, care must be taken, for a center subtitle will be coincident
with the informational label which, if not previously turned off,
could result in an illegible label (see description for CMU in Section 4.10). For color plots,
subtitles placed below the plot are
always drawn in the same color as that defined by the current value
for CAB .
Rather long subtitles may overlap, especially when the
horizontal scale factor is less than 1.0. If all three
subtitles are used, it is recommended to keep the number of
characters for each label to 15 or less to avoid overcrowding.
Settings:
1 -> Subtitles placed above plot
2 -> Subtitles placed below plot
Type: Integer
Default: 1
- SB1, Left Subtitle.
-
The left subtitle is positioned flush with the left edge of the plot.
The convention for subscripts, superscripts, and symbols is as given in
IUN .
Type: Character*80
Default: Blank
- SB2, Center Subtitle.
-
The center subtitle is positioned midway between the left and right edge
of the plot.
The convention for subscripts, superscripts, and symbols is as given in
IUN .
Type: Character*80
Default: Blank
- SLB, Side Label.
-
For linear xy contour plots, it is possible to define a side label
which is placed
immediately to the left of the y-axis.
Type: Character*80
Default: Blank
Setting contour attributes
- CDM, Primary Demarcation Contour.
-
CDM is used to set the breakpoint
for pattern fills and the color table
midpoint for color fill plots (see descriptions for
ITY and
CPL ).
Type: Real
Default: 0.
- CD2, Secondary Demarcation Contour.
-
CD2 is used to set the upper
breakpoint
for the pattern or solid ( ITY =1,3). When in use, CD2 must be a valid contour level.
It is also possible to shade the interval between two contours
by setting CD2 to a value less than CDM .
Since CDM and CD2 control the shading below the primary and above
the secondary demarcation contours respectively, the resulting setting (CD2 < CDM) will fill the interval between the two contours with the desired
pattern. Note that the type of pattern/solid fill in this case is controlled
by
SHD /
CBL only.
SH2 /
CAB are ignored.
Type: Real
Default: 10000.
- CIB, Contour Minimum.
-
CIB is a required input when FG2 =1. The absolute
value of CIB must be 9999 or less.
This parameter is ignored for all other values of FG2.
Type: Real
Default: 0.
- CIH, Contour Maximum.
-
CIH is a required input when FG2=1.
The absolute value of CIH must be 9999 or less.
This parameter is ignored for all other values of FG2.
Type: Real
Default: 0.
- CIN, Contour Interval.
-
CIN is a required input when FG2=1,3.
This parameter is ignored for all other values of FG2.
The minimum and maximum values accepted by EZPLOT are 0.1 and
999 respectively. If the range in the data is such that
a contour interval smaller than 0.1 or larger than 999 is necessary,
then a different scale factor should
be selected to bring CIN within the limits.
Type: Real
Default: 0.
- CIU, Contour Use Flag.
-
If the contour use flag is preceded by the minus (-) sign,
edges for special value areas will not be drawn. Note: edges for
special value areas are never drawn on solid or patternu fill plots
(ITY=2,3).
Note that cell array plots (CIU=4) are available for horizontal
and time series plots only.
Settings:
1 -> Contours labeled
2 -> Contours neither drawn nor labeled
3 -> Contours not labeled
4 -> Contouring is not done; data is plotted as cell array
5 -> Same as CIU=1,3 but primary demarcation contour not drawn
Type: Integer
Default: 1
- CLN, Contour Label Interval.
-
CLN must be at least as large as
CIN and should be an integer multiple thereof.
Type: Integer
Default: depends on CIN
- CLU, High/Low Label Flag.
-
Settings:
0 -> High/Low not labeled
1 -> High/Low labeled
Type: Integer
Default: 0
- CMU, Information Label Flag.
-
CMU controls the information label and, if applicable, the
scaling vector label.
Settings:
0 -> Both information label and scaling vector off
1 -> Both information label and scaling vector (if applicable) on
2 -> Information label off and scaling vector (if applicable) on
3 -> Information label on and scaling vector (if applicable) off
Type: Integer
Default: 1
- FG2, Contour Level Selection Flag.
-
FG2 controls the selection of the contours for the plot.
The default value of 2 should be used if the range in the data is not
known a priori. For uneven contour spacing a setting of 4 will
prompt the user for each contour and a label flag.
A setting of 3
allows the user to select the contour interval while
the lowest and highest contour values are determined internally
from the range in
the data. Please note that the maximum number of contours that can
be generated for a given plot is 25. An error condition will occur
is the user attempts to define more than 25 contours.
Settings:
0 -> CIB,CIH,CIN,CLN entered during execution
1 -> Use values for CIB, CIH, CIN, CLN in input file
2 -> Select CIB, CIH, CIN, CLN automatically
3 -> Select CIB, CIH automatically but use values for CIN, CLN in input file
4 -> Each contour level entered interactively (keyboard entry)
Type: Integer
Default: 2
Position-specific EZPLOT control parameters
- ANP, Plot/Frame Advance Flag.
- ANP is a position
specific parameter. It must always be declared as the last control parameter
in each input sequence. A value of n sends a message to EZPLOT to
close GKS and deactivate and close the workstation after the plot defined
by the current input sequence has been drawn. A value of y tells EZPLOT
to read in the next input sequence for a new plot. A value of o means
that the next plot will be an overlay.
The user should be warned that all parameters are not necessarily
valid for
an overlay. For instance, if the parameter SLC
was used to select
2 plots
per frame in the
input sequence applicable to the base plot, attempting to redefine it
in the input sequence for the overlay will not work (it will be ignored).
The same consideration applies to the parameter ITY
since pattern or color fills cannot be used for overlays. In the latter
case, however, EZPLOT will exit with an error condition.
Settings:
y -> New plot request
n -> Close GKS
o -> Overlay request
Type: Character*1
Default: None; must be provided by the user
- IUT, EZPLOT Message Device.
-
IUT is a position specific
parameter. If in use, it must be declared as the first control parameter
at the beginning of the input file (first job step).
Settings:
0 -> all EZPLOT messages written on standard output
1 -> all EZPLOT messages written to file stdout
Type: Integer
Default: 0
- PRT, Print Option.
-
PRT allows the user to print the grid point values for the grid currently
being plotted. The values are written to
the file(s) prtout.x where x is the job deck number.
This option should be used for testing purposes only since values are
printed in ascii format which, depending on the size of the grid(s),
may cause disk storage problems. The user has full control on the format
of the values to be printed. The syntax is analogous to that
used in Fortran format statements, without the leading "f" or "i".
For instance, if integer values are desired (through truncation) with
a maximum of 4 spaces for each integer, a value of 4.0 should be used.
If one decimal place is required for a total field width of 6 digits,
then a value of 6.1 should be entered. All missing values are replaced
with the value 99.
Type: Real
Default: 0.0
- TYP, Type of contour/line plot.
-
The parameter TYP allows the user to bypass the menu and select
the type of plot desired. Option numbers are identical to those
displayed by the menu.
Settings:
1 -> latitude-longitude contour plot(s)
2 -> height-latitude contour plot(s)
3 -> height-longitude contour plot(s)
4 -> latitude-time contour plot(s)
5 -> height-time contour plot(s)
6 -> Hovmoller contour plot(s)
7 -> line plot(s)
8 -> arbitrary xy scaling contour plot(s)
Type: Integer
Default: menu is displayed
To the EZPLOT Home Page
Chris Guillemot:
chrisg@ncar.ucar.edu / Last modified: 12/5/96
Click icon for a view of dash patterns available