SLAC COMPUT1TrOl GROOP stanford, California

TOP DBAWER

CGTM Mo. 158 July 1974 Revised: Moye.ber 1974 May 1975

Boger B. Cha f.fee computations Research Group

Stanford Linear Accelerator Center

\

Table of Contents

Introduct.ion ••••••••••••••••••••••••••

Card InpQt General rules ••••••••••••••••••••••

Liaitations ............•..•........

3

Data input ••••••••••••••••••••••••• 5

Control input •••••••••••••••••••••• 5 Co •• and list •••••••••••••••••••• 6 Co •• and description ••••••••••••• 8

JeL •••••••••••••••••••••••••••••••• 19

Saaple input ••••••••••••••••••••••• 20

PORTRAN Calls ••••••••••••••••••••••••• 22

Li.itation~ •••••••••••••••••••••••• 22

Arrays ••••••••••••••••••••••••••••• 22

Abbreviated Calls •••••••••••••••••• 22

List of Calls •••••••••••••••••••••• 23

Descriptions of Calls •••••••••••••• 24

Jet •••••••••••••••••••••••••••••••• 28

sa.pIe Job ••••••••••••••••••••••••• 28

lppend.1x 1\ (Specific 1utput Devices) Tektronix 4013 ••••••••••••••••••••• 29

CalCoap •••••••••••••••••••••••••••• 29

!icrofiche and 16-mm Pilm •••••••••• 30

DTC-300 •••••••••••••••••••••••••••• 30

versatec !lectrostat~c Plotter ••••• 31

Append!x B (InteractiYe Mede) ••••••••• 32

Append! .• C (User Scaling) ••••••••••••• 33 Scaliuq ¥Unction ••••••••••••••••••• 33 Ticks and Labels ••••••••••••••••••• 3. Jet •••••••••••••••••••••••••••••••• 35

Appendix D (Pancy Characters) ••••••••• 36

3 TOP DB11£1--l Proqram to Draw Plots and Graphs

TOP DRAWER draws curves, histograas, and indiyidual data points, with axes, ticks, nuaeric labels, and any titles the user specifies. Conn~ction to the graphic device(s) used for output is through the SLAC Unified Graphics System. (U.G." so outpQ~ can be made on any non-interactive device known to O.G. currently, this includes the Tektronix 4013 WtLBUR terainals, tbe DTC-l00 terainals, the versatec Electrostatic plotter, the 10" and 29" CalCoap plotters, and the CalCoap Microfil. Plotter. Titles may contain any of the characters of the U.G. extended character set.

"any of the features of a plot can be described by the user, with control cards conta.ining keywords and values. In the absence of specific instluctions, TOP DBAIER chooses values based on the giYen data. A good plot can usually be .ada just fro. the data points, with no additional instructions.

TOP DRIWER can be run as a self-contained proqra., reading a data set of cards or card-images. ~here are also POR!RAI­callable sQbroa~ines which allow the user's .ain prograa to control the plottiDg.

1) Robert c. Beach, Ihe ~.L!£_.Yl!U1&g_Ji~!211i;cs .. 5n1!! CGTI! 10. 1_3 (reyised Septe.ber 1914)

TOP Dl11£1--l Proqraa to Draw Plo~s and Graphs

TOP [BIWER Input Cards

1. §!ll!Il.L!.!!l!!

Data and co •• ands are read from the input file, POBTRAR unit 5. Input is free-field. Pield separators are S * I , s and blank. At aost four, and soaetiaes fever, characters are significant in control vords. Subsequent characters, until a separator, are ignored. Input values .ay be given in integer, deciaal, or exponential notation. (As a general role, any PORTRll ootput, with I, P, E, or D for.at, is a legal input walue for TOP DIAiER.)

Comments on input cards aay be enclosed in parentheses (). l11 enclosed characters are ignored. Co •• ent fields are Dot continued to the next cara.

A seaicolon (;) ends the current card. !n!!!!!g_2! __ I!!.~!!! 1--!!! __ Sl'~!2f_~!!!!!-sg!linY!!_!f1!I-t~'_§!!!£2!gn. In this way, multiple cOllmands and/or data points lIay be entered wit.h one pkysical card.

TOP DiAiER makes tvo-di'ensional plots. The "x-~xisn is hor.izontal and the "y-axis" is vertical. On 10-inch CalCoap, the x-axis runs along the paper, and is virtually unli.itea. The ,-axis is across. and .ay be no lonqer than 10-.

B. 1i!illti21!§

The TOP DRAWER input language bas evolved according to idea that TOP DRAWER should do what you expect it to. ideal is not alvays possible to realize, and soae of exceptions are described in this section.

the This the

1) No more than 1000 points aay be entered at one tiae. Blocks o.f this size or less must be separated by a PLOT or Jotl co •• and.

2) The Ii.its for a plot aust be set at the first PLOT, HIST, or JOII command. ~his means that if tvo or aore separate sets of points are being JOINed, the antoaatic li-it setter vill look 'at the first set, and TOP DRAVER vill .ake the axes before the second set is read in. In this case, to make sure the limits are big enough for both sets, an explicit SET LIMIT co •• and must be used.

.~.

5 TOP DI11!1--l Prograa to Draw Plots and Graphs

Data points consist of yalue and error for x and y, and a plot sy.bol. A data point card aay contain fro. one to five yalaes. The order in whicb t~e values on this card are interpreted is set by the SIT OlDER co •• and. The default order 1s [I Y DX DY StftBOL]. In a series of data cards, a value qiven OD one card will be repeated for subsequent cards unless changed. The startiD<) values for this sche.e are zero for th.e nu.bers and blank for the plotting syabol.

CO. sands which control the for.at of the plotting and the place.ent of titles and labels -ay be interspersed with data point cards. 'Ike n9xt part. of this section contains a brief description of each co •• and. The following part contains .ore detail.

The coa.and scan is generally a loop, after t.he first vord (second for a SET command) is recognized, and keyword paraaeters aa, be qiYan in any order, although the effect of one is unpredictable in case of a syntax error in anotber. Ex •• ples: SET SCALE I LINEAR Y LOG BAS! 2

SET LABEL TOP OR BOTTO" Opp

In this writeup, size .easureaents are .ada in "inches". one "inch" is a real inch, if it is reasonable for it to be so, as in the case of CalCoap plots. In other cases, for instance ,~.. fil., an "inch" is define4 relatiye to the size of the' total plot, which is normally 13 "inches" vide by ten "inches· hiqh. PJore details are given onder the SET SIZB co.mand.

The notation used in co •• and description is t.aken from the WYLBUB manual. Briefly. "I" aeans "OR" and separates alternatives. Brackets [ ] enclose optional material. Braces 0 enclose one or .ore options, one of which aust be specified. In underscore indicates a default option, which Deed not be given explicitly. Opper case text .us·t be used as specified. Lover case indicates text. characters, or values to b·e qi ven by the user.

'fOP DBAI!I--l Prograa to Draw Plota andG-raphs

!1fD

HIS'rOGB1!

JOIN [level] (§D!llll I SPLINE) [TIlT] (DOTS] .akas a carye passing tbrough qiyen points.

}fln. Pto'!' {( ALllS: l' alias' ] starts a new page.

PLOT plots given points, with error bars ana Sf.bol.

SM-OOTH (1'1) [LEVEL n] {POIN'fS n 1 TO D 2] {LIS! [n]]

SY!BOL [x] [SIZE n] sets sy.bol used -for plot character.

RETUBN {n] retarns to calling prograa (see 'POITRAI Calls')

TITLB [XII,GI[DATl] xxx !,,] [SIZE n1 (ANGLE xl [SPICES nl 'text'

writes text OD plot ClSB 'text' ~

follows TITLB card. Invokes fancy characters.

(lfYIDtIDY] [(BINSIPOIHTS){[n1 ~O] n2]] [FROft xxx] (TO xxx] [BY xxx]

(continued ••• )

6

TOP DllIIB--l Prograa to Draw Plots and Graphs

SET 1111 [I xxx TO xxx] (I yyy TO fry] defines position of outline of current graph. (Labels are outside this area. Titles and other grapbs .ay be •• de 'inside or oQtsiae.)

SET (1IISI11!S) [[TOf'BO~10!IIIGBTILIPT] (OllorrlRIIlI'IJ] controls presence/abseace of axes.

SE~ BIR [SIZE] xxx

SBT ClRD [tZIGTR] n

SET D!'ICI device

sets size of ends of error bars.

sets length of input cards.

chooses. output device. (Q013. calCo.p •••• )

SET LIBEL (SIZ!=a] [[~OP'!OTTOMIRIGH!ILBrTl (011 orr, nnW) ] [PLOT]

controls Du.eric labals along axes.

SET tIRI~S [I ~xx fO KXX] [Y f'Y TO "y] [IBII xxx) (1111 xxx] [tIlIM YYf] [tftll fff]

sets li.its for each plot axis.

SET lODE (VICTOR] [1I0'ECTOB] [ECHO [D]] (RO!CHO] (DEBUG] {JODIBUG] (DIB8] sets aiscellaneou8 flags.

S.8T OlD B R (I [f ct r ]] [t [fet r ]] {D IIII [fc t r ] ] { Of IllY [fctr 1] [St!l80L]

deter·aines in terpratatioD of input data cards.

SET SCILI (I, Y) [LOG (BASE n]] [LIIBII] [US!I {a]] [n1 02 ] sets scaling, nu.ber of labels, aDd ticks

SET SIZE xxx [BY] ,yy [UNITS=units] aeflnes acti.earea of paper or unit for screen.

S!! SIMBOL [x] [SIZ! nJ sets sy.bol used for plot character.

SET TICK [SIZ!2n] [[TOPIBOTTOft,BIGHTILBPT] (Oil I OP P 'llll.!Zl!) ] [PLOT]

controls tick marks OD axes.

7

8 TOP Dl1111--1 Prograa to Drav Plots and Graphs

_ .... =-_ .... ___ ... ___ ... __ .. __ ... _ .. __ ...... ..-._.a ........ _ .... _ ........ ~ ..... ~ __ ... .-_____ ...

HISTOGR1!!

TOP DIII!a .akes siaple bistogra.s. fro. data points. Biu edges are put half-way between the eDds of the adjacent error bars, or halfway between the points if there are DO error bars.

JOI I (leyel] (§!!D.l.LI SPLII!) [Til'!] (DO~S]

Draw a line froa point to point. Error bars and s,.bols are not used. If 'ley.l' is specifled, it 1s the nuaher of straight line seg.en ts which vi11 be used in connecting ad'jacent points.

The GBIER1L curve is calculated usinq an algoritha which allows aultiple-valued functions and repeated point.s.Because of its geDerality, it soaetiaes adds undesired loops and curls. SPLII! inwokes a natural cubic spline fit to the given points. (For the SPLIWB fit. tllere is a .axiau. no.bar of points, aDd either ·the 'K- ory-values anst be strictly iDc::reasillC). TOP DRAW!! ellec.ks tbese conditions, and uses the GIIBI1L .fit if they, are Yiolatad.,

TBI., instructs 'fOP DBllBB that the current points are part of the text or titles beiDC) plotted. The coordinate systea used is the saaa as is used for positioninq titles. and no plot axes are .ade.

DOTS specifies that a dotted line is to be drawJl. (The ou.ber of dots drawn between each pair of yoar points is (leyel­'). If your point.s are Dot evenly spaced. the dots vou't be. eit her.

(JOII draws ouly the curve or line seg.ents, Dot the sy.bol or error bars. For sy~bol and error bars. you aust PLOT as ve1l.) ,

9 TOP DllIBI--l Progra. to Draw Plots and Grapks

---.... ---..... --.. ----.. ------.... ~- ... --.... ---~-------- ......... -........ ---.-1I!1 PLOT [( ALIAS= ]' allas' ]

--------_._-_._----_.-----_.-------------------------Start a co.platel, ne. picture. Untreated points are

PLOTted before 90ing ODe

Por so •• graphic deYi'ces, e.g. fl013, D!C-300, output is a PDS, and each ••• ber is ODe plot. In this case, a •• ber naaes are PICT001, PICT002, etc., but the, a.y be.giwell an alias. The giY8n alias naa •• the followinq plot, Dot tbe previous one.

PLO'!

------------------------------------------.--------~-plot the current points, with the given er~or bars and

sy.bols. This co •• and sets li.its if not already set. If the current points hay. Dot been processed (i.e. by a PLOT, JOII, or HIS1' co •• and). PLOT is perfor.ad auto.atically at. the end of input, or before a RBW PLOT or SET lBEl co •• and.

--_ .. --_ .. -........ .------- ....................... __ .. .-... -... ---... __ ....... ~- ... -..... ----.-RITURI [n]

This is a co •• and to return to the callin9 prograa. It is useful when Top Drawer has been called fro. a user prograa (see 'POITRA. Calls') or the interactive dri.er (see Appendix B., If Top Drawer vas called by the POITRA. state.ent CALL TDBlIIII), I beco.es the full.ord integer Yalue n.

10 TOP DI1V!I--l Progra. to Dr.w Plots and Graphs

SET llEl [I KXX TO xxx] {t JfT TO f'Y]

SET AREl sets the coordinates. iD "inches", of the axes of the co.lDg graph. ('he a,ailable plo~ting surface 1s set by the SEt SIZE co •• and.) Rore than one area .ay be used before aakinq a HI. PLOT. If neither I nor I is specified, the values are reset to the original, nearly full-size. values. If only one is specified, the other is not changed. When one or both is specified, the corresponding li.its a~e reset for automatic selection. They .ay of coarse be reset by a SET LI"ITS co •• and. Eleaentary safequardsare in effect to preyeDt putting the axis labels of the current plot inside the area of the preyious plot. These safequards are effectlYe only if plots are .oved fro. low to high (increasinq Y) or lef~ to right (increasing ~.

-~--~-~-~-~~----~---~-~-~~--~-~---~~----~~-~-~-~-----

SET (AXIS,AIES} [[TOPIBOTTORIRIGBTILEPT] (OIIOPPI~!lAY~!)]

---------~--------~------.~-.----.-------------------Controls the. presence or absence of each axis. This

affects only the axis itself, not the ticks or labels. The axes are drawn at the first PLOT, HIST, or JOII co •• and, and tbis co •• and viII have no effect if it is given later. DBPAUL'!' is the saae as ON.

-----------------------------------------~-----------SET BAR [SIZE] xxx

~his com.and sets the si~e of the lines on the ends of the error bars. 15 in the SET TXCK SIZE command, ~he default value is 0.1" and the unit is "inches".

\

SET ClRD [LIHGTH] lenqth

... -..... -_ ...... --- ....... .- .... _ ...... .-- .. -.. .- .... -_ ... .- --_.- .. _ .................. _- ~ .. -.... -... --- ...

Sets the nuaber of siqDificant eoluans for the input cards. The starting value is 72.

'rOP DI&IIII--1 prograa to Draw Plots alld Graphs

---.. ,-~-... -.--.......... ---.. --,.~ .. ----........ --.-...-__ .... -.. -_ ........... __ .. ..... -SIT DEVICI dey ice

-----------------------------------------------------Ayallable ou~put deYices are

'O~lnch CalCoap .29':'inch Calcoap 4013 'Scope 16-.. uDsprocketed f1l. ftlcrofiche DTC-100 '1100 (.ersatec Electros~atic Plotter Nadel 1100)

11

Only the first two characters are used in iaelltlfying the device type.

The JeL aost define an output dataset appropriate for the (each) device. See the section OD JCL for a description •

... -------..... .--~---- ... --.---.- ... -... -~.-- ... -... --.. -- ... -----...... -........ -.. -SET LABBL [SIZ!=n] [[TOPIBOTTOftIRIGBTIL!FT]

(Oil' or p, ~Rl.Ylt) ] (PLOT]

-------.---------------------------------------------sets the size of the Du •• ric labels along the axes, ana

specifies which axes are to be labelled. The size, as usual for text size, describes the claaracter spacinC), in tenths of an "inch". the starting size is -2. The defaults are 01 for left and bottoa, and OFF for top and right.

PLOT si9naIs that the labels and ticks are to be plotted i •• ediately. using the liaits that are currently in force.

12 TOP DBlV!R~-l Prograa to Draw Plots and Graphs

-----------------------------------~-----------------SET LIPIITS [X xxx TO xxx] [t fTY TO flf] (1611 xxx J [1811 xxx]

{tRIB 'Il! 1 [Y "11 "y]

This co •• alld is used to request or override the autoaatic selection of plot 1i.its. lith auto.atic selection, ii.its are set to 101 beyond the range of input values, at the first PLOT, JOIN, or HIST co •• and. If no 1i.its are given, all are set for autoaatic selection. If soae are specified, the others are not changed•

The difference between limits .a, have any non-zero value. IPlIM gives the yalue at the left edge of the x-axis, and IftlX gives the value at tha right. and, but there is no require.ent that I~II be less than IftAI. (And tbe use of !!IN and 'MIX is of coarse siailar.) In thesaae vay, the co •• and

SBT LlftITS I PIO" 10 TO -10 Y FROft 0 ~o -20 is legal, and sets yalues fro. 10 at the left edge to -10 at the right, and fro. zero at the botto. to. -20 at the top.

----------------~--~---------------------------------SET PlOD! ['BCTO·!] {BOfBC'lOI] [ECHO (n]] [ROECHO 1 {DEBUG]

( MOD!BOG] [DEBR]

-~---------------------~-----.-.---------------------This is a catch-all co •• and. for controlling aiscellaneous

unrelated flags.

VECTOR requires vector cbaracters in all text, eyen if the current deyice has a character generator. MOJECTOR nullifies a previous VBCTOR co.and.

BCHO.n sets the au.bar of data pOint cards in each block wbich will be listed in the printed output. (There is no vay to suppress the printing of control cards.) ECHO is equivalent· to ECHO 10000. ROECHO is equivalent to ECHO O. The starting value

. is 20.'

DEBUG and DEBR set printing flags for the plotting routines and the card-reading routines, respectively. NOD!aU~ ~afte~I, them both. They are not for the <Jeneral user.

~OP DIIIER--! Prograa to Draw Plots and Graphs

SET OBOE! {X (fctr 1] [Y [fctr]] r DII IX {fctr]] {DYIBY (fctr)] {SYMBOL 1

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

13

each [I Y

~his com.and sets the order ia which the nu.ber fields on data card will be interpreted. The default order is

DX Df SYf!BOt] ..

I and Yare central yalues. DX and Df are half-widths for the error bars used in thE PLOT cO_lIand. RI ana BY signify that that the errors to be giYen are relative to the central value.

"fctr" are four aultiplicitive factors which viII be applied to the data on each inpot card. If a factor is not explicitly <Jiven, 1. is used. falues fro. a previous SET OlDER card are Dot retained.

SY!BOL is the sy.bol vhich viII be used to PLOT the point. (The default sy.bol is qiYen by the SYMBOL card.) It may be speci-fied by a single charact.er.. a hex pair. or a O.G. extsnded-character-set pair, as for the SyftBOL co •• and.

Por instance .. SET OlDER X DI t DY SY 10 3 50 10 80

is equivalent to

and to

SET ORDE! I RX Y BY SYB 10 .3 50 • 2 OP

SET ORDEa X 10 RX Y Dt 10 SY"BOt 1 .3 50 1 OP

14. TOP DR1IER--l Progr.am to Draw Plots and Graphs

---------~------------~------~---------.-------------SET SCIL! (XII) [LOG {BAS! n]] [LIBElS] {USER [n]l [n1 n2]

Scaling for eacb axis 1s independent. n1 and n2 specify the type and spacing of labels and ticks. If n1 and/or n2 are zaro or oaitted, TOP DBII!! chooses its own value (s). Cont.rol is differe1l~ for linear and logarithalc scales.

~!!£: There viII be at .ost (In11.1) in~er.als (aDd In11+2 aajor ticks) OD the axis. (Since labels are placed a~ roand nu.bers, which .ay not coincide wit.h the ends of the axis, there aay be fever.) Bach interval is divided into 1021 subinter9als by unlabelled ticks.

Positive n1 qiYes big ticks at .ajor n2 gives big ticks for sUbintervals. ticks. The default values are n1,n2:6,-5.

intervals. Positive Negative gives s.a11

la29.ltl~!!!ig Each decade is labelled the saae. n1 controls the labels. If 01 1s positive, standard

notation, e.g. 10000, is used for t.e labels. If n1 is ne9a~i.e, exponential notation, e.g. 10., is used at inteqral povers of ten, and only the first digit is used for any interaedlate labels.

n2 controls ticks. If n2 is neqative, short ticks are used except at integral povers of ten. If n2 is positive, long ticks are used exclusively. In any case, the magnitudes of n1 and n2 make bit patterns which specify the positions of interaediate ticks and labels, according to the following acheae:

1 2

2**n

!gAning

10 inter.ediate labels (n1) or ticks (n2) Label or tick at all positions, 2 thru 9 tabel or tict at t~e n-th position

(1 sua eay be used to specify more than one position at a time, except for the values t and 2. Thus, n2 = -36 specifies a saall tick at 2 and 5, since 36 = 22 + 25 .)

BASE n affects only the labels .ade on loqarithaic axes. The default is 10.

(JS!B n invokes scaling given by user routi.nes FUNCTION TDFNCT(COORD,B) and SUBROUTINE TDTICK(N,VftIH,YftlX,M1,N2,BASE,NUM,VALS,ITYPES). N is the scale identifier. (SEe Appendix c.)

15 TOP DBlI!'--l Proqraa to Draw Plots and Graphs

-.---~----------------------------------------------~ SET SIZE xxx {BYl yyy (OIITs=units] ,

--.. --.. -.. ~ ...... .------~-- .. -..... -~ ... -..... .,-,..-----.... --.. -----.. ---.. -.-The ezact .eaniDg of this co •• and depends on the de.ice . in

ose. The SIZB of a plot is the actiYe area, iD which plott.inq can be done, and tkl. co •• aaa sets that area. The units are "inches", which aay be real inches in the case of hard-copy plots. Por hard-copy plots, and if the given values do not exceed tile size a1lo_e4 by the deYice" the gi'Yen values are.Qsed as real inches. 10 other cases the plot aade is the largest that vill fit" with the giYen aspect ratio, an4 the units are defined so that the ~lot 1s just the <Jiven size. This allows one to define a plot size" e.q. 13" by 10", and to use that size on any output deyice. If you plan to test on the '013 'scope, but to aate a final plo~ on caICo.p" it would be a good idea to decide the size first, and use tbat froa the outset. If soae positions, e.q. plot location and a~is title positions" are set by TOP DRAWER, and so.e, e.g. additional titles, are explicit" then chaogiaq the SIZE viiI change the relative posit.iofts of these ale.ents.

outr~geous definitions of plot size v111 produce reasonable plots, but the titles and labels aay be wrong" since the character spacings are defined in tenths of the noainal "inch". Eyen in the case of th~-~O" CalCoap plotter, in whie. the paper is unIt.ited in the x-direction" no plotting or characters vil1 be pat outside the actiYe area.

The default size is 13" (horizontally) by 10" (vertically).

'units' can be used to specify the nuabar of paper coordinate units which vill fit in ODe "inch". For instance, if you prefer to .easure Jour plots in centiaeters, put ORITS=2.5Q.

Exaaplp.s: Most of the paper will be unused if ~he default SIZE 1s allowed on the 29" CalComp plotter" and one "inch" is a real inch. On the other hand, one "inch" will be slightly less than one real inch if the default is used for the Versatec plotte~, which has a .aKi.ua width of only 10" •

.-.--.. -,. .. -.----... -.. --- .. -...... -.... -.--,..---- ... -.-.-........ ----..... .-............. ~-~ SET TICK (SIZE=nJ [[TOPIBOTTOftIRIGHTILEFT)

(ON I OFPI R11!Y~) ] [PLOT]

------------------~-------------------~--------------This co •• and sets the lenqtb of the (s.aller) ticks used on

the axes" and controls ticks on each axis. 'DEFAULT' is the sa.e as '011'. (The larger ticks are three tiaes the s·.aller.) The value specifiad is in "inches". The default size is 0.1.

16 'rOP DB1V!I--l Program to Draw Plots and Graphs

PLOT s19Dals that the labels and ticks are to be plotted i •• ediateiy, using the ii.its t.hAt are current.ly i.n force.

~-~-~-~--------------~~~~-~-~--~-~--~--~-~--~~-----~

SPIOOTH (liD {LEYEL n 1 [POIITS n lTO 02 J [LIST (n]]

~-~---~-~--~---~-~----~-~-~---~~~-------~--~---~-~--~

This co •• and replaces t.he ,-values specified by new values which qive a saoother cur.e. The values are smoothed according toa non-linear alqoritha which supposes that t.he given values are fro. a Ilistograa of equally spaced bins. It is relatively insensitive to fluctuations in inaividaal point.s. (The oriqinal values are destroyed.)

L!YBL=n refers, approxiaately, to the nuaber of points on eack side of the bin in question which vill be used in setting the "allla ·for t.hat bin.

LIST n vill canse the saoothed yalues for the first n points to be listed, in case they are vante4 for future calculations. (The job output is available throogh WYLBUR, if it is held, and could be used as .input to another job.) The default case is LIS! 0, which. does not list. LIS! is equivalent to LIST 10000.

POIITS n1 TO n2 specifies ·the points, currently present in the TOP DRliER point storage, which viII be treated. (Bellember that point storage is restarted with point 1 after each PLOT. JOIM, or HIST co •• and.)

~.--.. ---... --........ -.-.~ .... ...,~ .... -----.... --..... -----.... ----..,---.-.--.... -- .... ---SYltBOL (x] [SIZB n 1

SET stftBOL {xl (SIZE 0]

-----------------------------------------------------'l'h'e symbol • x' becoaes the symbol to be PLOTted for the

following points. It aay be specified b, one character folloved by a blank, by a t.o-diqi~ hex nuaher, or by a character pair fro. the U. G. extandec1' character set. !'lte 14 ttar two ar@ useful for specifyinq plotting characters, as describea in Appandix D. (In case of aabiguit, between the latter two, which are both given by tvo characters. the hex interpretation holds. This affects onl, the "both-arrow" character, whicb .Qst be qiYen by its bex code, 1E.) .

The default sy.bol is a blank or no character, vhich is plotted as a dot if zero error bars are specified. If 'SIZE n' is specified. n is the approxl.ate width of the plotted

17 fOP DRAWBB--! Proqraa to Draw Plots and Graphs

character, in tent.s of an "inch".

The. two fo~.s of the co •• and, stftBOL ••• ' exist only for congenience.

• StIiBOL ••• • and • S E1' They are equivalent.

----------------~---~--~---.~-~----------------------TITL! [lltIGt[DAT1] xxx JIY] {SIZI 11]

[lIGLE x] r SPACES D] • text'

[CIS! 'case teztl]

------------------------------~--~-------------------"te~t" will be written on the plot. It .nst be enclosed in

apostrophes or quotes~ 'Ihe title size and orientation, and the position of the first character are set by the other paraaeters on the card. If the text deli.iter (M or') appears in the text as vell, it sust be doubled. 'l'hns, 'This !xp"t' is equiyalent to "This Explt".

If DATA is not speCified, (XXX,11Y' are in inches, as for the SET lREA co •• and. T~ey give the coordinates of the center of the first character to be plotted. 'X', 'Y', or 'gl, •• y be used instead, tc) indicate tha x- or y-axiS ti·tle, or a 'graph t title which vill appear above the current area. If no position is qiYen, the text will be placed below the .ost recent title line.

If DATA is specified, (xxx,y,y) are in the coordinate s"tea of the data points, as set by the .ost recent SIT LlftI!S co.sand or operation with the data points.

"SIZE·' is the approxiaate spacing ot the letters, in tent". of an "inch". A negative size allows the character generator to be used, if it is available on the particular output device, and if the magnitude is correct. For instance, size -2 gives the character generator on the 4013 'scope, vhile -1, -3, etc., are the saae as +1, +3, etc.

"ANGLE" is in deqrees, aeasured counter-clock"i~ fro. the x-axis.

SPACES=n is used to tell TOP DRAiER how vide the I, I, or G title is, so that it can b~ eantarod. (ilhan tile .lltsnded character set 1s used, the nuaber of characters in the title may not be the sa.e as th4 nn.ber of spaces taken by the title.,

18 TOP DllIBI--l Progra. to Draw Plots and Graphs

CISB text is optional and aay appear on the saa. card or the follo"ing card •. The CISE text aodifJ.es tJae tITLE text that it follows.

"ca.se text" .ust correspond, character for character. to "'text" in the preceedinCJ card. Eachpai.r of characters. the first fro. the TITLE card and tbe second fro. the CISE card. aakes a character pair which vill be interpreted according to the O.G. extended character set specifications, described in the O.G. writeup. and briefly listed in Appendix D.

Por ex.aple. !ITLB I 'EOIP1=-1' CAS! t LCLGC

would produce the X-axis title ". to tile i pi equals .inus 1", since L as second c~aracter o.f a pair produces lover case Boaan letters, G produces lower case Greet, and OC and 1C are the control characters specifying, respectively, "enter saperscript mode" and "leave superscript a04.".

_ .... 4e_ ..... _..-.-, ... _ .. _~~ ....... \-: ... _ ..... _ ...... _ ... __ .• _. __ ... _ ... __ ~ ___ ....... _ .....

,

[ II Y I DI, DJ] [ (BINS, POIIITS) ([ n 1 '1'0] n2]] [FHOI! xxx] [TO :xxx] (BY xxx]

This co •• and can be used to put a liDear sequence of values into one of the data point or error arrays. It is particularly tlseful for doing the base a.is of a hlstograa, OJ: installing constant errors.

POINTS means that the values are to be generated as defined. BIIS gives values at the centers of bins whose edges are specified by the co.aand. Por instance,

I POII!S PBO! 0 TO 10 BY 1 gives 11 values: 0,1,2, •••• 10.

I BIIS PIO! 0 TO 10 BI 1 gives 10 values: 0.5.1.5.2.5 •••• ,9.5. POINTS is assn.ed if neither is specifie~.

n1 and n2 define the indices in the Top Drawer data array. If not qiyea. nl 1s taken as 1. thus,

X BIRS=10 PiOK 0 TO 20 giYes 10 values: 1.3,5, •••• 1q.

If there is insufficient inforaatioD to .ate the array. e.g. if only FRO! and TO are given, the current au.ber of data points is us~d for n2.

TOP 0111'81--1 Proqraa to Draw Plots and Graphs

II JOB ,CLlSS=! II EXEC LOlDGO, II LKEDPR!='IP=B1II', II LKBDLB2='Wtt.CG.RBC.L01D80DS', II LKBOLB3="YL.CG.RCB.UGPLIB·, /1 GOSL1='WIL.CG.RCB.OGXLIB', II GOBGI=200K

.. ,

IIGO.SlstII DD DSB=WYL.CG.RBC.LOID!ODS(TOPDRAV),DISP=SHB

Jct to define the output dataset (s) qoe. here. (See Appendix 1.)

IISYSII DD •

TOP DRAVEa Inpnt Cards Go Here.

19

To generate a standard set of JCL, if you are logged onto WILBUR, get yoo Top Drawer input cards in the active file. and

BXBCOTB PIO! VIL.CG.BBC.LIBtTDJCL 01 CAT CLEAR

TOP DlliEI--l Proqraa to Draw Plots and Graphs

sa"21! Card llmltt

TITLE 3 9.5 SIZE ~ 'Sl!PLE OUTPUT' CASI • LLLLt LtttL' 51'! lRBl Y 1 "0 4.5

800 3; ello 3 ABO 0: 920 13 960 17: 1000 18

1040 22; 1080 20 1120 25: 1160 211 1200 40; 1240 ·58 1280 51: 1320 36 1360 31i 1400 29 1440 26: 1480 16 1520 0: 1560 0 RIST SET ARBA Y 4.5 TO 8 BIST (SliCE 10 lEi POIITS HAYE BEll lED lB.)

(THBSE COBBIIOS OPERAT! OV ~HE OLD ONES) 5MOO'1'8 JOIN lEV PLOT SRT SCILE I LIIBAI 5 4 t LOG SP.T BIR SIZE .02 TITL! G 'PO-1 + P BIB' CASE 'GC C L A 1 C' SYMBOL 83 (RICHIIDS ET AL) ~I!LE 8 9 '3 RICHARDS IT AL.' CIS! 'P LLtLLLL tt LL' SBTORD!R I t Dt 718. 1.520 782. 2. 413 832. 2.11146 1005. 1.09 1 1106. 1.190 1249. 1. 190 143J. 0.661 SYMBOL B2 (NELSON)

.165

.264

.231

.165

.165

.132

.066

TITLB '2 IELSOM' CAS! 'P L;LtL' SET ORD!R 'I Y 2. 14 2 iDY 2. 42

(NELSON'S RESULTS DIFFBR BY 1 PACTOR OP 2.'2) 1590 • 212 .02 1790 .202 .015 1 q 90 • 21 5 • 0 16 2190 .170 .013 2390 .121 .010

20

·.~

. 3.0

2.0

1.0 0.9 0.8 0.7 0.6

0.5

0.3

800

H

+

1000

1000

1200

+ i

1500

1400

[] R1ChlJrds et al. <> Nelson

f

2000

21

1600

t 2500

22 TOP DIAIII--1 Prograato Draw Plots and Graphs

POBTB1B Calls

One aethod for aakiDg Top Draver plots fro. a user prograa is to write a dataset o~ eoaaands, vkick wl11 be read by Top Drawar iu a later jobstep. Top Drawer caD also be called directly •. saving t1 ••. and effort, at t.he cost of additional aeaory.

1.) Calling TDJOII. TDBIS'l. or !DPLO'f fixes the plot li.its if t.hey. have Dot been fixed already. If subsequent eal.1. vill contain points which lie beyond the points in the first call. the li.its should be set. by a SIT tIlInSico •• and (throuqh a call to TDSBT) or calls to TDLI!S.

2.) Top Drawer POBT!AN entry points vi11 generally accept either RElL or tHT~GE! arqu.ents. This is !9!·true for the yaloe and error arrays. which aust be REAL.

3.) Character string arqueaents which have no iaplicit length (for TDSB!. TD'iITL. and TDCAS!l .Qst end with a seaieoloD ';'.1 single sa_leolon to appear in the string should be doubled, e.g. ClLL TDTI!L('C1LL TDTITL("TITLE:;","X");'.'X')

~be value and error arrays I, DX, Y, and Df have diaension NP (or greater). DX and/or DJ aay be replacea by the letters NOIE [e.g. CALL TDHIST(50.X,Y.'NONE',DY)] and the corresponding errors vill be assuaed zero. If DX or Df is the last argu.ent in th9 call, it may be omitted witb the sa.e result. For instance, CALL TDHIST(50,X,Y) lsthe same as ClLL TDHIST(50.I,Y,'HORE','MOIE')

As a general role, leaviDg out the la~t Q{9UleDt in 0 c~ll produces a default value for the omitted arguaent. if such a thing has meaning. For instance. CALL TDJOIH(50.X.Y,'IONE','IOIE',O.O, is the sa.e as CALL TDJOIM(50,I.Y), but CALL TDJOIB(SO.X) is wroDq because a t least the 'x- ana ,-values for each point .nst be given.

The default values are 'NORE- for the error arrays DX and DY. and zero for other values.

23 TOP DI1181--1 Progra. to Draw Plots and Graphs

CALL TDBlfD eapt.ies 'rop Drawer buffers and closes graphic dataset.

CALL TDHIST(IP,I,Y,DI,DY) like HIST coa.and

CALL TDJOIM(IP,I,Y,DI,DY,IEVBL,!ODB) like JOII co •• and

CALL TDLI!S('keyvord',IP,YaLUBS.EBROBS) sets plot li.its

CALL '.rDM 11M (8) start~ Tog Drawer in card-reading .ode.

CALL TDIBIP('alias') like REI PLOT co •• and.

CALL 1DPLO!(HP.I,Y,DI,DY,·syabol t )

- llkePLOT co •• and

CALL TDSBT('text;') like SBT co •• and

CALL TDTI'l'L (. text; • , I, Y) like TITLE co •• and

CALL TOCAS! ('text: ' • • case text;', 'I, t) like TITL! co •• ana with fancy characters

CALL TDTSBT(SIZB,ARGLE,ISP1CBl additional para.eters for TDTITL or TDCIS~

See aboYQ, "Arrays", for a description of the data arrays t,DI,Y,DY, and their diaension NP.

The function of a subroutine is generally tbe saae as of the correspondin~ Top Drawer input co •• and. Befer to the eo •• and <1eseription -for a .ore co.plete discussion.

24 TOP DIAIER--A Prograa to Draw Plots and Graphs

-"'-"'-"~-'-'---"-'-""--"'''-''''''''''''-'''~''-'''''--''-----' ... .---............ ----... --C1L~ TDElID

.. -.. --... ~--- ... -------..... --~- ..... -.. --..... ..,.,.---.. -... -. .. -----......... -----fDEHD eapties TOp Drawer and U.G. buffers and closes the

graphic out.put dataset. 110 .ore graphic work should be done. TDBID should be called exactly once in aDY job •

..... -..... ---- .. -~ .. --- .. -.. ~-.--.-.-----.. -.. -----.-... -... ~ .. ---........ -.. --.. -.--CALL ~DHIS!(IP,I,Y,DI,Dt) CALL TDHIST(IP,I.Y,DI) CALL TDRIST(NP,I,Y)

--,., .. .----.. -- ... -.... ---.. -- .......... ----~---- .... ~.-,-........ -~ .... ., .... -.. .-, .. --.... ---.. -.. ~ TDHIST .akes a staple histogra ••

described for the KIST co •• and. Bin widths are as

-----------------------------------------------------CALL CALL CaLL CALL CALL

TDJOII(NP.I.Y.DX.~t,tE'EL.!ODE) ~DJOIR(.P,I,',DX.Dt.LE'!L) TDJOII(IP,I,Y,DX.DY) TDJOIH(HP,X,t,DI) TDJOIH (IP. X, Yl

-----------~--~---~-~~~--~~-~~-~-~-~-~-~~----~---~~-~

TDJOII provides the Top Drawer JOIN function.

MODE qives the type of fit to be used: KODE = 0 De.fault type (spline if possible).

1 spline. 2 "General" (Non-linear robust alqorith.).

KODE+64 DOTS

LEVEL is the number of straight-line seq_ents which viII be used in coonectinq pairs of the given points. LI'IL=O is default (Top Drawer vill choose, depending on the yalue of IP,.

\

.".....,.

'tOP ])1&111--1 Pro9'raa to Draw Plots and Graphs

-------~-.-~---------------------------------------.-C1LLTDLI"S('keyvord'.NP.YALUES,BRBOBS) CALL TDtI!S('keyvora',HP,'ltU!S)

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

25

This sets or resets a 1i.it or li.its for the plot. No plotting is done, and the arguaent values are not changed. 'keyword' aay be 'X'. 'X8111 , 'lftAl', "', "RIN'. or 'YR1I'.

VALUIS should be the array of x-values, if I, IM!I, or IRAI 1s specified, or the array of y-values if I, Y!IJ, or Ift11 is specified. BRIORS is the correspondiug error array, ei~h.r DI or DY. Both are RElL arrays of di.ension at least NP. The first RP values are used.

The plot 1i.i t tS) indicated by 'key"ora' is (are, set to the _tni.a. or aaxiaull value found in 'ALUIS. or Y1LUIS'tEBBOBS. If they are already set, the plot li.its w11l be expanded but not reduced by this call, so aultiplecalls with different arrays aay be used. (Co.pare the SET LI!IT co •• and, which resets without referaace to the previous value.)

.-...... .. -.-. .. - --- .. -_ .. ~ ... -----~~ ....... -.. - .... _ .......... --------... _ .. --........ ---- ..

CALL TDKAIM (H, CALL !DMAIN

.. .-_ .......... - .-.. -~------- .... --------..... --........ ----.--.-----.. ~ ... -~ .. This state.eD~ seads Top Drawer into its card-reading .ode.

Input co.as fro. PORTRAI unit 5, at its current position. The c6 •• and BETOR. or RE!UBR n causes a return, and if appropriate, N becoaes zero or the value fro. the RBTOBN co •• and. Top Drawer cannot read WYLBUR EDIT for.at when called in this .anner.

----------~--~~---~~~-~~-~~~--~--~-~~~-~--~~---~~---~

C1LL fDBBiP('alias') CALL 'TDNEWP (0) CALL ,.DNEWP

-----------------------------_ .....••.......•... --.--This starts a new plot. An alias may be q1.e8. and will be

used if the graphic output device Is appropriate (e. 9- 4013, DTC-300). Zero or DO argu.ent results in no alias being used.

TOP DllIEI-~l Progra. to Draw Plots and Graphs

----------~------------------------------------------CALL TDPLOTfIP,X,Y,DI,DY,'sy.bol', CALL !DPLO'1'(lIP.X.Y .. Dt .. DY) CALL TDPLOT (IP, I, t ,DI) CALL !DPLO'1'(HP.I .. Y)

26

TDPLOT provides the TOp Drawer PLOT co •• and. the default syabol is set by the SET 5Y"80L 'sy.bol' co •• and, e.g. by CALL TDSB!('S!T SYKBOL X;,).

CALL'l'DSET('text:"

TDS!! allows the progra •• er to use any TOp Drawer com.and beginning with the word 'SET'. The text of the co •• and (with or without 'SET') is the argument in the call. The tarminatinq se.icolon is required, since there 1s DO way in the local FOITaAI for a called routine to deter.ine the length of an arqu.ea't string. !xa.ples: CALL TDSET('SE'1' SI~! 10 BY 8;')

CALL TDS!T('LIMITS I 0 TO 86.2;')

CALL TDTITL('text;',X,Y) caLL TDTITL(·~ext:',fX .. t,or G'l CALL TDTITL('text;')

CALL TDC1S!('text string;','case string;',l,!) CALL TDCASE('text string;', 'case s~ring:'.'I .. Y or GI) CALL TDCASE('text strinq;','case strinq;')

CALL TDTS!T~IZE,AHGLE,SPACES,DATA) CALL TDTSBT(SIZE,ANGLE,SP1CES) CALL TD~SBT(SIZE,ANGL~ CALL TOTS!T (SIZB)

-------------------------_._-------------------------These routiDes provide the Top Drawer TITLE functions. A

call to 'rDTSIT 1s optional, to be used if the default. SIZE .. ANGLE .. SPACES .. or coordinate systea aren't wanted. A call to TDTSIT works only once--you must call TDTS!! every tiae you call TDTITL, unless the defaults are okay.

Tbe argo.ants X.Y aay be replaced by a single argument consisting of the character' I', Iy., or 'G', as in the TITLB

27 TOP DJAIBI--A Prograa to Draw Plots and Graphs

co •• and, or thay aay be oaitted to write a line directly under the .ost recent line plotted by TDTITL.

A Don-zero yalue for Dl~l .111 cause the positioD to be fiqurea in the data coordinate syste. rather than the usual plo~ "iaches".

TDCAS! is identical to TDTITL except for the added arqu.ent, which contains the string of second charac~ersfor each of the U. G. extended character set pairs.

Exaaple CALL TDTS!T (3.,0.,6, ClLL TDC1SB('PO-1PBP001M;',

I 'GC CL1GC CL:','X') vill produce th9 x-axis label ·pi-.inus p -> pi-zero n'.

28 TOP DBAWBR--l Progra. to Draw Plots and Graphs

YOU can 'use the standard PO~TB1. or MORTlll catalogaed procedures, with the folloving addit.ioDS:ltL.CG.BBC.L01DIIODS and VYL.CG.BCB.UGPLIB .ust be concatenated to the POI~Bll librarydatasets, and IfL.CG.RCB.UGILIB to the GO-step step library. In addition, the CJraphic dataset(s) .Qst be set. up for the GO-step.

The subroutines in question reside in a load.odule called WYL.CG.BBC.L01DRODS(TDEID). In order to call in all the subroutines, the user progra. .us·t contain the state.ent CALL TDBID, e·yen if graphic vork 1s ter.inated by a Top ·Drawer BND co •• and.

II JOB ,CLASS=! lIST EPOI! EXIC POBTftCG, II LKEDLB3=~VYL.CG.RBC.L01D~ODS', II LKEDLB4='IYL.CG.BCB.DGPLIB', II GOSL1:'IYL.CG.RCB.UGILIS', II GOBGI=200K IIPOIT.S!SIN DD •

1/­II· 11* 11* 11*

DlftEISION 1(101),Y(101) DO 10 1= 1, 10 1

I (I) =5.* (1-20) R1DI1M=O.017Q53*X(I) Y (I) =511 (R1DIAI) Z(!)=O.S*COS(R1DIAI)

10 COITINlJ! CALL TDJOII(101,I,Y) CALL TDTITL('y : sin(x);','G') CALL TDI':;"P CALL TDJOIN(101,X,Y) CALL TDJOIN(101,I,Z) CALL Tl}!ND STOP END

THE FOLLOMING Jet SETS OP THE OUTPUT DATASET FOR 1 TEKTRONIX 4013. O!HEB DEVICES COOLD BE US EO ALSO. (SEE APPIID!I 1.)

/IGO.VYLIPICT DD DSB=IYL.99.uuu.libDa.e,DISP=(IBV,KBEP), 1/ vOt=SBR=SCR001,UIIT=DISK,SP1CE=(TBK,(5,1,3,), II DCB=(RBCP!=PB,LBECL=80,BLKSIZB=1600) //GO. SYSII DD •

Input data, which aay contain ~op Drawer input cards, goes here.

Appendix 1 -- Specific Output DeYiees

The JCL for the output dataset could be:

IIGO.IYLIPICT DD DSI·ltt.qq.uuu.libna.e,DISP=(IEW,KBBPl, II YOLsSBI=SC!OO 1, UIIT=DISI, SPACI- (1'11, (5,1,3) ) , 1/ DCB=(ftBCF!=FB,tl!CL=90,BLKSII1=1600)

This is the default output deYice, and a SET DIVIC! 4013 •

29

coa.and is Bot necessary unless a different preYioasly specified.

deYiee vas

Plots for Tektronix .,013 t..rainals are .ada as a.abers of a partitiooed dataset. T.e first plot is aeaber PICT001~ and replaces any existing aeaber with that naae. Subsequent plots area.abers PIeTO02, PIC'f003, etc. To display a plot aade by a TOP DRAW!R b~tch job, you .ost sigft ont.o WILBUR on a 11013 terainal. Pat.ch the plot with the standard WILBUR coa.and

OSB I1bnameiPICT001 01 SCROD1 eLI and then "list" it:

LIST UIN eLBAH NOlL Plots are siailar to standard 80-coluan card i •• ges, aDd a81 be used, sayed, aDd aanlpula tec1 vi th sta.ndard WYLBUR co.aaDds.

The JeL for the output dataset could be:

IIGO.PLO!T1PE nn DSI=&&PLOT,DISf=(REI,P1SS), II 'OL=SER=PLO!AP.U'I~=T1P!7,tIBBt~(1,IL), 1/ DCB= (RBCPPl~U, D!I=O, BLKSIZE=3000)

top DBIWER input for CalColftp plots should be preceedad by the control stateaent

SET DIVre! 10" CALCOftP or SET DEVICE 29" C1LCO"P.

You aust sub.it a Job Instrue~ioD Card with the word "PLOTT~P!" under Volnae ftountinq Instructions. Put your ~f~ account Duabar, the plot size (10" or 29"), peD wid t.h (0.5 is okay), and paper 4esired (plain), under user co •• ents. Weekend CalCoap operators on cal pUS are sOJlJetilea less experienced t.han the. usual weekday staff. Plot tapes .ade·in the aorning .ay be retorned by tile afternoon o.f the following day, but f18-bour service is .ore usual. 'l'be process can be speeded by taking the. tape to the caapos center yourself.

Appendix I -- Specific Output Deyices

The JCL for the output aataset could he:

IIGO. PLOTD1~A DD DSI=-&SPLOT.-DIS.= (III, PASS) • II YOL-SIR:axxl:xxx,L1B!L=(1,SL) ,OIIT=~9-1600, II DCS- (lBCPft=='B,tBECL=1S00,BLKSIZE=1S00,DER=3)

30

TOP DBliBB input for the CalCo.p .icrofil. plotter should be preceedea by the control stateaent

SIT DBYICB 16-"" PIt! or SIT Dlftel aICRoPICHI

The plotter rufts off-liDe at present, ADd you .ust .ake an oatput tape. You .ust supply your ovn tape. When your job has run. you can ask fliclter Bryant to plot Jour graphic outpat. tape OD 16-a. fila or 105-•• fiche flla.

!he JCL for the output dataset could be:

IIGO.lfLYPICT DD~SI:WYL.gq.uuu.libna.e,DISP=(III.KBEP), II 'OL=SER=5CRO~1,O.IT=DISK,SP1CE==(!IK,(5,1,3)), II DCB~(~ECPM:PB,tB!CL=80,BLKSIZE='600'

TOP DillER input should be preceeded by the cont.rol· state.ent

SET DlfICI D!C-100: •

plots for DTC-300 ter.inals are .ada as aeabers of a partitioned dataset. The first plot 1s .e.bar PICT001. and replaces any existing .e.ber with that na.e. Subsequent plots are aeabers PIC~002, PIC~003. etc. To display a plot made.by a TOP DillER batch job, fOD .ust Si<JD onto WILBUR on a DTC-300 tar.inal. Petch the plot with the standard WYLBUR co •• and

USE libna..eIPICT001 OR Sca001 CLB ana then -list" it:

LIST UIH CLEAN lOlL Plots are siailar to standard aO-coluan card i.ages, and .a1 be used, saved. and manipulated with standard WILBOI co •• ands.

Appendix 1 --specific Output Deyices

The JCL for the output dataset could be:

IIGO. PICT!lPE DD DSI=&&PLOT,DISP= (IB.,PAS!) , II VOL-SII=xxxxsx,L1BBL=(1,SL),OIIT=T9-800, II DCBa (1Iep"=!'B, LI!CL=130, BLKSIZB=' 160, DBI=2)

31

TOP DB1111 inpo~ for the 'ersatec plotter should be preceeded by the control stat •• ent

SIT D!VICE '1100

tlse of th.e Data Analysis Group'. versatec plotter is on an infor.al basis. YOG .Qst ase four own outpnt tape aDd plot ~he tape yourself.

12 lP~Ddix B Interacti.Ye Mode

• prograa called BACK DOOI provides rapid turnaround £or aakiag ~op Draver plots Oft the ~ktroDlx '013, by 8sing tke interaetiY8 4013 capabilities of the U.G. package. BACK DOOI can access any dataset on a per_anentl, .ounted Yolu.e. The trick 1s that the user can leaye BACK DOOR and enter WYLBUR by typing the U. G. co •• and SltL(CB>. Once in IYLHU .• , the dataset can be edited, tile new version SAYBd, and control returned to BACK DOOR by typing tb~ ~lCK DOOR subsyste. na.e.

II JOB ,CLASS:I II EIEC L01DGO,LIEDPR"c::'EP=llAIlI', II GOPB~='SS'lftB=subsfste.,"lGICID~.agic·, II LKEDLB 2= IWYL.CG. RBC. L01DlIODS' , II LKBDLB3='IYL.CG.ICB.UGPLIB', II GOSL1='VYL.CG.RCB.OGILIB',GORGB=200K IISlstII DD DSN=WYL.CG.BBC.L01DKODS(B1CIDOORl ,DISP=SHR IIIIPU~ DD ONI"=DISI,'OL::eSEI=ltL001,DISP~SBB

S1gB onto iYLBtJll and sub.it this job, using your own subsyst.a na.e and aagic word (each of eight letters or fever). When tile job is running ,your subsyst.. naae vil1 appear in response to the co •• a.nd-·-·SHOI SYSTEriS. To leave WYLBUB ana enter BlCK DOOa, type your subsystea naa.. (The default subsyste. na.e is the" ~a.e as the job naae. The default aagic vord is IXIIIIII. Give the sUbsyste. a relatiYely unpopular Daae, like 11101 or ASP, rather than a popular one like DBli or B1CIDOOR, to avoid conflict vith other jobs using the sa.e ~a.e.)

B1CKDOOI text iDput is si.ilar to the 'YLBUR EDIT co •• ana, but there is no initial control character. The first ti •• you enter BlCK 0001, give the dataset na.e for the input file. The starting value is WYL.GG.OUU.LIB, which JOu could change, for instance~ to iYL.1B.XYZ.LIB'TDIIPUT, or to ilL.eD.ZIX.LOB. After that, a list of allowed co •• ands vill appear.

The ase of the SWyt co •• and, for returning to WILBUR, is unusaal. It .ay help to rea •• ber that this is a co •• and to tile progra. that runs the terainal, not to BACK DOOR. BACK DOOR never sees this co •• and, and bas no idea that you have changed the input file. Por th'is reason, the positioning of the text on the screen following the. return to BICK DOOa •• , be strange, and you should qtye a REi co •• and to tell BACK DOOBto restart the faa.) input file.

SlCK DOOR looks in the systea catalog to find the. inpat vo10.e. You can also set the volu.e fro. the t.er.inal. !'he vo1uae (e.q. VY~001) on the INPUT DD card is a du •• " but it .ust be given.

One final warning: you .ust give a STOP co •• and fro. BACK DOOR before fOU 109 off fro. ·WYLBUR. If you·aon't, you viII rea.in lOCJged on t.o flILTEI with BICK DOOR, but you .111 be uRablato sign on in order to sign off. (If this happeDs, PUBGE the job fro. another terainal with so.eone else's accoant, responding with your keyword when WILBUR objects.,

33 Appendix C -- User Scaling

It is possible to scale either or both axes., USiDg aD arbitrary function in the saae vay that logarith.lc scallnguses the logaritha. Functions which .1ght be useful are probability (nor.al probability distribution,. square root (for co.paring fits to experi.ental data,. etc. USER scalin9 re,aires at least one user POlDl1 routine to be loaaed with the profJra ••

If the co •• and 'SIT SClLE (XIY) USER (a]' is 91Y8D. ~op Draver vill call tile POICTIOI 'l'DFIC'r(COORD,I) each ti.e a point or tick is plotted, aDd the plotting .111 be done at a aistaace along the axis deterained by the .alae qiY8D by TDPICT. In this call, COORD is the appropriate It or y value, and I is an identifying non-negative integer. which is the value given by the USER D coaaand.

Ixaaple: IE1L PUReTIOI ~DF'CT(COOBD,I) BElL COORD II'f!G!lI 11 BElL Rill 1100.I,S~DDEV/5./,BOOT2/1.41'1 IP (I.EQ.2) GO TO 50

C LOGABITBftICSC1LIIG IP (COOID.GT.~) GO TO 10

TDl'lICT = -300. BI'1'URI

10 TDl'MCT.clLOG(COOltD) R!!UII

C PROBABILITY SCILIliG (EBP IS AI IBft-SUPPLIED RoUttII!) 50 TDPICT=BRP((COORD-"!11)/(STDDBY*ROOT2))

RETURt EID

If this routine is loaded with the Top Drawer routines, then the co.aand SET SCALE I USER 2 vl1l cause the x-axis to be scaled accorciiugto a noraal probability dist.ribution. ADJ other value for M, for instance froa the coa.and SE~ SClLB I USER 25, vil1 give logarithaic scaling.

lote: 1.;) Tile fUDction~is not told which axis is 1D.01ged. anel the sa.e function could be used for both axes.

2.) There is a check in the abore function aga1nst illeq8l values of the arguaent for the logaritha. Top Drawer aay exceed alloved Yalues, in settinCj Ii.its autoaatically or in trying to plot points or error bars that lie outside the li.its.

lppendl~ C -- Oser scaling

3.) liP is different fro. the noraal probability dis~ributlon fUDction by a linear relationship. Since the yalues8upplie4 by ~DPIC' are .apped onto the axia by another linear transfor.ation, an, linear function of the desired fUDction aay be used.

II.)~DPIICT should be a aOllotoDic fUDction of COORD.

34

Is is possible also to specify tbe position of ticks aloD! a user-scaled axis. ~he user .uat load

SUBROO!III TD'-ICK (I, '!IR. '''11, ttl., 12, B1S!,NU!, fiLS ,ITYPBSJ

Input Yariables: if III'!BG!B VIII REAL VillI BBAL 11,112 IITBGIR BAS! REAL

Output variables:

scale identifier fro. the SIT SelL! co •• and coordinate walue at the left (bottoa) edge coordinate .a.lue at the riqht (top) edge values fro. the SET SCILE co •• and yalue~o. the SET SCILI co •• and

MU! I.~BGER un.ber of ticks tbat the subroutine 91Y8S VILS RElL diaens!oDed array of coordiDateYalues I~tPBS IR!BGBB 4iaeftsioned array of tick/label types

)

to te put at the correspondiDCJ pOlJltioas.

11)!·

positive negative

*1 i:2 -t3 til

1I,aD1D5 .

big tick aaall tick no label Doraal label exponential label first 4eciaal digit only

35 Appendix C -- Oser Scaling

If the l'OI4fll I-call control .•• tJaod is used, 'l'DPIC'.r and TD'l'ICK can be included with the other FORTIAI routines. If Top Drawer isruD as a .ain progra., the following 4ec1t will work:

II JOB ,CLASS=! II BIEC POITGCG, . II LK!DPBft='!P=ft1IB', II tK!DLB2='VYL.CG.RBC.L01D!ODS', II LKBDLB3='WYL.CG.RCB.UGFLYB', II GOSL1~·W!t.CG.ICB.UGILIB·, II GOBGN~200K I/POIT.SYSIN DD •

I'tJtfCTIOtf TDllCr ,'ILOE, N) ... END SUBBOOTIMB TD~tCK( ••• '

BMD IIGO.SYSLIW2 DD DSH=WYL.CG.RBC.LOAD!ODS(TOPDRAI),DISP=SHB

Jct to define the output dataset(s) goes here. (See Appendix 1.)

IIGO.SISII DD •

TOP DRAiER Input Cards Go Here~

36 Appendix D -- The Unified Graphics Character set

The U.G. Syste. aodule UG1103A, invoked in loading TOP DRAWER, has an expanded character set whicb includes upper and lov~r case Roman and Greek letters, .any special characters, and any nu.ber of levels of sub- or superscripts. These characters can be specified by encoding the proper hex code on a TITLE card, or by specifying the proper character pair .ith a TITLE card followed by a CASI card. The following table is taken fro. the {J.G. writeup. It gives the hex code. the character pair, and a description of each character. Figure C.1.1 of the U.G. writeup shows all the cbaracters.

Hex. Char Character £2~!_Eli,--_n!fi£I!2tiQn

00 01 02 03 04 05 06 07

10 11 12 13 ,,, 15 16 17

20 21 22 23 24 25 26 27

30 31 32 33 34 35 36 37

S Null AG L.C. Alpha BG L.C. Beta GG L.C. Gamaa DG I~. C. Del ttl EG L.e. Epsilon ZG L.C. Zeta RG L.C. Bta

1S Interbang KG f •• C. Ka!lpa LG L. C. Lambda KG L.C. flu NG L. C. Nu XG L.C. xi OG L.C. oaicron PG L.C. Pi

~x ~e.bership Symbol NX Meabership Negation EX Existential Quant. 1X Universal Quant. TG L.C. Tau OG L.e. Upsilon PG L.e. Phi CG L.e. Chi

oC' Entar Superscr !od~ 1C Leave superscr Mode 2C Enter Subscr Hode 3C Leave Subscr Moda 4C Save position-1 5C Restore Pos-1 6C Saye Position-2 7C Restore Pos-2

Bes. Char Ckarac~er ~g~-f!!~ ___ R!~c,ip~t9D

08 09 01 08 OC OD OE OF

18 19 11 18 1C 1D 1E l'

28 2<J 21 2B 2C 2D 2B 2P

38 ]q 31 3B 3C 3D 3E 3P

OG L.e. Theta IG L.C. Iota IS Integral Sign IS Tiaes Sign :5 Division Sign ES Approxiaately Equal PS Partial Derivative DS Del

RG .L.C. Bho SG L. C. 5ig_a 01 Up Arrow Dl Down Arrow LA Left Arrow Rl Bight Arrow BA Left/Rigbt Arrow

Unassigned

YG L.e. Psi WG L.e. a.ega IX Intersection 01 Union <x Contained in >X Contains LX Contained in/Equal RX Contains/Equal

BC Sa va Position-3 9C Restore Pos-l

Unassigned unassiqn@d Unassigned Unassigned

Ee Increase Size PC Decreasa Si2e

37 Rex. Char Character Rex. Char Character £g~!-EJi'-__ ~£[in11g) ~!-lllL • De§!ii1Rti2!!

rao Blank 48 Oft o.c. Theta 41 A8 o.e. Alpba 119 IH O.C. Iota 42 BH O.C. Beta III , Cent SiqD 43 GB u.c. Ga.aa liB • Period

." DB O.C. Delta lie < Less Than 4S EH u.c. Epsilon flD ( Left Parenthesis 46 ZH n.e. Zeta 4! • Plus Sign 41 8ft D.C. Eta 4P I Vertical Lille

50 & A_persand 58 BH U.C. Rho S1 IH O.C. Kappa !S9 SR D.C. Siq_a 52 LH D.C. La.bda 51 t Excla.ation !ark 53 .. 8 U.C • Ku SB S Dollar Si9ft 54 NH U.C. lIu 5C • Asterisk 55 18 u.c. Ii 5D ) Riqht Parenthesis 56 OR G.C. Oaier,oll 5! • Sa_i-colon • 51 PH u.e. Pi SP L Not

60 Plinus Sign 68 YO o.c. Psi 61 I Slash Mark 69 liB O.C. ollega 62 +S Group Plus 61 GS Dagger 6.3 *s Group Multiply 68 • Co •• a 6q TH O.C. Tau 6C I Percent 65 OR (J. c. Upsilon 6D - Onderline 66 FH D.C. Phi 6B > Greater Than 67 CR tJ.e. Chi 6P ? Question Mart

70 tJnassiqned 78 LS Left Angle Bracket 71 Unassigned '79 RS Right Angle bracket 72 UnassigDe4 '71 '! Colon 7,1 Unassigned 1B • Poond Sign 74 Una ssigned 7C i At SiqD 75 tJnassigned 1D , Ap'ostrophe 16 Unassigned 7! = Equals Sign 77 Unassigned " .. Quote Plarks

80 Unassigned 88 HL L.C. H 81 AL L.e. A 89 IL L.e. I 82 BL L. C. B 8A Unassigned 83 CL L.e. C 8B AS Left Brace 84 DL L.e. D 8C <s tess or Equal 85 EL L.e. E 80 Unassigned 86 PI. L.e. p 8E HS H-Bar 87 GL L.e. G 81' is Laabda-Bar

90 unassigned 98 OL L.C. Q 91 JL L.e. J 99 iL L.e. R 92 KL L.e. K 91 Unassigned 93 LL L.e. t 9B ZS Right Brace 94 r1L L.e. M 9C (Jnassi9 ned 95 NL L.e. N 9D Unassigned 96 Ot L.e. 0 qE ss Plus o.r "inns 97 PL L.e. p 9F Unassiqne{l

38 Hex. Char Character Hex. Char Character ~2~!_f~i'-__ R~§~~i!\~qD C2d'-E!iI-__ a~S~'!R!!2!

,-.... 10 unassigned 18 yt t.C. t A1 OS Deqrees 19 ~L L.C. Z 12 SL L.e. S 11 unassigned 13 TL L.C. T IB Unassiqned 14 UL L.e. u Ie Unassigned AS VL L.e. , AD (S Left Bracket 16 iL L.e. , IE )S Greater or Equal 17 IL L.e. t lP OnassiC}Ded

SO OP Plot Sym , Cross Be 8P Plot Sym star 81 lP Plot Sy. D Cross B9 9P Plot Sy. octagon B2 2P Plot sy. Dia.ond Bl Unassigned 83 3P Plot Sy. Square BB (Jnassiqned 84 4P Plot Sym P Dia.ond BC onassiqned BS 5P Plot Sy. F Squa re BD )5 Right Bracket 86 6P Plot Sy. P , Cross !E =s lot Equal B7 7P Plot SYIl F D Cross BP (Jnassigned

co Unassi<]ned C8 H U.C. H C1 A U.C. A C9 I O.C. .1 C2 B u.e. B CA l' Half up C3 C D.C. C CD 2' Half Down C4 D U.C. 0 CC ]y Third Op C5 E u.e. E CD 4V Third Down C6 p O.C. P CI 5V sixth Up C7 G u.c. G CF 6' si][th Down

DO ou Backwards Blank D8 Q U.C. 0 D1 J u.t. J n9 R u.c. It D2 K D.C. I Dl 10 Extra Half Blank D3 L D.C. L tB 2U Half Back Blank D4 M D.C. M DC 3U !~tr~ Third Blank D5 N o.c. N DD 40 Third Back Blank D6 0 u.c. 0 DE 5U Extra Sixth BlaDt D7 p {J.C. P DF 6U Sixth Back Blank

EO IS Backwards Slash !8 y u.c. y

·E1 Unassigned E9 Z n.c. Z

'E2 S D.C. 5 EA Unassigned E3 T u.c. T EB Unassigned E4 U TJ.C. U Be Onassiqned E5 V u.e. v !D Unassigned E6 w u.c. M EE Unassiqned E7 X tJ. c. X IF Unassigned

PO 0 NUlBeral 0 18 8 lf1ll,ro1 e P1 1 Numeral 1 F9 9 Noaera! 9 F2 2 Numeral 2 PA Unassigned F3 J !fll.eral 3 PB Unassigned P4 4 IUlleral q PC Unassigned 15 5 IOlleral 5 PD Unassigned 13'6 6 Numeral 6 'fE Unassigned P7 7 Mtillera 1 7 pp OS Infinity