topic Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title? in Graphics Programming

ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

PaigeMiller — Mon, 07 Nov 2022 15:39:51 GMT

proc sort data=sashelp.class out=class;
    by sex;
run;

title 'Histogram for #byval1';
ods graphics/height=3in width=4in;

options orientation=landscape nobyline;
ods pdf file="test.pdf";
ods layout gridded columns=2 column_gutter=18 advance=BYGROUP;
ods region;
proc sgplot data=class;
    by sex;
    histogram height;
run;
ods layout end;
ods pdf close;

Output has unwanted title centered above the two plots, which says "Histogram for #byval1", how do I get rid of this unwanted title and leave only the titles above the individual plots?

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

svh — Mon, 07 Nov 2022 16:24:20 GMT

I would suggest putting the TITLE statement in the PROC instead of prior to your ODS PDF statement.

proc sgplot data=class;
title 'Histogram for #byval1';
by sex;
histogram height;
run;

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

PaigeMiller — Mon, 07 Nov 2022 16:27:42 GMT

That was simple. Thanks! Can I get an explanation of why this works, but my code didn't?

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

svh — Mon, 07 Nov 2022 17:59:46 GMT

I think it's because you want the title in the REGION defined by the ODS REGION statement right before your SGPLOT statement. In your original example, you title is being forced into the top of the document before you've defined the region. This provides an example:

https://documentation.sas.com/doc/en/pgmsascdc/9.4_3.5/odsug/p06ji2uhvayhq5n1eik2z2rf2ga8a.htm#p0dq2wjn4pp20vn1igvir0pq9byaa

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

PaigeMiller — Mon, 07 Nov 2022 18:04:11 GMT

Makes sense! Thanks!

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

DanH_sas — Mon, 07 Nov 2022 18:10:21 GMT

Although TITLE statements are global in nature. their placement within the context of an ODS LAYOUT can affect the timing of when the title is generated. In your example, any TITLE statement before the ODS LAYOUT statement will be generated as a page title (the behavior you saw). A TITLE statement between the ODS LAYOUT statement and the first ODS REGION statement will generate a title within the first cell BEFORE the content of the region is processed. A TITLE statement within the ODS REGION block affects the titles for the procedure output, which was your desired result.

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

PaigeMiller — Tue, 08 Nov 2022 12:39:56 GMT

Followup question for @DanH_sas and @svh (and anyone else who might have an answer)

Above, I created one layout using ODS LAYOUT GRIDDED, but suppose now I want to create a 2nd such layout in the same program, for example instead of using SASHELP.CLASS, now I also want similar histograms in a layout from SASHELP.CARS, in the same program. It seems to me that then I need to include title; before I create the 2nd ODS LAYOUT GRIDDED, otherwise the title from the SASHELP.CLASS histograms carries over to the 2nd grid of histograms.

Do you agree? Or is there some other way?

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

Rick_SAS — Tue, 08 Nov 2022 15:08:55 GMT

A few related comments:

1. At some point you might want to panel graphs and tables that are generated by SAS procedures that generate procedure titles. Use the
ODS NOPROCTITLE;
option to suppress procedure titles, as shown in https://blogs.sas.com/content/graphicallyspeaking/2017/08/14/advanced-ods-controlling-precisely-output-displayed/

2. Your example shows multiple graphs of the same type (a histogram). In this case, it is sometimes helpful to switch to using the SGPANEL procedure and the PANELBY option, especially if you want to control the placement of labels within cells or coordinate the range of axes. See https://blogs.sas.com/content/iml/2021/02/17/data-driven-titles-sgpanel.html and https://blogs.sas.com/content/iml/2011/08/12/side-by-side-bar-plots-in-sas-9-3.html

Re: ODS LAYOUT GRIDDED with BYGROUP — how to eliminate unwanted title?

DanH_sas — Tue, 08 Nov 2022 15:43:12 GMT

Correct, because the content of that title statement is still global.