SUBREGION LIMITS

...SUBREGION LIMITS

Plot Control Command

Specifies the limits (minimum and maximum) for subregions of subsequent plots.

Dataplot now supports subregions on plots. Subregions are motivated by the desire to denote "engineering limits" on a plot. That is, a rectangle, denoting an acceptance region in both the X and Y directions, is drawn and then the plot is overlaid on top of this.

Although the subregion capability was motivated for the purpose of denoting engineering limits, they can in fact be used for whatever purpose you want. Subregions apply to all subsequent 2-D plots (but not 3-D plots).

Currently, subregions are limited to rectangular regions. This will be upgraded to polygonal regions in a future implementation.

The SUBREGION command is used to turn subregions on or off and up to 10 subregions can be specified. In most cases where subregions are defined, only a single subregion is used.

SUBREGION <prefix>LIMITS <n1> <n2>
where
<n1> is a number or parameter that specifies the desired lower limit;
<n2> is a number or parameter that specifies the desired upper limit;
and <prefix> is one of the following:

X refers to vertical axis
Y refers to horizontal axis
no prefix refers to both axes.


This syntax sets the subregion limits for the first subregion.

SUBREGION <id> <prefix>LIMITS <n1> <n2> where
<id> is a number or parameter between 1 and 10 that specifies which of the 10 subregions that these limits apply to;
<n1> is a number or parameter that specifies the desired lower limit;
<n2> is a number or parameter that specifies the desired upper limit;
and <prefix> is one of the following:

X refers to vertical axis
Y refers to horizontal axis
no prefix refers to both axes.

SUBREGION LIMITS 0.5 4.5
SUBREGION XLIMITS 0 100
SUBREGION YLIMITS 0 100
SUBREGION XLIMITS A B
SUBREGION 2 LIMITS 0.5 4.5

You do not need to adjust the settings for the CHARACTER, LINE, BAR, and SPIKE when using subregions. DATAPLOT automatically shifts these in the background. The attributes for the subregion are set with the following commands:
REGION FILL
REGION COLOR
REGION BORDER LINE
REGION BORDER COLOR


The REGION FILL and REGION COLOR determine the attributes of the interior of the rectangle. The two most common choices are to leave it blank or to fill it with some type of light gray scale color. The attributes of the rectangle border are set with the REGION BORDER LINE and REGION BORDER COLOR commands. The standard line types (SOLID, BLANK, DASH, DOTTED) are supported. If you have more than one subregion defined, you should specify multiple settings on the above commands. For example,

REGION FILL ON ON ON
REGION COLOR G25 G25 G25

The SUBREGION ...LIMITS command with no argument reverts the limits to the default. A SUBREGION ...LIMITS command with no prefix refers to both axes. Thus SUBREGION LIMITS 3 7 sets the limits for both axes to 3 and 7.

No subregions are drawn. If a subregion is turned on, but no limits are specified, then the subregion extends to the minimum and maximum points in both the X and Y axes.

None

PLOT	= Generates a data or function plot.
SUBREGION	= Specifiy whether a subregion is on or off.

Denoting "Engineering Limits" on plots.

2000/1

dimension 50 variables
skip 25
read simon1.dat y1 y2 x1 x2 x3 x4 x5 block runseq
.
char x
line blank
.
subregion on
subregion xlimits 0.35 0.42
subregion ylimits 2000 3000
region fill on
region border line dash
region color g90
.
plot y1 vs x1
.
move 20 80
text n = ^ntotal
move 20 75
text accept = ^naccept
move 20 70
text reject = ^nreject