ds.igb_standards: Converts birth measurements to intergrowth z-scores/centiles

View source: R/ds.igb_standards.R

ds.igb_standardsR Documentation

Converts birth measurements to intergrowth z-scores/centiles

Description

Converts birth measurements to INTERGROWTH z-scores/centiles (generic)

Usage

ds.igb_standards(
  gagebrth = NULL,
  z = 0,
  p = 50,
  val = NULL,
  var = NULL,
  sex = NULL,
  fun = "igb_value2zscore",
  newobj = NULL,
  datasources = NULL
)

Arguments

gagebrth

the name of the "gestational age at birth in days" variable.

z

z-score(s) to convert (must be between 0 and 1). Default value is 0. This value is used only if fun is set to "igb_zscore2value".

p

centile(s) to convert (must be between 0 and 100). Default value is p=50. This value is used only if fun is set to "igb_centile2value".

val

the name of the anthropometric variable to convert.

var

the name of the measurement to convert ("lencm", "wtkg", "hcircm", "wlr").

sex

the name of the sex factor variable. The variable should be coded as Male/Female. If it is coded differently (e.g. 0/1), then you can use the ds.recodeValues function to recode the categories to Male/Female before the use of ds.igb_standards.

fun

the name of the function to be used. This can be one of: "igb_centile2value", "igb_zscore2value", "igb_value2zscore" (default), "igb_value2centile".

newobj

a character string that provides the name for the output variable that is stored on the data servers. Default name is set to igb.newobj.

datasources

a list of DSConnection-class objects obtained after login. If the datasources argument is not specified the default set of connections will be used: see datashield.connections_default.

Value

assigns the converted measurement as a new object on the server-side

Note

For gestational ages between 24 and 33 weeks, the INTERGROWTH very early preterm standard is used.

Author(s)

Demetris Avraam for DataSHIELD Development Team

References

International standards for newborn weight, length, and head circumference by gestational age and sex: the Newborn Cross-Sectional Study of the INTERGROWTH-21st Project Villar, José et al. The Lancet, Volume 384, Issue 9946, 857-868 INTERGROWTH-21st very preterm size at birth reference charts. Lancet 2016 doi.org/10.1016/S0140-6736(16) 00384-6. Villar, José et al.


datashield/dsBaseClient documentation built on Nov. 16, 2024, 2:07 p.m.