StudySpecification_var_names: Extract Variable Names from 'StudySpecification'

In propertee: Standardization-Based Effect Estimation with Optional Prior Covariance Adjustment

Extract Variable Names from StudySpecification

Description

Methods to extract the variable names to the elements of the structure of the StudySpecification (e.g. treatment, unit of analysis, etc)

Usage

var_table(specification, compress = TRUE, report_all = FALSE)

var_names(specification, type, implicitBlocks = FALSE)

Arguments

specification	a StudySpecification object
compress	should multiple variables be compressed into a comma-separated string? Default TRUE. If FALSE, multiple columns can be created instead.
report_all	should we report all possible structures even if they don't exist in the StudySpecification? Default FALSE.
type	one of "t", "u", "b", "f"; for "treatment", "unit_of_assignment", "block", and "forcing" respectively
implicitBlocks	If the StudySpecification is created without blocks, setting this to TRUE will return ".blocks_internal" as the variable name corresponding to the blocks.

Details

When compress is TRUE, the result will always have two columns. When FALSE, the result will have number of columns equal to the largest number of variables in a particular role, plus one. E.g., a call such as rct_spec(z ~ unitid(a, b, c, d) ... will have 4+1=5 columns in the output matrix with compress = FALSE.

When report_all is TRUE, the matrix is guaranteed to have 3 rows (when the specification is an RCT or Obs) or 4 rows (when the specification is a RD), with empty variable entries as appropriate. When FALSE, the matrix will have minimum 2 rows (treatment and unit of assignment/unitid/cluster), with additional rows for blocks and forcing if included in the StudySpecification.

Value

var_table returns the requested table. var_names returns a vector of variable names.

Examples

spec <- rct_spec(z ~ uoa(uoa1, uoa2) + block(bid), data = simdata)
var_table(spec)
var_table(spec, compress = FALSE)
var_names(spec, "t")
var_names(spec, "u")
var_names(spec, "b")

propertee documentation built on Aug. 22, 2025, 1:09 a.m.