5.7 Interrupted Time Series (ITS) Figure File Lookup Table Parameters (Not Yet Functional)
The ITS Figure File lookup table is optional to be specified for an ITS analysis. All lookup tables can be found in the Reporting Tool templatefiles folder. The user will download the Reporting Tool, select the ITS Figure File lookup table, and edit the relevant parameters directly in the lookup table.
The Figure file is used to specify which figures and corresponding stratifications to produce in the report. The lookup tables below are used to map the requested output with the strata level variables necessary to compute the appropriate metrics. Requested strata level variables must be requested in the distributed [User-defined Strata Levels Look-up file]. Note that only one Figure file that includes all requested output should be specified. Table 5.16 contains detailed specifications for the Figure File.
Two figures can be requested, as indicated by the FIGURE parameter in the Figure File:
- F1: t2its = Rate of [Outcome] Use Before and After Intervention
- F1: t2itsprev = Rate of [Outcome] Use Before and After Intervention in Prevalent Cohort
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.
| Figure | Dataset | Figuresub | Levelnum | Levelid1 | Levelid2 | Levelid3 | includeinreport | Xmin | Xmax | Xtick | Ymin | Ymax | Ytick | Includeatrisktable | Censordisplay |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| F1 | t2its | overall | 1 | year | N | N | |||||||||
| t2its | sex | 1 | sex year | N | N | ||||||||||
| t2its | agegroup | 1 | agegroup year | N | N | ||||||||||
| t2its | race | 1 | race year | N | N | ||||||||||
| t2its | hispanic | 1 | hispanic year | N | N | ||||||||||
| t2its | overall | 1 | year month | N | N | ||||||||||
| t2its | sex | 1 | sex year month | N | N | ||||||||||
| t2its | agegroup | 1 | agegroup year month | N | N | ||||||||||
| t2its | race | 1 | race year month | N | N | ||||||||||
| t2its | hispanic | 1 | hispanic year month | N | N | ||||||||||
| t2its | overall | 1 | year quarter | N | N | ||||||||||
| t2its | sex | 1 | sex year quarter | N | N | ||||||||||
| t2its | agegroup | 1 | agegroup year quarter | N | N | ||||||||||
| t2its | race | 1 | race year quarter | N | N | ||||||||||
| t2its | hispanic | 1 | hispanic year quarter | N | N | ||||||||||
| t2itsprev | overall | 1 | year | N | N | ||||||||||
| t2itsprev | sex | 1 | sex year | N | N | ||||||||||
| t2itsprev | agegroup | 1 | agegroup year | N | N | ||||||||||
| t2itsprev | race | 1 | race year | N | N | ||||||||||
| t2itsprev | hispanic | 1 | hispanic year | N | N | ||||||||||
| t2itsprev | overall | 1 | year month | N | N | ||||||||||
| t2itsprev | sex | 1 | sex year month | N | N | ||||||||||
| t2itsprev | agegroup | 1 | agegroup year month | N | N | ||||||||||
| t2itsprev | race | 1 | race year month | N | N | ||||||||||
| t2itsprev | hispanic | 1 | hispanic year month | N | N | ||||||||||
| t2itsprev | overall | 1 | year quarter | N | N | ||||||||||
| t2itsprev | sex | 1 | sex year quarter | N | N | ||||||||||
| t2itsprev | agegroup | 1 | agegroup year quarter | N | N | ||||||||||
| t2itsprev | race | 1 | race year quarter | N | N | ||||||||||
| t2itsprev | hispanic | 1 | hispanic year quarter | N | N |
| Parameter | Field Name | Description |
|---|---|---|
| Include in Report | INCLUDEINREPORT | Indicator to output the corresponding figure in the report. |
Valid values are:
|
||
| Format: SAS character $1 | ||
| Example: Y | ||
| Minimum X-Axis Value | XMIN | The user can optionally specify the minimum x-axis on the CDF or KM 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 or KM 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 or KM 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 or KM 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 or KM 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 or KM 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 | List of censoring criteria to display on the CDF or KM plot, separated by a space. |
Valid values are:
|
||
| Note 1: if left blank, all censoring criteria relevant to the figure will be displayed. | ||
| Format: SAS character—length can vary | ||
| Example: cens_elig cens_dth cens_dpend cens_event | ||
| Include At-Risk Table | INCLUDEATRISKTABLE | Indicator specifying whether to output at-risk table below censoring figure. |
Valid values are:
|
||
| Format: SAS character $1 | ||
| Example: N |