C Library Functions  - plotxt (3)

NAME

plotxt(3f) - [M_datapac:LINE_PLOT] generate a line printer run sequence plot for the terminal (71 characters wide)

CONTENTS

Synopsis
Description
Input Arguments
Output
Examples
Author
Maintainer
License

SYNOPSIS

SUBROUTINE PLOTXT(X,N)

       REAL(kind=wp),intent(in) :: X(:)
       INTEGER,intent(in)       :: N

DESCRIPTION

PLOTXT(3f) yields a narrow-width (71-character) plot of x(i) versus i. Its narrow width makes it appropriate for use on a terminal.

Values in the vertical axis vector (X) 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 X are ’missing data’, or when we purposely want to ignore certain elements in the vector X for plotting purposes (that is, we do not want certain elements in X to be plotted). To cause specific elements in X 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 PLOTXT(3f) subroutine.

Note that the storage requirements for this (and the other) terminal plot subroutiness are very small. This is due to the ’one line at a time’ algorithm employed for the plot.

INPUT ARGUMENTS

X The vector of (unsorted or sorted) observations to be plotted vertically.
N The integer number of observations in the vector X.

OUTPUT

A narrow-width (71-character) terminal plot of X(I) versus I. The body of the plot (not counting axis values and margins) is 25 rows (lines) and 49 columns.

EXAMPLES

Sample program:

   program demo_plotxt
   use M_datapac, only : plotxt
   implicit none
   ! call plotxt(x,y)
   end program demo_plotxt

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


Nemo Release 3.1 plotxt (3) July 22, 2023
Generated by manServer 1.08 from 9cbe943e-f892-4bc5-968b-2159821db98a using man macros.