* Produce "Executive Presentations"

Transcription

1 Enhancements to the GREPLAY Procedure Steve Morton - SAS Institute The GREPLAY procedure has been completely redesigned for Version ~ of the SAS/GRAPH product. Unlike previous releases of the procedure, which were essentially limited to redisplaying pictures from GOUT data sets, the new version is a tool for both display and management of graphics catalogs. With PROC GREPLAY, you can now: * Display graphs from a graphics catalog on different devices without leaving the GREPLAY procedure * Change colors on a graph before displaying it * Design templates for combining multiple graphs onto one page or screen * Rearrange and group graphs within a catalog * Modify graph descriptions on menu screens * Delete graphs from catalogs * Copy graphs between catalogs * Transmit graphs subsequent use software to VSAM files for by SAS/REPLAY-CICSN * Produce "Executive Presentations" PROC GREPLAY can be used either in fullscreen mode, interactive line mode, or in a batch environment. All functions are available in each of these modes. Graphics Catalogs and Templates Two important concepts behind the new PROC GREPLAY are graphics catalogs and templates. A GRAPHICS CATALOG is a collection of graphs created by SAS/GRAPH procedures. In function, a graphics catalog is similar to GOUT data sets (which no longer exist), but in structure and management, it is quite different. Like GOUT data sets, graphics catalogs can contain multiple pictures in either devieedependent or device-independent format. Unlike GOUT data sets, graphics catalogs are in the form of SAS utility data sets, and cannot be accessed in a DATA step. Catalogs can be stored either temporarily (for the duration of the SAS job) or permanently. The statements used to place output from procedures into graphics catalogs are the same as those used to create GOUT data sets. For example: PROC GPLOT GOUT=PLOT1; PLOT X*Y; causes a graph to be placed in a temporary graphics catalog named "PLOT1", and PROC GPLOT GOUT=MYLIB.PLOT1; PLOT X*Y; places a pictu re in a permanent catalog pointed to by the libref "MYLlB". A major difference between the creation of catalogs and GOUT data sets is that graphics procedures can now append pictures onto the end of existing graphics catalogs, whereas previously they replaced the contents of GOUT data sets. For example, if you code GOPTIONS GOUTMOD~=APPEND; PROC GPLOT GOUT=G1; PROC GSLIDE GOU'r=G1; PROC GMAP GQUT=G1; by default all three of the graphs will be stored in the graphics catalog named "G 1". In previous releases, only the last graph would have been placed in the GOUT data set. A TEMPLATE is a set of four-sided polygons into which pictures can be placed when they are displayed using the template facility of PROC GREPLAY. It is through the use of a template that multiple graphs can be displayed on one page or screen. Like graphics catalogs, templates are stored in SAS utility data sets. A number of pre-defined templates are shipped with the SAS/GRAPH product,but users can also define their own. See the section below for details on creating and using templates. Using PROC GREPLAY in Full-Screen Mode Before using PROC GREPLAY, you must first place some pictures in a graphics catalog. For example, PROC GCHART DATA=D1984 GOUT=MYLI B. GRAPHS; VBAR QTRISUMVAR=ORANGES; PIE QTRISUMVAR=ORANGES; TITLE 'ORANGE OUTPUT FOR 1984'; PROC GCHART DATA=D1985 GOUT=MYLlB.GRAPHS; VBAR QTRISUMVAR=APPLES; PIE QTRISUMVAR=APPLES; TITLE 'APPLE OUTPUT FOR 198~'; The above code (including lines not shown) produces pie and bar charts for both apples and oranges in 1984 and a total of il' graphs. Tfoese graphs are all placed in the graphics catalog "MYLlB.GRAPHS". To invoke PROC GREPLAY, enter PROC GREPLAY IGOUT=MYLlB.GRAPHS; 225

2 If running on a full-screen device, the following menu will be displayed: -" _SC'I"UOIII :~" ' =",1,===== ct,.,... '..., Of' 0" "II CoMa' 01' 0".,... '..., Of 0"... CJlUl OIl 0"... c-1"'... :!.C::,a:,O:. "It CRUl Of 011 ""H'~ Hi..... ",'-\W... ao-o... ICI. '21.J se.ou......"., " " n "...,.. "",' r.... If desired, you can change the names and descriptions of the pictures to provide more meaningful information. To do this, hit the "MODIFY" function key, and the descriptions are left unprotected, allowing you to modify them. After changing names and descriptions, the screen looks as follows:... SI... _.. t~... OCIOllflI CIOI,IT, ~=~.TI. _ licit ou,"'" "OIl, '...,.a"", OUT'.,If'.,,,.--.If C...., "'~l ouu'ut ' c_n."~e ou''''''' '011, -.. It '..., "'''''1 out"""' '011,.. '.-... c.-il QIIANGoI QYTN' '01: "'10--"1 CotoIn.N>~l OUTIul '011,"'--,...,.""I.( OU'''''' FOIt IN,--IU '-'IT Au",!.' 'Pi"'&. Hi.liT... ties j'i.i6blh,....or, "",."..._ "' IOIICkI'''IO.'''' 1II.. ICl,I_UlI' "!WH. 'a(if 15...,'... S..... U...,... S...,,,..,, ""'-1'11' You can also group or regroup pictures. To do this, hit the "GROUP" function key, and enter grouping information next to the picture descriptions. For example, ~~I. I'.CoII... ~ ". 1A"GIt... I... A.. OC'~1 GOIIT, =~"u,... OUf"",'., ,""., ~ Oo.I'.."f '01 ' C-11.-LlOU1.. U' 'OI' e ~f ou,..." ' '"".,...""'OU'...'.OII I$... c,.~ou1..."0ii I$--.IIC' '...,"01...'--... '""., ""1.1 OI.If..,,' '01 ' &11'.h.th Nj... tui... eici.'i-.otijiit.. ',... ~... c.aou".. ',O... Llo _vlci I.. Jun Kl'o..... Got The first character entered is used to divide pictures into groups, while the number orders pictures within groups, After pressing ENTER, the pictures are regrouped as follows:!~'...,... ' cc, -" f~tl, ,.c.a.. 01".'1 OU,..., '01, e_11...,ou'... I1.OI...-- IIC 'IOW 0..0"..."011 I ~--.U e...'... IOU'''''' '011, c-., c;&oi.if""',oi'''.--''lloojlll ~10l.l'''''''0I''''- '1lC-11...u....", HIlI,"'-,"u ~, am.l aunvt.. ''''''''11 CfoAIIf H'... ~' Hi.flit HI.. ua; H'.Ud...,...,,.,,...,.. taw ~ "" You can copy one or more graphs from one graphics catalog to another by entering the name of the output catalog in the GOUT field of. the menu screen, and entering the letter C next to any graph or group or graphs you want c"pied. You can delete graphs from your input catalog by entering "DEL" next to the graphs you want deleted. To define new templates or to look at or modify existing ones, enter the name of template catalog (MYLI B. TEMPLATE, for example) in the TC field of the main menu screen, and hit the TPL function key. This will take you to a template catalog screen such as the one below: "M C.'.I..,...,.,.,.,,... '..,...,.... f_'.',,,.,,, At this point, you can select one of the templates already in the catalog by placing an "X" next to it, or you may create a n_ template. To create a new template called FOURBOX, enter "EDIT FOURBOX" on the command line and press ENTER. This takes you to a template design screen: I I.- : i '- := '- HI "h. W, """'''''. Wi iituiiii, Wi 1iW. w, iii. WI66ifiI For each panel (Polygon) you want to appear on the template, fill in a panel number, color and X-Y coordinates for the 4 corners. (X and Y values normally range from 0 to 100 and are interpreted in terms of the percentage of space in the graphics area), The CLP field is used to indicate whether the panel will clip other panels it intersects. The SCALE, XLATE, and ROTATE fields can be filled in with valu,es that can be used to shrink/enlarge, move,.or rotate panels. Placing a value in one of these fields and pressing ENTER will cause the X-Y coordinates for the panel to change accordingly. Suppose you want to create a template containing fou r rectangles, seperated by a small amount of space. Ycu can enter the following panel coordin~tes: l~'''li.''''. OIl",_'. ",...,,,. q ' ",..., ;.- :-,,,.. "...,,-...- I,-.=.ft ttl. Wi 61""".., "'I IttUh. Wi Ii"'. H'... After entering the coordinates, you can p...vi_ the template by pressing the DISPLAY key. which produces the following: 226

3 This produces the following graph:.. N'PL OUTPUT N'PL OUTPUT -:. ~ N'PL OUTPUT Now return to the main menu screen. Using templates, you can either re.,lay graphs one at a time or display multiple graphs at. all at once. To display graphs one at a time, simply place an "X" by the picture or pictures you want replayed. If you place an "X" by the. group name, all of the pictures within that group are replayed. For example, the selection below will cause all 4 bar charts to be replayed, one at a time: ---.,' II NOCIDUII ~",~, ,.aUIT --..etic'"... ainu' ' c-., ""'"' 0U'fNl'.011' l1&li,-..,....".." ou,""......, , (MAt _" Of' NUn lmoducuc. GaalllliaOU't..."...--.uc...,... IOl,lT"""OIII...--.,lC_lIl _...,...,.OA 'INS--'It c-t... OUt,.., 'OIl ''''--'11 "u.u,. WhYR Wi"hili.. ",a.uti ";;Wih ~,, tooi, ",......,..... ~.,,0... U To display graphs within a template, enter the name of the template and template catalog on the header lines, and next to each picture enter the panel number into which it is to be placed. For example, to place one of the 'Ipple' graphs into each panel of the template we defined earlier, enter panel numbers as follows : 1"""',... 1(:...-u.Ta,..= - _ <C, T=......'t~I_,.., ,... MiI'U. _....,..., "'"......, _ CMMn' IIMU... _-... CNUtT... o.u,.... NUn no. T...,... eutliu'i 'OIl M'ft.l ''''--'It 0..' eutllu'l ''''--'Il C"".110 out..., ' ' "T".'11".~I outllu'l ''''--''1 Old' WiwaO.pM WiAi... Wid -'-th... ", , _. :=... 11~.' '-- Suppose hiving displlyed the graph, you would like to have a hard copy produced on a leta 887 plotter. This can be done by simply changing the DEVICE field on the main GREPLAY menu screen to let A887 and making a graph selection as before; it is not necessary to leave PROe GREPLAY. However,in originally generating the graph, you may have chosen colors such as yellow and w.hite, which are suitable for I terminal display, but not for hard copy. To avoid this potential problem, you can use the color mapping facility available in PROC GREPLAY. To create a color map, enter the name of a color catalog dataset in the CCAT field of the main GREPLAY menu., A color catalog is SAS utility data set; you can supply a one- or two-level name in the CCAT field, depending on whether the catalog is to be saved permanently. Assuming that an existing color catalog named COLORCAT resides in thesas utility data base pointed to by the libref MYLI B, you can enter MYLlB.COLORCAT in the CCAT field, press the CMAP function key, and the following menu w.ill be displayed:... ::=. :::: I.e'.'...,r_ 1_ ur... n~" c.'.r,r_, " n. "'1.. The menu displays the names of all color maps that have previously been stored in the color catalog. If you want to c... t. I n_ map called TOlETA, just enter "EDIT TOlETA" on the command line, and the foll_ing screen will be displayed: 227

4 ...,e,...,., N6I.. "..,.... COL... 1Il10 ce,..,,.. "",OKn Wi"'" S_... aw.t.. w,... At this point, you can enter you r color. map list. If you want all yellow areas on the graph you are about to replay to be converted to blue before being sent to the plotter, enter ':yellow" in the FROM column, and "blue" in the TO column. Follow this with any other color conversions you want made. For example,... :?.!' After entering your desired color conversions, pr!ss the RETURN key twice to return to the main GREPLAY menu. Now.you can enter "TOZETA" in thecmap field, and make your pictu re selection: ICiOIn. _,.1...,..... U,.. ' ,. «,."'. COLOItCa'., ,. T.,,... WI'" ::::::....'11" _acta"'l"..., '""... :a1l.;;m=::=... CM&II" 01' '.un "ODUCTlOIII.. MGt."...,.oa.,... ~... e..." ~. ""lout.oa, (lmn OUflCOl OUJ...'.OII, (MA"... ou,...'...,... ~... CWOI'..",. OIMI" Of....,."",.ea,... n IiIIOIIuCn.. ~~"'. 00II"... 0UTf'U' NIt ''''--''11,..." aaaiiiii out...'.ea ''''~-'''Il... OU"'''' OIAII' ''''-~.'. CM&I" Wi-OW,.' Hi-nit "i-iit_... tld "i.elh..., "".. _ _...&li0ii'' "''''',:1. _VICI, tit..., ~,.,..., , ~, """"1',.. "..., When the picture is sent to the ZETA 887., the color mappings specified in the TOZET A color map will be in effect. When replaying graphs using templates, if you enter the name of an output graphics catalog in the GOUT field, the replayed output is stored as a single picture in the output i:atalog as well as being displayed on the graphics device. If you want to redisplay the four graphs at once, you can then place the name of your GOUT catalog in the IGOUT field and replay the single picture in that catalog.. Another screen that can be used by PROe GREPLAY Is the presentation screen, accessed by pressing the PRESENTATION function key from the main _nu screen. The presentation screen is similar to the main menu but only contains graph descriptions and a selection column: ''' a.nl Of NUn -..,en.. OUtNt '11 ~ CNd'...,""II'U".., -... etoa."... "-I,..."... ' e..,..'... ""..., NIt,_~... 0."....,...,..._ ,... 0UTt''''... ' c-a'... "'II'U'... ''''-~'II CftUT... eudift 'OI '... 1 CMA'... "'... n...ct... --wi...,.. Wi.I,,_ Wt. W......, "... "... If you are generating displays for formal presentations, you can group and label the graphs from the main menu, save the altered graphics catalog and then later re-invoke PROe GREPLAY and go directly to the presentation screen. PRoe GREPLAY can elso transmit devicedependent pictures to VSAM files for later use by the SAS/REPLAy-eleS product. Assume you have created a series of device-dependent graphs, stored them in the catalog MYLlB.DEPEND. entered PRoe GREPLAY, and modified the graph names and descriptions. Your main menu screen looks as follows:..., """.. ::::; =:=.IoCIII"""< _...&11, _VI'I.,... v.ct:~..., ,..-, Of'..,..." vii......,... v..."... 1"",""IT II IIlLIS.. COIIJI"'"... SIII/o.I'."... (oi.. HI... "'K...,. W.. titl.h..... _$...,... ""~.. ~..,~-I To transmit these fu nction key, and displayed: ~:':'" "'10'. _"'_ "".. loll graphs, press the following... Vlet......, """""-... Owl' 01' " D'VIII.. IILOT.. II... """ "f 0..' 01' a,.(quii"'"... 1&1..'... 1'01.. H'''''_.. f... 31,.31 IUOU... 1.li' " UI_66iiI the eles screen is...-. ::~::r..."..., On this screen you can enter a DDname for the VSAM fije and a. eles USERID. Then. select the graphs you want transmitted by placing an "X ' next to the description, and press ENTER. Using PROe GREPLAY in line Mod. All of the full-screen functions illustrated above can be used in line-mode or a batch environment.. To run in interactivelin e mode, simply enter PRoe GREPI;AY NOFS; and the procedure will respond with: ENTER GREPLAY COMMANDS: 228

5 You may speci fy the name of the input graphics catalog. template catalog. and device name as follows: IGOUT MYLIB.GRAPHS; TEMPLATEC MYLI B. TEMPLATE; DEVICE TEK4105; To get a list of the pictures in the catalog. enter LIST IGOUT; To change graph descriptions. you can use statements such as the following: MODIFY 1 / NAME=GRAPHl DESC='PIE CHART FOR 1984' 2 I NAME=GRAPH2 DESC="VBAR CHART FOR 1985'; which will picture 1. specify assign a name and description to To place graphs in groups. you can GROUP G1 G2 G6 G8; which will place the graphs named Gl. G2. G6 and G8 into a single group. Templates may also be defined in line mode. To create a simple template with two panels. you can specify TDEF MYTEMP l/llx=o LL Y=O ULX=O UL Y=l00 URY=l00 URX=49 LRX=49 LRY=O 2/LLX=Sl LLY=O ULX=Sl. ULy=Q URY=100 URX=l00 LRX=l00 LRY=O; To previ",w the template. enter PREVIEW MYTEMP; To replay graphs one-by.-one without templates. specify release of SAS/GRAPH software and want to replay them wifh PROC GREPLAY in Version 5, you must u.e PROC GCONVERT to change them into graphics catalogs. Use PROC GCONVERT as follows: PROC GCONVERT DATA=OLD.GOUT GOUT=NEW.cATALOG; Summary This paper has given a brief overview of capabilities and use of PROC GREPLA Y under Version 5 of the SAS/GRAPH product. Several fe.ture. have not been covered here due to a lack of space. You are encouraged to consult the SAS/GRAPH USER'S GUIDE, VERSION 5 EDITION, for full details on use of PROC GREPLAY. supplying graph names or numbers. To replay graphs in a template. specify TREPLAY l:gl 2:G2; In this case. picture Gl is placed in pimel 1 of the template. and picture G2 is placed in panel 2. If you are using PROC GREPLAYin a batch environment (or are including a previously written program. in line model. you can submit or include all of your statements at once, and they will be processed sequentially> Converting GOUT Data Sets to Catalogs Beginning with Version 5, PROC GREPLAY accepts only graphics catalogs as input. If you have created GOUT data sets with a previous 229