5 Figure File Parameters

The Figure File lookup tables are used to specify which figures to produce for the output in the report. Lookup tables differ by report type. All lookup tables can be found in the Reporting Tool templatefiles folder. The user will download the Reporting Tool, select the appropriate Figure lookup tables for their request type, and edit the relevant parameters directly in the lookup table.

The Figure File is optional and is used to specify which figures and corresponding stratifications to produce for the report output and to customize the figure. Table 5.1 contains links to Figure File lookup tables for each type of analysis. Table 5.2 contains detailed specifications for the Figure File.

Table 5.1: Links to Figure File lookup tables by type
Analysis Type Figure File Lookup
Descriptive Type 1 Type 1 Figure File Lookup Table
Descriptive Type 2 Type 2 Level 1 Figure File Lookup Table
Inferential Type 2 Type 2 Level 2 Figure File Lookup Table
Descriptive Type 4 N/A
Inferential Type 4 Type 4 Level 2 Figure File Lookup Table
Descriptive Type 5 Type 5 Figure File Lookup Table
Descriptive Type 6 Type 6 Figure File Lookup Table
Interrupted Time Series (ITS) ITS Figure File Lookup Table21
Table 5.2: FIGUREFILE specification
Parameter Field Name Description
Figure FIGURE Figure identifier. User should not edit.
Dataset DATASET QRP output dataset identifier. User should not edit.
Figure Stratification FIGURESUB Figure stratification identifier. User should not edit.
Level LEVELNUM Specifies the number of level ID variables required in order to produce the figure. For example, if LEVELNUM = 1, then the output defined in LEVELID1 is required to be included in the distributed results, but the output defined in LEVELID2 and LEVELID3 is optional and not necessary to output the figure. User should not edit.
Level 1 ID LEVELID1 First level identifier. User should not edit.
Level 2 ID LEVELID2 Second level identifier. User should not edit.
Level 3 ID LEVELID3 Third level identifier. User should not edit.
Include in Report INCLUDEINREPORT User specifies whether to output the corresponding figure in the report.
Valid values are:
  • Y: Output the figure
  • N: Do not output the figure
Format: SAS character $1
Example: Y
Minimum X-Axis Value XMIN The user can optionally specify the minimum x-axis on the Cumulative Distribution Function (CDF), Kaplan-Meier (KM), or Cumulative Incidence Function (CIF) plot.
Note 1: the default minimum x-axis value is 0.
Format: Numeric
Example: 50
Maximum X-Axis Value XMAX The user can optionally specify the maximum x-axis on the CDF, KM, or CIF plot.
Note 1: the default maximum x-axis value is the maximum of the data.
Format: Numeric
Example: 100
X-Axis Tick Marks XTICK The user can optionally specify the distance between x-axis tick marks on the CDF, KM, or CIF plot.
Note 1: by default there will be 6 x-axis tick marks; the code will determine the tick values.
Note 2: if XMIN = 0, XMAX = 200, and XTICK = 50, this will create x-axis tick values of 0, 50, 100, 150, and 200.
Format: Numeric
Example: 20
Minimum Y-Axis Value YMIN The user can optionally specify the minimum y-axis on the CDF, KM, or CIF plot.
Note 1: the default minimum y-axis value is 0.
Format: Numeric
Example: 0.80
Maximum Y-Axis Value YMAX The user can optionally specify the maximum y-axis on the CDF, KM, or CIF plot.
Note 1: the default maximum y-axis value is 1.
Format: Numeric
Example: 0.90
Y-Axis Tick Marks YTICK The user can optionally specify the distance between y-axis tick marks on the CDF, KM, or CIF plot.
Note 1: the default y-axis tick value is 0.2.
Note 2: if YMIN = 0.5, YMAX = 1, and YTICK = 0.1, this will create y-axis tick values of 0.5, 0.6, 0.7, 0.8, 0.9, and 1.
Format: Numeric
Example: 0.5
Censoring Criteria to Display CENSORDISPLAY User lists censoring criteria to display on the CDF, KM, or CIF plot, separated by a space.
Valid values are:
  • cens_elig
  • cens_dth
  • cens_dpend
  • cens_qryend
  • cens_episend
  • cens_spec
  • cens_event
  • cens_switch
Note 1: if left blank, all censoring criteria relevant to the figure will be displayed.
Note 2: for Type 6 CIF plots (figures F8 and F9), user can specify only one of any of the following values: cens_episend, cens_dth, cens_elig, cens_dpend and cens_qryend, to be used as a competing risk. cens_switch is not a valid value for competing risk in Type 6 analyses.
Format: SAS character - length can vary
Example: cens_elig cens_dth cens_dpend cens_event
Include At-Risk Table INCLUDEATRISKTABLE User specifies whether to output at-risk table below censoring figure.
Valid values are:
  • Y: Output at-risk table
  • N: Do not output at-risk table
Format: SAS character $1
Example: N

  1. Not yet functional↩︎