SLAC coaputat1on Group Stanfotd, Calif~rDia

GRAPHIC KIOIA

Boger Chaff ••

ABSTI1CT

CGT. 10. 1.9 august 1973 ••• :1. •• 4: october 1916

MASTER COP~ J!UDt R£MOV~

. S11C kIOIA can make histoqraa., scatter plots, and Gaussian ideoqrals on graphic 48wices such as the cal-Coap plotter and Tektronix 4013 terMinals. output is fot &hY of the non­interactive devices known to the SLAC Unified Graphics System.

Working Pilps·r Do hot IIU ••• , eit., bb:;i .•.. ": ... t, j .t ,.~uc. withnut prior

IM"''''-'' of tho luthl'Jr(sll r...-......................... ' .............. !

cont.llts

I. !ntrcduction •••••••••••••••••••••• 3

It. '.ceasar, Changes •••••••••••••••••• The laay Vay •••••••••••••••••••• General •••••••••••••••••••••••• 5 cal-Coap Plota ••••••••••••••••• , Unified Graphics Ela •• nts •••••• 7 4013 plots ••••••••••••••••••••• 7 Microfiche and 16-•• Fil ••••••• 8 Genco •••••••••••••••••••••••••• 9 'era.tee Plotter Model 1100& ••• 9 on-Lib. 'eraatec Plots •••••••• 10

III. Optional ,eatures Axis Labels ••••••••••••••••••• 1' Superiaposed Curves ••••••••••• 12

.': ,.1".,.,pr •• s!oa, ..•..•..•••... l'

I. tDtroductioa

1 subroutine package has been writtena for SL1C 1101 •• which wi11 plot bisto9ra.s, scatter plot., aa4 aaa •• ian idGogra •• using the StAC Unified Graphic. syat.... a~apklc output can be pro4u~ed for any of the nOD-iat.racti •• a •• 10 •• known to the Unified Graphics S1st •••

Additions auat b •• ade to the uset's JCL and Linka,. 141tor input, to define additional file. and to proc ... tb. 10aa .04,,1.8 for th. ad4itional IIOWl rottti~.a and for the Unifiea Graphics System routines. '.cessary chan, •• are disc ••• ea 1n s~ction I!.

No changes in the user's PORTR'I are aec ••• ary, although there are options for aore elaborate labellnq and superi.po •• a cur.es which are not available in the lia.-pria4!er output. Bach plot is put out on both line-printer and graphic 4e.lce, ubl ••• suppressed by the user. rOITall ad4itiona are alae ••• ea in section III.

- - - --- --- -t) The ori~inal KIOll with qraphiea ••• written

for the Lit (Berkeley) CDC-6600., ,'riea •• a aDa Rittenberg, £IZ-.112ll_-'QI_-lkl __ 'Rk~. Group 1 Progra •• lnq Mote No. P-173, 1968) ~bI ••• r8ioa ha. been revritten, but .any of the original ideas and aethods raaain.

2) Chaff.e and Pried.an, ~~I1Q'l&_-'iII-_l2. J!L...ilulU_lllJ •

!~'§i~~~ac~GT"I~_~j~~~:~~4;;~~~R_i'I._a!11AI1

• 11. ..c •• sart ChaR9 ••

the iftfo~ •• tion in this •• e~ioD i. d.p •• aent on tb • • n.ircn •• nt that SLAC KIOI, liye. i.. tb. Unif1.4 a~.phic. Syate., and 'iLBUI are u .. a; ib addition to the !ripl ••• ,at •••

The ehanq8. to an oparatiD9 KIOll job which are .ece.aar, for it to produce graphic output, 1 •• 01.. the follo.iag probl •• sl

1., The KIOIA graphic tout1b •• lust be 10&4.4 br the tinkage Editor. (The toader do.. lot 40 It properly.,

2.) the Unified Graphics Sf tal routin ••• nat b. apecifiaa and loadea. This inyol... .aditioD.1 data.eta for LK!D.StstI~ aha GO.S IPLIB.

3., Tvo aore fil ••• ust be efin84. One, with the d~na •• ··''119.001", ia a aerat h file which i. u •• a whenever scatter plots are dravn !h. otber, with ddnaae "UGDEVIC!", depends on th a •• ice u •• a for the picture ••

u., The output devk. .net be specifiea ill POP.'.tRAN.

Sections A and 8 balow have 1nforaatloD vhich applies to any G!lPHIC kIOWA job, regardless of the output d •• lc •• subsequ~nt sections deal with specific devic •••

A • lllLlln..l!Jl There is a WILBua ex.eftl. which vi11 change a atandard

SLAC KIOWA job into a GRAPHIC KIOWA job. Set up a IIOll job, tgady to run, in the active file, and

EXECUTE raOM wtL.CG.RBC.LIB(GBAPHICS) 01 CATALOG eLBa.

B. illli.l

The proper ae,ice naa •• uat be set fo~ the laltital call to the Unified Graphic. package. ~hi. ba •• 1. eight Hollerith charact.re long, and 1& •• t in a cOlao. blook.

COM NOM IPIUMI!I DEVICE BEAL.8 DEVIC! /8Hunitna •• 1

unitname

C1LDBSf!. C1LDBLG· PD54013. PDSPOIV· C1II1U16* CltrICH· PDS3000* YBP1100· '11»12"· VIP12Cll·

Equip.ent

10" cal-Ccap Large Cal-Coap Taktronia 401] tar.iba! U. G. internal .l ••• ats 16-al Unaprock.ted Pil. 105-•• "icrofich. GebCo. 300-Q ~.r.ihal 'ersatec Electrostatic Plotter (804.1 11001, On-tine Plotter ('anfold Paper, . on-tine Plotter (coatinuous loll)

The DOMl"B for the output file in the dCL au.t correspoD4 to th4 deYiee ha •• in the PORflll, or the job will be kill.a by the Unified Graphics package. ~

(The inforaation in this CO •• OD block, plu8 th.· option rULscB, is used a. the options list for the call to UGOPII. Nor.ally only the d •• ica 1s necessary, but other option. could be included.)

The LiDkaqe Editor input must contain a atat ••• nt iDyokiDg the "PIX" loadmodul., as well as any other .tat •••• ts that the usual KIOWA job requires:

IILKED.SYSIN DD • INCLUDE SYSLISCPII)

•

Jet auat point to the Unified graphic. 10&4 804.1 •• , •• well a8 the atan4ar4 K%OIA .oaul... lb. fol1owla, IIIe atat ••• Dt vill 40.

II IXBC rOBTHCLG, II tl!DLBl~t'tt.Cg.RBC.t01DIODI', II LIIDLB_=tltt.CG.ICB.UOP!ILIB·, II OOSL1·'IYL.CQ.RCB.UGIUILIB', II GOIGH=300k

A acratch file, in addition to th. usual rT03r001 file, .ust be prov14.a if scatter plots are •• d8:

IIFT19F001 DD UIIT-SISD1,SP1C!2(CtL, (1,1,), II DCS=(BaCra-VIS,LIBCL-180S,8tkstll-3614)

And finally, a dataset .uat b. ~.fiD.d for th. 9raphic output. !he details aepend oft tha de.ice type. The correCt JeL is gi.en in each separate section below.

c.

ot

A 'O~tB1N block data routine should contaia CORfta. IPIUNITI DEVICE R!AL*S DEfIeS laBelLDIS".,

CO!!ON IllUMITI DEVIC! BEll*S DEVIC! 18RC1LDBLG*'

for the 10-inch and 33-inch plots, respecti •• l,_

The correct JeL for the output dataset i. IIGO.UGDEVIC! DD DSR1MEs&&PLOT.DISPa(IIV,P1SS" II VOL=SER=PLOT,UIIT=T9-1600,L1BIL=(1,SL), II DCB=(~ECrR=p,LRECL:480,BLI5ItE.480,DBI=3'

You .ust also subait a Job InstructioD Card with the vord "PLO'l'T1P!·· under VoluBle Rountinq Instructions. Put your '112,1 account number, the plot size (10" or 33"), pen width (0.5 • okay), and paper desired (plain), under user co ••• nts. ,.etand Cal-ccap operators on caapus are soaetiaes less experi.ncaa thaa the usual weekday staff. Plot tapas aad. in the aorning a.y be returned by the afternoon of the following day, but 48-hour service is mote usual. The process can someti •• s be apaeded by t.aking the tape to the campus computer center yoursell.

o. J1aU114 iI'Rhi~LI1u~1

A POITIA. block data routine should contain COIMOI IPIUMI!I DEvtC! REIL-a D!YIC! /8HPDSPDE'*/

Possible Jet for the output dataset is IIGO.UdD!VIeS DD DSI-Vtt.Xr.18c.DISkPDS,D%a.-(I.I,KIIP" II YOL=5EB~SCR001.UHIT=231.,SP1CB·(TBI.(5,1,3'), II DC~=(PICP"=n,SLK5IZ!a3520)

1

The Unified Graphics System plot eleaenta, which ca. subs~qu.ntly be translated by the U.G •• fat •• iato • plot for ftny ftl10wed device, can be sayed in a partitioned data set. fh • ••• ber na ••• are PICT001, etc., and are the •••••• for the plata for the "01.3 ter.inal. The advantage of thi. type of output is that the plots dan be yi ... d with a aiap18 pro9raal oD any available device, such as _013 or 2250, and •• lect.d plota then put out on cal-coap or any ~tb.r a •• ice without re-tUDAiD, the KIOll job.

E.

- . ---. -. - - .

1 FORTBI. block data routine should con~aln COMMON IPXUMIT/ DEVICI EEAL*B D!YICE IBHPDS4013*/

Possible Jct for the output dataset 1s IIGO.UGDEVICE DD DSN=WtL.XY.1BC.IYL4013,DISP-CIBI,KBI'" II VOL:SEB=SCB001,ONIT=231~,SP1CE=(TIK;(5.1,l). II DCB=(BEC1H=re,LRECL:80,SLKSIZE=1600)

plots for the Tektronix 4013 terminals are .ada as a •• bera of a partitioned data set. The first plot, histoqra. nuaber 1. 1s .ade as membar PICT001, and replaces any exist1nq ••• ber with that naae. As with a replace.ent fro. "tBUR, the discarded space is no~ available until the dataset is conden.ea. Subsequent histograas, theh all the scatta~ plots, then all the Gaussian ideograms, are tamed PIC!002, PICT003. and so ou. th. plot of histogram number 1 is also 9i.80 the alias HIsr001. and may be referred to hy that tame. Similarly, the scatter plot .embers are qiven aliases starting with PLOT, and the 1deoqraa members are qiven aliases starting with GBIM. '0 display a plot which has been made hy a KIOWA batch job, the user .uat be signed onto WILBUR using a 4013 tar.inal. 'atch the plot with

the standard WILBUR co •• and USI ItL4013'PICt001 01 SCI001 etl

and then "ll.t~ itl tIst UI. CLIA.

•

H1stoqra •• f111 the apace of about a dO •• D eO-col... cal'd •• Scatter plot stor&9. ae~.a4' Ob the au.be~ of poiat.,aa4 requ1r.s on. 80-coluan card for .ach aia or ••••• polDta. 'lotl .ay be .a~ipulat.4 with standard l'tBUt co •• aaa ••

I. %_. C.~g.i.lig,gfl1. I1Qt~ Thia output 1s proce.sed without. u •• r tap., OD the SLAC

site. one-day service 1. pto.1.e4 except OD ••• k •• a., .aa it i. q.neral1y auch better ~haft that.

jA:.I.Dlla;gg.'tl4.lill

A rOITllN block data routine should oontain COMlot IPIUII!I DI'ICI ' 111t*8 DEVICE 18HCAL1e~d.,

-' Po.sible JeL for th. output dataset 1s

IIGO.UGDBtIC! DD SIS0U!=X, II DCB:(BECrRsr,Lllctz1~80,BLISIZI=1.80)

A '08TP1M block data routin8 should contain COMBOM /PIUIITI DEVIC! PilL.S D!VIC! IBHCAtPICH*/

Possible Jet for the output dataset is IIGO.UGDEVICE DD SISOU!:Z. II nce:(~ECr"·p,LJECL=1480,BLKSIZE:1480'

G. iIACRI-ZUJiDa11

1 PO'!I'. block data routine ahou14 cODtai. CO!ftOI IPIUlltl DEVICE 111L*a Ditzel 18HPDS300Q*1

Po •• ible Jet for the output dataset i. IIGO.UGDIYIC! DD DSI·IYL.IY.1BC.VYLDTC,DISI-,I.I.III." II bC8*(IBCrS=PS,tIBCL*80,8LKSIZI-1'OO'i II 'OLzS!B=SCI001.UMI'-231',SP1CBa('II,(5,1,3,)

,

Use is the 8&.0 a. vith the 401] tar.inal.. ,.tch the plot with the .taDdard 'fLBOa co •• and

USE Vt£DTctPICf001 01 SCI001 eL! and "list" it:

tIS! UN. eLlA. 10It

IU'! .•• ,I ' III, !Itllts, IH.i ..... IaUl..J.l~' A FOBTll. block data routine should contain

COMMO' IPIUIIT/ DEVICI l!lL*8 D!YtCE left'EP1100*1

possible JeL for the output dataset is IIGO.UGDEVICE DD DSI:&&PLOT,DISP=,IEI,P1SS,. It UJIT=19-800,YOL=SEB=ASCDBP,L1Blt=(1,SL" II DCS:(RECP!=t8,LRICL~130,BLISIZI."60.DB •• 2)

Use of the Data Analysis Group's 'ersatac plotter 1. OB an informal basis. tou aust supply yoar ovn 9-track, 800 atI tap. (volume lBCDEP in the abOY8 exaaple" and arrange to plot it yourself.

I. Oa-LiDI.1II •• tlQ I.atl lA-Ca,' SgEl

1 POBTllW block data routlbe .hou14 coat.i. eOllOI /PIUMITI DIYICI 81&t.8 DI'Iel 188YI'12rr.,

or eORMal I'XUIITI DaYlel I!At.& DIYtCI 18H'IP12C •• 1

for fan-fold or contibuOU8 roll, respect! •• l,.

10

!be Jet needed to .ake on-line plot. with the Oalfl.a draphics Syate. ha. Dot b •• n decidea at ikl. w~iti.9. Co.sult the coaputer Ser,ices Bulletin.

In case of large nuabers ot points 1n 8catter plot., the aeaorf require •• ftts 14, be •• ces.i.e, aaa th •• at.rD.1 .ort option of the U.G. .yst •• v111 be n •• ae4. In thi. ca •• , the PORTilN vi11 be

or

CORROI IPIUlli/ DlYZel BEAL*8 bafleD (2) bAtA DIVIel 18B'EP12rr, , 881If801'*/

COM!OI IPXU.I~I DltICI BEAL.S DlfICI (2) DATA DltIeE /88YEP12CB, , 8HII1801'*/

In this case, the Jet for the deYice will be IIGO.UGDEYICE DD DSI=&&PLOT1,DISP=,M.I,PASS), II UNIT~stSDA,SPACE:(CYL.S), II DCB=(RECPN=rS,LB!CL=12,BLKSIZI=1_.0)

The entire KIOIA step vil1 be follo •• d by a 80rt step aDd , "print" step. Again, consult the Computer SerYic •• Sullettft, or the U.G. vriteup, when the details are known.

11

III. optiobal Paature.

this .ection a.seeib •• the featar.. • •• 11able 1n a.APlie KIOWA which at. not a •• llable in the l'.8-printer output. the, are atrictly ibte~n.l to KIOIA, aDd 40 Dpt a.,..4 •• pl1cltl, OD the SL1C ~DYiron •• Dt.

l. .6111 LIHlaI

GRAPHIC KIO.' has an option for inserti.9 abaci... aDd ordinate lab.ls on hlstoqra •• , scatter flota, •• a dau •• iaa id~oqra.s. Plot title. for th_,graphic dlsp .ra are In •• rtea in the sa •• vay as for the line-printer output, th.t 1., by .toriDg the titles in the appropriate locations 1D the CO •• OD bloct. IHIstLB/, I'LOTtS/, or /GI1!LB/, and setting ILlSILII)-1, where t 2 1.2, or 3 for histoqr ••• , scatter plota, and Ga ••• ia. ideogra.s. ILA8Jt is found in COHIOI/otlBIL/%LlBILll)

'. Allia labela uti ,1,~8ert.d in an anal0901l8 •• an,r. '0 •• te .~l1is labe1a, .~itll .1 titles, OD all hi.to9ra •• , •• t ILAB~L(1)=2 by a·r~ace •• Dt ~tate •• nt before tbe at.t •••• t CALL COCHIS, or in a BLOCK DA!l routine. To ia •• rt ,-.aia l.bela, II Il~ x·axis labels and titles, on all hlatogra •• , •• t ILiBItl1) =3. Axis labels for scatter plot. a.a Oau •• iaa ideograls are set up sililarlr' the flag for 8catter plot. 1. tL1B!L(2), and that for GaUS8 an ideogra •• ia ItlBlt(~).

The abscissa labels are stor.a CO •• OD blocks:

CO!!ON/dIS~LX/Ht( 8,IHISTS) COKMO./PtOTLJ/PX( 8,IPLO'S) COftKOM/GBAMtI/GX( 8,IGR1"S)

The ordinate lab.ls are stored C~UlUlon hlocks:

COMKOM/HISTLY/HY( a,RBISTS) COMMON/PLOTLt/Pt( 8,NPLOTS) COMftON/GBAMLt/Gt( e,NGRA~5)

in the followl_, labelea

for hietogra •• ; for scatter p1ot_: for Gaussiaa la.oqr ••••

in the following labelea

for histog!: ••• , for scatter plotsl for GaU88ian ideoqr ••••

GP.A~HIC KIOWA allows an arbitrary nuaber of user-coa.a curves to be plotted on each higtogrll or scatter plot. b.ar­coded curves aay not be superimposed on Gaussian 1deoqraa ••

r

12

If no .or. than on. cur •• i. to b. dr ••• 08 •• ok hl.togc •• , theh th. us.r-coded fttDctiona are superi.po •• a in t~ ••••• aanner as for the line-printer .ersiob. Ie order to p.' .ore than one cur •• on a hiatogra., the followiag rOI'lll atate •• at .~st be included in tbe UlUM routine:

CO!BON/UPUJR/RULT The progral v111 set !ULT=O for the first entry into the ural routine for each plot. Safore returbiag. the u •• r a.at •• t IUtt to the total nu.ber ot curves to be drawn for tk. plot. BULt th8h is the flag indicating whieh cur •• the calliDg pro9raa i. plotting on each succ.asi.e entry- MUL! will kay. integ.r yalues decreasing fro. the ftuaber .et by the u.er at the fir.~ .ntry down to 1.

When all curves ha •• b.ln plotted on a 91.en h1stogr •• , the calling prograa will set MUtf*O ana call urol for the .eat histoqr&1 vhich require. a cur... Th. u.er can .et IULt to the nu.ber of curves for this next plot, and 80 08.

consider the following exaapla: suppose the f.nctlohs x-, X1, x-, and •• are to be superiaposed OD the third hi.tograa, ar.d sin2 x and cos2 t ate to be plotted on the fifth. The urul routine could be coded as followaa

rUNC!IOW UPUI,I,.) CORMeN /UrOIB/ MUL' IP (N.EQ.3, GO !O 1 IF (B.IQ.S, GO TO 10 RE'IUIUf

1 t, (MUtT.lQ.O) "UtT = ~ GO TO (2i3,~,Sl ,MutT

2 UPUN = 1**2 BETUEUf

3 UPOI = X •• 3 RETUfH

4 UfUN :: X •• " 8ETU!N

5 UFUN = X •• 5 BE1:UiN

10 IF (MutT.!Q.O) MULT = 2 GO TO (11, 12) , MULT

11 urUN = 51N(X) •• 2 RETUPN

12 UPUN = COS(X).*2 RETUIM END

1]

&5&.t\., Platl

User-coded curves are sup.~lapos.d OA 8Catt.r plots 1. • lanner 8iai1at to that fot the lin.-printer •• raioa. How.Y.~, there are two lore r •• triction81

1. Each cur.e .uat clo •• back upon l~ •• lf. 2. 1 cur.e .uat nat inter.ect it.elf. Bo •• y.r, a

cur,e aay intersect oth.r cur ••• on the plot any nu.bar of ti ••••

The second •• 1 be circu •• ented by plottiag •• parate part. of • cury. as separate curvas.

If no more than ona cur •• is to be drawn OD each 8catt.r plot, then the UPLot routine 18 coded the sa •• aa for th. line­printer v.rsion of KIOI1. If there are .ttltlpl. cur... to h. drawn on ohe ~lot, then the curves aust b. Auaber.a with a sch •• e like that for hlstoqraas. The lollowiag PO.'lll statement lust b. inserted:

COMMOI/UPtOTM/MULT The calling program vill set MULT=O for the first entry iDto the UPtOT routihe for each plot. Before returalng the u •• r •• at •• t "utT to t.he total nu.ber of cury •• to ba drawn OD the plot. ButT then is the flag indicatih9 which cury. the cal1in9 prograa is plotting on ea~h successive entry. "UtT v111 haye lat.9.~ yalues d.cr~as1n9 f~o. the nuaber set by the u.e~ at the first entry dovn to 1.

As in the line-printer version, UPLot should be •• t to 1.0 or to th9 Hollerith con$ta~t ~H.ONE fo. tho •• 8catter plota which are not to have any curves.

cObsider the following exaaple. suppose th. us.r waDts to draw five concentric circles on the secon4 scatter plot, a Ch.w· Low envelop en the seventh, and three Dalits·plot boaDdart •• corresponding to three center-of-aass energi •• on the t.nth. Thq UPL01 routine could be coded as follows.

rUIC!lCJ U'tO!(I,t,') COIBOI IUILO!II BULT DIII.SIOI 1(3), 1(5, DATA I,i 1 •• ,,2.~,2.l,O.25,O.2,O.15,O.1,O.051 D111 ICI,l1,12,13 12.0,0.1'0,0.938,0.1351 DAt' BIOI. "aIOII I UPtO! 11: Hldttl If (1.11.2) gO TO 10

IF (IULt.lg.O, IUt! - 5 UPLOT * 1*.2 • '**2 • I(BULT) •• 2 BETUIUI

10 I' (1.1!.1) GO '0 20 UPLOT • CBIILO(I,t,BCft,11,12,11,12,13) ~E'IUlnt

20 IF (1.11.10) GO TO 30 IF (Mott.BQ.O) Mut! • l UPLOT = DALITZ(X,Y,E(BULT),11,12,13,

30 BEtUa. lIn

c. Rlgt ~IRt'IIIi2a.

There is a CO •• OD block .-..- '""" COIIMON IFLAGSI ?LAG (20)

in ~hich kIOll looks to find YSriOU8 flags. rL1G(2) is ••• i9n84 tor s~ppr.s.ion of 9raphic output. It i ••• t to zero by 11011 just before each call to USBRst(lIBlt,IO), USaPL!(llllt,IO), ana USBGBI'l (AB!A! ,10) • CliO 18 the Au.berof the hiatoCJraa, scatter plot, or Gaussian ideogral. APIAY ia the cooteats, iD packea for.at for scatter plots., If PL1G(21 i. Don-.ero on the teturn, 9raphic output is suppressed. PL1G(1) i8 the a.alo90u. flag for line-printer output.

The following codin9 would suppress 9raphic output for histograas 3 and 5, ana scatter plots 3 throuqh 6.

SUBROUTIN! USBHS!(1IB1Y,HO) DI!lNSION IRBAY(1) COft~ON IlL1GSI ILAG(20) IF (NO.EQ.]) PLAG(2)=1. IF (HO. EO. 5) FLAG (2) =1. P.ETUPN END SUBBOUTINE USBPLTC1RBAY,NO) DIMENSION ARRAY (1) COM!ON IrLAGS/ Ftl0C20J IF (NO.GE.3 .110. NO.LE.6) PL1G(~z1. RE1UfjN lID

'M.