|
Process Help PLOTTI - create a plot title |
Process Name |
Menu Path |
Link to Command Table |
PLOTTI |
Command line only |
Introduction
Generates a plot file containing a plot title.
How to use
The title block is placed centrally above the data area. Up to 80 plottable characters may be entered; the actual number depends on the width of the data area and the character size chosen. The characters are placed centrally in the title box, which also includes a Datamine title at the left of the box, and above the user-supplied title.
Title plot files may be APPENDed to any other files. Because no data input file is required, it is usual to use the plot file written out by a previous plot process as the prototype for the PLOTTI process. This removes the need to specify scaling parameters. However, if a null plot prototype is used (without scaling information in it) the parameters may be supplied in the normal way.
Files, Fields and Parameters
Input Files
Name |
Description |
I/O Status |
Required |
Type |
PROTO |
Plot prototype file. Must contain the fields X, Y, S1, S2 and CODE (numeric, explicit) and XMIN, XMAX, YMIN, YMAX, XSCALE, YSCALE (numeric, implicit). If these last 6 values set in PROTO , then corresponding parameters need not be set. |
Input |
Yes |
Plot Prototype |
Output Files
Name |
I/O Status |
Required |
Type |
Description |
PLOT |
Output |
Yes |
Plot |
Output plot file. |
Parameters
Name |
Description |
Required |
Default |
Range |
Values |
CHARSIZE |
Character size in millimetres (3). |
No |
3 |
Undefined |
Undefined |
ASPRATIO |
Aspect ratio, width / ht. for chars (0.9). |
No |
0.9 |
Undefined |
Undefined |
|
Colour [as 'pen' number] for plot (1). |
No |
1 |
Undefined |
Undefined |
APPEND |
Plot append flag. If set to 1 then the new plot will be appended to the PLOT file, if it exists and is a valid plot file (0). |
No |
0 |
0,1 |
0,1 |
XMIN |
Minimum value of X for plot. None of XMIN, XMAX, YMIN, YMAX, XSCALE, YSCALE need be set if this information is already in the prototype. |
No |
Undefined |
Undefined |
Undefined |
XMAX |
Maximum value of X for plot. |
No |
Undefined |
Undefined |
Undefined |
YMIN |
Minimum value of Y for plot. |
No |
Undefined |
Undefined |
Undefined |
YMAX |
Maximum value of Y for plot. |
No |
Undefined |
Undefined |
Undefined |
XSCALE |
X scale in user data units per millimetre. |
No |
Undefined |
Undefined |
Undefined |
YSCALE |
Y scale in user data units per millimetre. |
No |
Undefined |
Undefined |
Undefined |
Notes
No additional notes.
Example
!PLOTTI
|
&PROTO(AUHSPLOT),&PLOT(TITLPLOT),@CHARSIZE=2.5 |
PLEASE SUPPLY UP TO 65 CHARS TEXT FOR TITLE |
|
>>>>Histogram of Au values<return> |
Error and Warning Messages
Message |
Description |
Solution |
>>> CANNOT APPEND TO NON-EXISTENT OUTPUT FILE. >>> A NEW OUTPUT FILE WILL BE CREATED |
The @APPEND parameter has been set to 1, but the specified plot file does not exist. A new file will be created to contain the new plot being produced.
|
|
|
|
|
>>> ERROR - CANNOT APPEND TO PLOT FILE AS IT DOES >>> NOT CONTAIN ALL THE REQUIRED FIELDS. >>> THE PLOT FILE WILL BE OVERWRITTEN. |
The @APPEND parameter has been set to 1, the specified plot file exists but is invalid. The existing plot file will be overwritten by the new plot being produced.
|
|
|
|
|
>>> FATAL ERROR, BAD SCALE/RANGE COMBINATION(S) <<< >>> XMIN, XMAX = nnnnnnnnnn.nn nnnnnnnnn.nn >>> YMIN, YMAX = nnnnnnnnnn.nn nnnnnnnnn.nn >>> XSCALE, YSCALE = nnnnnnnnnn.nn nnnnnnnnn.nn |
Either insufficient scale information had been entered (at least two of XMIN, XMAX, XSCALE or Y equivalents must be entered either from the prototype of from parameters) or the combination given of XMIN, XMAX, and XSCALE (or their Y equivalents) was impossible. Often caused by entering a null plot prototype and no parameters. Fatal; the process is exited.
|
|
|
|
|