Process Help

PROTOP - generate a plot prototype (data definition)

 

Process Name

Menu Path

Link to Command Table

PROTOP

Command line only

Click here

 

Introduction

To create a prototype plot file with defined plot and data area shape/size, and optionally data ranges and scaling factors.

How to use

PROTOP is the first process to be used before plotting starts. It defines the prototype that will subsequently be used by plot processes. The main parts defined are the plot region (the total true size of the plot) and, within this, the data area, into which most plot processes will place plotted data. Sizes are defined in millimeters, and may be measured from existing plots, so that any in-house standard plot shape and size may be duplicated.

Within the data area, it is also possible to specify data ranges and/or scales if required. Thus a plot prototype could be set up for, for example, a series of bench plans. However, ranges and scales may be defined later, if required, during the plot process itself.

Scaling

Scales are defined separately in the X and Y directions, as data units per plotted millimeter. Thus, if the data units are meters, then an X SCALE (or Y SCALE) of 1 will give one meter per plotted millimeter, or a scale of 1:1000. An X SCALE of 2 will give 1:2000, and so on. If the data units are feet, then an X SCALE of 3.28084 will give 3.28084 feet per plotted millimeter (i.e. a scale of 1:1000).

Data Ranges and Scales

The user may define three values for X and Y defining the scale (X SCALE), and minimum and maximum data values (X MIN and X MAX). Any two out of these three must be defined, and the remaining value is then calculated. However, if all three are defined, then they must be consistent; the data range must map into the defined data area at the given scale. The process checks for this. Note that if the minimum and maximum are defined, then these are mapped into the data area, and can give rise to different scales in X and Y; to ensure the same scale in X and Y, it is better to give a data minimum or maximum and the required scale.


Files, Fields and Parameters

Input Files

Name

Description

I/O Status

Required

Type

Output Files

Name

I/O Status

Required

Type

Description

OUT

Output

Yes

Plot Prototype

Plot prototype file to be created.


Notes

PLOT-FILE PROTOTYPE SET-UP

 -------------------------------------

A PLOT CONSISTS OF A DEFINED PLOT AREA  WITHIN WHICH IS A DEFINED DATA AREA.

 

DEFINE THE PLOT AREA, THE OPTIONS ARE :

1 DEFINE EXPLICITLY IN MILLIMETRES

2 HORIZONTAL A0 (1189 x 841 MM)

3 VERTICAL A0 (841 x 1189 MM)

4 HORIZONTAL A1 (841 x 594 MM)

5 VERTICAL A1 (594 x 841 MM)

6 HORIZONTAL A2 (594 x 420 MM)

 7 VERTICAL A2 (420 x 594 MM)

8 HORIZONTAL A3 (420 x 297 MM)

9 VERTICAL A3 (297 x 420 MM)

10 HORIZONTAL A4 (297 x 210 MM)

11 VERTICAL A4 (210 x 297 MM)

12 HORIZONTAL QUARTO (11 x 8.5 INCHES)

13 VERTICAL QUARTO (8.5 x 11 INCHES)

14 SQUARE (250 x 250 MM)

 

>OPT> Enter 1-14

Option 1:

DEFINE PLOT AREA EXPLICITLY IN MILLIMETRES :

>PLOT AREA X SIZE > Enter X size in mm.

>PLOT AREA Y SIZE > Enter Y size in mm.

 

DEFINE DATA AREA ORIGIN POSITION, IN MILLIMETERS FROM THE BOTTOM LEFT CORNER OF THE PLOT AREA :

>DATA AREA X ORIGIN> X origin of data area.

>DATA AREA Y ORIGIN> Y origin of data area.

 

DEFINE DATA AREA SIZE IN MILLIMETRES : MAXIMUM POSSIBLE X VALUE IS 999.99999 MAXIMUM POSSIBLE Y VALUE IS 999.99999

>DATA AREA X SIZE > X size of data area in mm.

>DATA AREA Y SIZE > Y size of data area in mm.

 

DO YOU WISH TO DEFINE SCALING IN THIS PROTOTYPE Y/(N) ? If Y or y :  YOU MUST DEFINE AT LEAST TWO OF THE FOLLOWING: XMIN,YMIN AND XMAX,YMAX, OR XMIN,XSCALE AND YMIN,YSCALE, OR XMAX,XSCALE AND YMAX,YSCALE, OR YOU MAY DEFINE ALL THREE, IN WHICH CASE THE VALUES MUST BE CONSISTENT ENTER SCALE AS DATA UNITS PER PLOTTED MILLIMETER :

 

IF YOUR DATA UNITS ARE METRES THEN A SCALE OF 1.0 WILL GIVE ONE METRE PER PLOTTED MILLIMETRE AND A SCALE OF 0.001 WILL GIVE ONE MILLIMETRE PER PLOTTED MILLIMETRE. IF YOUR DATA UNITS ARE FEET THEN A SCALE OF 3.28084 WILL GIVE 3.28084 FEET PER PLOTTED MILLIMETRE (I.E. 1000 FEET PER PLOTTED FOOT)

>X SCALE> Scale in data units/mm. <return> to ignore.

>Y SCALE> Scale in data units/mm. <return> to ignore.

 

PLEASE SUPPLY THE DATA RANGES IN EACH DIRECTION :

>X MIN > Minimum data value in X. <return> to ignore.

>X MAX > Maximum data value in X. <return> to ignore.

>Y MIN > Minimum data value in Y. <return> to ignore.

>Y MAX > Maximum data value in Y. <return> to ignore.

 

The plot prototype file description is then displayed, followed by:-

IS THIS DEFINED PLOT-FILE PROTOTYPE OK ? >CONFIRM ? > OK, ok, YES, yes, Y or y to accept; any other response to restart the prototype entry.

 


Example

!PROTOP &OUT(BENCPROT)

>>>    

  PLOT-FILE PROTOTYPE SET-UP <<<

>>>

-------------------------- <<<

 

>>>
>>> 

 

A PLOT CONSISTS OF A DEFINED PLOT AREA
WITHIN WHICH IS A DEFINED DATA AREA.

>>>

DEFINE THE PLOT AREA, THE OPTIONS ARE :

>>> 

1

  DEFINE EXPLICITLY IN MILLIMETRES

>>>

2

  HORIZONTAL A0 (841 x 1189 MM)

>>>

3

  VERTICAL A0 (1189 x 841 MM)

>>>

4

  HORIZONTAL A1 (594 x 841 MM)

>>>

5

  VERTICAL A1 (841 x 594 MM)

>>>

6

  HORIZONTAL A2 (420 x 594 MM)

>>>

7

  VERTICAL A2 (594 x 420 MM)

>>>

8

  HORIZONTAL A3 (297 x 420 MM)

>>>

9

  VERTICAL A3 (420 x 297 MM)

>>>

10

  HORIZONTAL A4 (210 x 297 MM)

>>>

11

  VERTICAL A4 (297 x 210 MM)

>>>    

12

  HORIZONTAL QUARTO (8.5 x 11 INCHES)

>>>

13

  VERTICAL QUARTO (11 x 8.5 INCHES)

>>>

14

  SQUARE (250 x 250 MM)

>>>

15

  SCREEN DIMENSIONS (245 x 170 MM)

OPT>2The plot size is defined to be horizontal A0.

>>> DEFINE DATA AREA ORIGIN POSITION, IN MILLIMETRES 
>>> FROM THE BOTTOM LEFT CORNER OF THE PLOT AREA : 

DATA AREA X ORIGIN >60 
DATA AREA Y ORIGIN >60

A 6 cm (60 mm) margin is left between the paper origin and the data area.

>>> DEFINE DATA AREA SIZE IN MILLIMETRES :
MAXIMUM POSSIBLE X VALUE IS 1129.00000 
MAXIMUM POSSIBLE Y VALUE IS 781.00000 

DATA AREA X SIZE >1000
DATA AREA Y SIZE >721

This defines an area of 100 x 72.1 cms for the data plots; 12.9 cms are available to the right of the plot for a legend etc, while on the Y axis there is a 6 cm margin at top as well as bottom.

>>> DO YOU WISH TO DEFINE SCALING IN THIS PROTOTYPE Y/(N)?>y

To define scaling.

>>> ENTER SCALE AS DATA UNITS PER PLOTTED MILLIMETRE : 

>>> IF YOUR DATA UNITS ARE METRES THEN A SCALE OF 1.0 
WILL GIVE ONE METRE PER PLOTTED MILLIMETRE AND A 
SCALE OF 0.001 WILL GIVE ONE MILLIMETRE PER 
PLOTTED MILLIMETRE. IF YOUR DATA UNITS ARE 
FEET THEN A SCALE OF 3.28084 WILL GIVE 3.28084 
FEET PER PLOTTED MILLIMETRE (I.E. 1000 FEET PER 
PLOTTED FOOT) <<< 

XSCALE>2
YSCALE>2

The scale in both directions will be 1:2000.

>>> PLEASE SUPPLY THE DATA RANGES IN EACH DIRECTION :

X MIN >1200
X MAX ><return>
Y MIN >750
Y MAX ><return>

The X and Y minima are defined, and the maxima will be calculated. In this case, they will be:-

X MAX = 3200 
Y MAX = 2192 

>>> FULL PLOT-FILE PROTOTYPE DESCRIPTION <<< 
------------------------------------
PLOT AREA DIMENSIONS : 
X = 1189.00000 Y = 841.00000 
DATA AREA ORIGIN : 
X = 60.00000 Y = 60.00000 
DATA AREA SIZE : 
X = 1000.0000 Y = 721.00000 

DATA RANGES AND SCALES : 
XMIN = 1200.00000 XMAX = 3200.00000 
XSCALE = 2.00000 
YMIN = 750.00000 YMAX = 2192.00000 
YSCALE = 2.00000 

CHARACTER SIZE = 4.00000 
CHARACTER ASPECT RATIO = 0.90000 

>>> IS THIS DEFINED PLOT-FILE PROTOTYPE OK ?
CONFIRM ? >y


Error and Warning Messages

Message

Description

Solution