C Library Functions - plot10 (3)

NAME

plot10(3f) - [M_datapac:GENERIC_LINE_PLOT] generate a line printer plot with special plot characters

Synopsis
Description
Input Arguments
Output
Examples
Author
Maintainer
License
References

SYNOPSIS

SUBROUTINE PLOT10( & & Y,X,Char,N,Ymin,Ymax,Xmin,Xmax,D,Dmin,Dmax,Yaxid,Xaxid,Plchid)

       REAL(kind=wp) :: Y(:)
       REAL(kind=wp) :: X(:)
       REAL(kind=wp) :: Char(:)
       INTEGER       :: N
       REAL(kind=wp) :: Ymin, Ymax
       REAL(kind=wp) :: Xmin, Xmax
       REAL(kind=wp) :: D(:)
       REAL(kind=wp) :: Dmin, Dmax
       REAL(kind=wp) :: Yaxid, Xaxid
       REAL(kind=wp) :: Plchid

DESCRIPTION

PLOT10(3f) yields a one-page printer plot of y(i) versus x(i):

1. with special plot characters;

2. with the vertical (y) axis min and max and the horizontal (x) axis min and max values specified by the data analyst;

3. with only those points (x(i),y(i)) plotted for which the corresponding value of d(i) is between the specified values of dmin and dmax; and

4. with hollerith labels (at most 6 characters) for the vertical axis variable, the horizontal axis variable, and the plotting character variable also being provided by the data analyst.

The ’special plotting character’ capability allows the data analyst to incorporate information from a third variable (aside from y and x) into the plot.
The plot character used at the i-th plotting position (that is, at the coordinate (x(i),y(i))) will be

1 if char(i) is between
0.5 and 1.5

2 if char(i) is between
1.5 and 2.5 [char46] [char46] [char46]

9 if char(i) is between
8.5 and 9.5

0 if char(i) is between
9.5 and 10.5 a if char(i) is between 10.5 and 11.5 b if char(i) is between 11.5 and 12.5 c if char(i) is between 12.5 and 13.5 [char46] [char46] [char46] w if char(i) is between 32.5 and 33.5 x if char(i) is between 33.5 and 34.5 y if char(i) is between 34.5 and 35.5 z if char(i) is between 35.5 and 36.5

x if char(i) is any value outside the range 0.5 to
36.5.

The use of the ymin, ymax, xmin, and xmax specifications allows the data analyst to control fully the plot axis limits, so as, for example, to zero-in on an interesting sub-region of a previous plot.
The use of the subset definition vector d gives the data analyst the capability of plotting subsets of the data, where the subset is defined by values in the vector d.
The use of hollerith identifying labels allows the data analyst to automatically have the plots labeled. this is particularly useful in a large analysis when many plots are being generated.
Values in the vertical axis vector (Y) which are smaller than YMIN or larger than YMAX, or values in the horizontal axis vector (X) which are smaller than XMIN or larger than XMAX will not be plotted.
For a given dummy index I, if D(I) is smaller than DMIN or larger than DMAX, then the corresponding point (X(I),Y(I)) will not be plotted.
Values in the vertical axis vector (Y), the horizontal axis vector (X), or the plot character vector (CHAR) which are equal to or in excess of 10.0**10 will not be plotted.
This convention greatly simplifies the problem of plotting when some elements in the vector Y (or X, or CHAR) are ’missing data’, or when we purposely want to ignore certain elements in the vector Y (or X, or CHAR) for plotting purposes (that is, we do not want certain elements in Y (or X, or CHAR) to be plotted).
to cause specific elements in Y (or X, or CHAR) to be ignored, we replace the elements beforehand (by, for example, use of the REPLAC(3f) subroutine) by some large value (like, say, 10.0**10) and they will subsequently be ignored in the PLOTC(3f) subroutine.

INPUT ARGUMENTS

Y The vector of (unsorted or sorted) observations to be plotted vertically.

X The vector of (unsorted or sorted) observations to be plotted horizontally.

CHAR The vector of observations which control the value of each individual plot character.

N The integer number of observations in the vector y. There is no restriction on the maximum value of n for this subroutine.

YMIN The value of desired minimum for the vertical axis.

YMAX The value of desired maximum for the vertical axis.

XMIN The value of desired minimum for the horizontal axis.

XMAX The value of desired maximum for the horizontal axis.

D The vector which ’defines’ the various possible subsets.

DMIN The value which defines the lower bound (inclusively) of The particular subset of interest to be plotted.

DMAX The value which defines the upper bound (inclusively) of The particular subset of interest to be plotted.

YAXID The hollerith value (at most 6 characters) of the desired label for the vertical axis variable.

XAXID The hollerith value (at most 6 characters) of the desired label for the horizontal axis variable.

PLCHID The hollerith value (at most 6 characters) of the desired label for the plotting character variable.

OUTPUT

A one-page printer plot of Y(I) versus X(I), with special plot characters, with specified axis limits, for only of a specified subset of the data, and with specified labels.

EXAMPLES

Sample program:

program demo_plot10 use M_datapac, only : plot10 implicit none ! call plot10(x,y) end program demo_plot10

Results:

AUTHOR

The original DATAPAC library was written by James Filliben of the Statistical Engineering Division, National Institute of Standards and Technology.

MAINTAINER

John Urban, 2022.05.31

LICENSE

CC0-1.0

REFERENCES

o Filliben, ’Statistical Analysis of Interlab Fatigue Time Data’, Unpublished Manuscript (available from Author) Presented at the
.Computer-Assisted Data Analysis’ session at the National Meeting of the American Statistical Association, New York City, December 27-30, 1973.

Nemo Release 3.1

plot10 (3)

July 22, 2023

Generated by manServer 1.08 from f993d761-4785-48fd-a985-4c4988abcd64 using man macros.

1.	with special plot characters;
2.	with the vertical (y) axis min and max and the horizontal (x) axis min and max values specified by the data analyst;
3.	with only those points (x(i),y(i)) plotted for which the corresponding value of d(i) is between the specified values of dmin and dmax; and
4.	with hollerith labels (at most 6 characters) for the vertical axis variable, the horizontal axis variable, and the plotting character variable also being provided by the data analyst.

1 if char(i) is between
	0.5 and 1.5
2 if char(i) is between
	1.5 and 2.5 [char46] [char46] [char46]
9 if char(i) is between
	8.5 and 9.5
0 if char(i) is between
	9.5 and 10.5 a if char(i) is between 10.5 and 11.5 b if char(i) is between 11.5 and 12.5 c if char(i) is between 12.5 and 13.5 [char46] [char46] [char46] w if char(i) is between 32.5 and 33.5 x if char(i) is between 33.5 and 34.5 y if char(i) is between 34.5 and 35.5 z if char(i) is between 35.5 and 36.5
x if char(i) is any value outside the range 0.5 to
	36.5.

Y	The vector of (unsorted or sorted) observations to be plotted vertically.
X	The vector of (unsorted or sorted) observations to be plotted horizontally.
CHAR	The vector of observations which control the value of each individual plot character.
N	The integer number of observations in the vector y. There is no restriction on the maximum value of n for this subroutine.
YMIN	The value of desired minimum for the vertical axis.
YMAX	The value of desired maximum for the vertical axis.
XMIN	The value of desired minimum for the horizontal axis.
XMAX	The value of desired maximum for the horizontal axis.
D	The vector which ’defines’ the various possible subsets.
DMIN	The value which defines the lower bound (inclusively) of The particular subset of interest to be plotted.
DMAX	The value which defines the upper bound (inclusively) of The particular subset of interest to be plotted.
YAXID	The hollerith value (at most 6 characters) of the desired label for the vertical axis variable.
XAXID	The hollerith value (at most 6 characters) of the desired label for the horizontal axis variable.
PLCHID	The hollerith value (at most 6 characters) of the desired label for the plotting character variable.