Old Friends, New Features: What's new in SUMMARY and ... - NESUG

NEW WAYS TO CONTROL CONTENT AND ORDER IN V7 SUMMARY AND TABULATERobert Ray / Information Products / SAS Institute Inc., Cary NCAbstractFor Version 7 of SAS ® software, the SUMMARY andTABULATE procedures have many new options, two ofwhich enhance control over which class levels appear inthe output and the order in which they appear. Thepreloadfmt CLASS statement option generates initial classlevel data from user-defined SAS formats. Theclassdata= proc statement option gives further control byallowing the user to supply a second data set whichdefines all acceptable class levels. Both of these featurescan be used to filter or extend the analysis data and bothredefine the meaning of order=data.OverviewHave you ever needed to ensure that a certain set ofclassification levels was present in a report even if thoselevels were not all present in the input data? Have youever wanted a class level ordering that wasn’t availablewith one of the standard ordering options? If so, then twoof the new options of PROC SUMMARY and PROCTABULATE will be of interest to you.Both SUMMARY and TABULATE now allow multipleCLASS statements and CLASS statements now have options.One of the CLASS statement options, preloadfmt, willgenerate class level initiating data from user-defined SASformats that have been assigned to the class variables.Because this generated data is seen before the actual inputdata, the order=data option will then place the output inthe order in which the format was defined, assuming theformat was created with the notsorted option . Anextension to preloadfmt is the exclusive option.Specifying exclusive in the CLASS statement withpreloadfmt will cause the format to be used like a whereclause, screening out observations with class variablevalues not covered by the format.As mentioned above, preloadfmt can add class values notfound in the input data to one or more class variables. Toget all these values into the output, either the printmissTABLE statement option of PROC TABULATE or the newcompletetypes proc option of PROC SUMMARY mustbe used. This will cause all possible class variable valuecombinations to appear in the output even if some cellshave a frequency of zero. You may be thinking thatPROC TABULATE has always had the printmiss optionbut in the past, every class variable value output to thetable had to be present somewhere in the input data seteven if not all combinations were present. Now the outputcan contain class values not found anywhere in the inputdata set.Now you may be thinking that printmiss is okay but itoutputs all possible combinations of class values, whichcan be too much! Some class value combinations couldbe nonsense such as when multiple location classes areused together such as city and state. Not all city namesmake sense for all states. This is where the classdata=option comes in handy. It allows the user to specify a setof class variable value combinations or levels that must bepresent in the output even if the associated frequency iszero.Like preloadfmt, classdata= has an exclusive optionthat when used in the proc statement causes the class datato resemble a large where clause. The difference beingthat a where clause can only remove data whereasclassdata= can remove and add class levels at the sametime. In SQL terms, classdata= used alone acts like a fulljoin between the class data set and the input data set. Usedwith exclusive, the class data set acts like the preserverof a one-sided outer join. Also, like preloadfmt,classdata= changes the meaning of order=data. Withclassdata=, data ordering becomes the order that eachclass variable value was encountered in the class data set.ExamplesThe first example is a simple year-to dates report orderedby a fiscal year that demonstrates the preloadfmt feature.The example shows how content for individual classvariables can be controlled by user-defined SAS formats./*-- Define a format ordered by fiscal year --*/proc format; value mthfmt ( notsorted )6='Jun' 7='Jul' 8='Aug' 9='Sep'10='Oct' 11='Nov' 12='Dec' 1='Jan'2='Feb' 3='Mar' 4='Apr' 5='May';run;/*-- Make-up some data for the IRS --*/data records;retain seed1 543;drop ind;do month = 1 to 7;do day = 1 to 30;call ranuni( seed1, ind );dailyTotals = 1000 + (1000 * ind);output;end;end;drop seed1;

format month mthfmt.;run;/*-- Send output to HTML --*/ods html body="C:\temp\preloadFmt1.htm";/*-- Now, do the report --*/proc summary print sum mean completetypes;class month / preloadfmt order=data;var dailyTotals;run;ods html close;And now the ODS - HTML output…PA Philly 100000NC Cary 50000NC Raleigh 360000PA Pittsburgh 75000PA Philly 450000NC Raleigh 50000PA Philly 800000NC Cary 30000NC Raleigh 50000;/*-- Query defines class levels and order --*/data query;input state $1-2 city $4-13;datalines;PA PhillyPA PittsburghNC RaleighNC Durham;run;ods html body="C:\temp\classdata1.htm";proc tabulate data=revenues classdata=queryexclusive;class state city / order=data;var amt;table state*city, amt*(n sum);run;ods html close;And the resulting HTML output…The next example shows how classdata= andexclusive can be used to zero-in on a target set of classlevels that may or may not be contained in the input data.Notice that the class combination NC/Durham does notoccur in the input data but does appear in the output.data revenues;input state $1-2 city $4-13 amt;datalines;PA Pittsburgh 200000PA Philly 500000NC Raleigh 250000ConclusionsThe examples above illustrate just two of over thirty newfeatures of PROC SUMMARY and PROC TABULATEfor Version 7 aimed at reducing the need for pre and postprocessing data to get what you really want.TrademarksSAS is a registered trademark of SAS Institute Inc. in theUSA and other countries. ® indicates USA registration.