yspec: yspec: data specification documents from yaml

In metrumresearchgroup/yspec: Data Specification for Pharmacometrics

yspec: data specification documents from yaml

Description

After writing data specification details in yaml format, read in as an object in R, query data set details, check / validate data sets, and write out data definition documents. To get started, check out the vignettes.

Workflow

• Write your document in yaml format

  • Include a ⁠SETUP__:⁠ block at the top to include meta information

  • Use lookups from either the internal library or your own lookup file

  • Syntax reference here

  • Use ys_help to access examples

• Use ys_load() to read in the yaml file

  • Use the .verbose to see more information while this is in progress

• Once the spec object is loaded

  • spec$col to see the definition of col

  • summary(spec) to see a summary

  • yspec_add_factors() to create factors in the data set

• Use ys_check() to check a data frame against the spec

• Use ys_document() to render the specification object as a pdf file

• Use ys_project() to create a collection of individual data specification objects; this also can be rendered as a pdf file with ys_document()

• Get help: Use ys_help to get further help and documentation in your R session

Package-wide options

• ys.sanitize a function to use for sanitizing text before processing with latex; see pander_table()

• ys.fct.suffix the suffix to add to a column name, used by yspec_add_factors()

• ys.require.label if TRUE, an error will be generated whenever a column is specified without a label

NOTE: ys.col.len was an available in previous versions to set the maximum number of characters allowable in a column name. This options has been deprecated. Please use max_char_col in ⁠SETUP__:⁠ instead.

metrumresearchgroup/yspec documentation built on Dec. 22, 2024, 1:37 a.m.