Encyclopaedia Index

AUTOPLOT

---- Autoplot Help ----

GENERAL INFORMATION


AUTOPLOT is an interactive-graphics computer program which produces labelled plots of numerical data in the form of graphs showing the variation of one or more variables against another variable.

The interactive capability of AUTOPLOT permits adjustment of the scaling, position and annotation of the plots for maximum clarity and impact.

Although designed to be especially convenient for PHOENICS users, AUTOPLOT can be used to plot any appropriately formatted data.

The following notes explain how it is used.

Notes on how to use AUTOPLOT

Contents

  1. About autoplot
  2. Data files accessed by autoplot
  3. Starting the run
  4. Data elements
  5. Creating and scaling the plot
  6. Data manipulation
  7. Picture management
  8. Additional facilities
  9. Increasing the array size
  10. Tutorials
  11. File formats

1. ABOUT AUTOPLOT

2. DATA FILES ACCESSED BY AUTOPLOT

3. STARTING THE RUN

4. DATA ELEMENTS

Data are introduced into the program by means of the 'DATA n' command, where 'n'denotes the number of the file containing the data.

This can then be displayed on the screen by using the 'PLOT', 'DOTn', 'BLBn' or 'COLh' commands, which will cause the line to be drawn

The axes will be scaled so that all data items in memory will fit on the plot.

Subsequent 'DATA' commands may introduce points which lie outside the current range; then the 'SCALE' command can be used to re-scale both axes to encompass the new data. It may thus be better to enter several 'DATA' commands before plotting, as fewer redraws will be required.

The plot can be labelled using the 'TEXT' and 'KEY' commands.

At any time, a clean picture can be recovered by the 'REDRAW' command.

The finished plot can be stored to a PHOTON-format 'save' file by the 'SAVE' command.

Data elements can be cleared away for the next plot by means of the 'CLEAR' command.

At any point, entering '/' will return control to the 'Command?' level. Many commands can be entered on one line, by use ';' as a delimiter.

More detailed help may be obtained on : DATA, PLOT, DOT, BLB, COLOUR, SCALE, TEXT, KEY, CLEAR

5. CREATING THE PLOT

6. DATA MANIPULATION

NOTE:

All AUTOPLOT commands can be abbreviated as much as possible whilst still maintaining uniqueness. Thus, for example:

ELEMENT ADD Y can be shortened to EL A Y

7. PICTURE MANAGEMENT

8. ADDITIONAL FACILITIES

9. INCREASING THE ARRAY SIZE

10. TUTORIALS

AUTOPLOT for PHOENICS-2 is supplied with on-line tutorials. All that is necessary in order to activate these is to run AUTOPLOT and to type the word: tutorial

Appropriate instructions will then appear on the screen.

These tutorials make unconventional use of the command-file method of running autplot.

11. FILE FORMATS

PLOT-format data files

Any number of data elements may be contained in one file. Suppose that a file contains N data elements, so that there are N dependent variables y1.....yN to be plotted against the independent variable x (say).

The layout for each number within a line is free-format.

The layout of the file is as follows:

Line number Contents



    1                              the integer N

    2                              title for y1

    3                              title for y2

    ...                            ...

    N+1                            title for yN

    (N+1)+1                        x1 first value of x

    (N+1)+2                        value of y1 at x1

    ...                            ...

    2*(N+1)                        value of yN at x1

    ...                            ...

    2*(N+1)+1                      x2 second value of x

    2*(N+1)+2                      value of y1 at x2

3*(N+1) value of yN at x2 ... ...

The titles in lines 2 to (N+1) may each contain up to 16 characters; their purpose is solely to identify individual elements when they are plotted. Embedded blank lines are not allowed.

TABLE-format files

These are also formatted indexed files, which contain columns of data. For example, the convergence-monitoring tables to be found in the PHOENICS RESULT file can be cut out and used as AUTOPLOT TABLE files.

Each TABLE file may contain up to 20 columns, and may be as long as required. The first line of the file should contain a heading for each column, up to 6 characters long. The subsequent lines will contain the values for each column in free format. Null entries in a particular column are allowed, and must be denoted by the character 'X'. Embedded blank lines are ignored.

PHI, PHIDA, XYZ, XYZDA, DF09 and DF12 files

The following files are produced by the PHOENICS program: PHI, PHIDA, XYZ and XYZDA by Versions 1.4 and above; DF09 and DF12 by Version 1.3.

In PHOENICS 1.4 and above, the choice between PHI & PHIDA and XYZ and XYZDA is controlled by the parameters PHIDA=T or F and XYZDA=T or F in the PREFIX file.

AUTOPLOT permits plotting of PHI and PHIDA files simultaneously. If any of the cases involve Body-Fitted-Coordinate grids (BFC=T), the name of the grid file will be requested. However, there is one limitation the restart file and grid file must be either both sequential-formatted (PHI/XYZ), or both direct-access (PHIDA/XYZDA). Mismatched pairs, eg (PHI/XYZDA) or (PHIDA/XYZ), are not allowed.

wbs