Get Byline Metadata

Retrieves byline fields (BYLINE1, BYLINE2, etc.) from metadata for a specified program name or TFL number.

Usage

get_byline(df, tnumber = NULL, pname = NULL, oid = NULL)

Arguments

df

A data frame containing TFL metadata.

tnumber

An optional character string specifying the TFL number stored in TTL1, such as "Table 14.1.1".

pname

An optional character string specifying the program name stored in PGMNAME.

Exactly one of tnumber or pname must be supplied.

oid

An optional character string specifying the object ID stored in OID. Use this when multiple rows match the program name.

Value

A data frame of the non-missing byline fields.

See also

read_tfile() to read metadata from Excel or CSV;

get_title(), get_footnote(), get_source(), get_pop(), get_pgmname(), get_ulheader(), get_urheader(), and get_bookm() for retrieving individual annotation fields;

change_colname() to standardize column names in the metadata file.

Examples

meta <- data.frame(
  PGMNAME = c("t_dm", "t_ae"),
  TTL1 = c("Table 14.1.1", "Table 14.3.1"),
  SOURCE = c("ADSL", "ADAE"),
  BYLINE1 = c("Treatment Group", "System Organ Class"),
  BYLINE2 = c("N (%)", "Preferred Term"),
  FOOT1 = c("ITT Population", "Safety Population")
)

get_byline(meta, pname = "t_dm")
#>           BYLINE1 BYLINE2
#> 1 Treatment Group   N (%)
get_byline(meta, tnumber = "Table 14.3.1")
#>              BYLINE1        BYLINE2
#> 2 System Organ Class Preferred Term