ds.getWGSR | R Documentation |
Calculate WHO Growth Reference z-score for a given anthropometric measurement
This function is similar to R function getWGSR
from the zscorer
package.
ds.getWGSR(
sex = NULL,
firstPart = NULL,
secondPart = NULL,
index = NULL,
standing = NA,
thirdPart = NA,
newobj = NULL,
datasources = NULL
)
sex |
the name of the binary variable that indicates the sex of the subject. This must
be coded as 1 = male and 2 = female. If in your project the variable sex has different
levels, you should recode the levels to 1 for males and 2 for females using the
|
firstPart |
Name of variable specifying: |
secondPart |
Name of variable specifying: |
index |
The index to be calculated and added to data. One of: |
standing |
Variable specifying how stature was measured. If NA (default) then age (for "hfa" or "lfa") or height rules (for "wfh" or "wfl") will be applied. This must be coded as 1 = Standing; 2 = Supine; 3 = Unknown. Missing values will be recoded to 3 = Unknown. Give a single value (e.g."1"). If no value is specified then height and age rules will be applied. |
thirdPart |
Name of variable specifying age (in days) for BMI/A. Give a quoted variable
name as in (e.g.) "age". Be careful with units (age in days). If age is given in different units
you should convert it in age in days using the |
newobj |
a character string that provides the name for the output variable
that is stored on the data servers. Defaults |
datasources |
a list of |
The function calls the server-side function getWGSRDS
that computes the WHO
Growth Reference z-scores of anthropometric data for weight, height or length, MUAC (middle
upper arm circumference), head circumference, sub-scapular skinfold and triceps skinfold.
Note that the function might fail or return NAs when the variables are outside the ranges
given in the WGS (WHO Child Growth Standards) reference (i.e. 45 to 120 cm for height and
0 to 60 months for age). It is up to the user to check the ranges and the units of their
data.
ds.getWGSR
assigns a vector for each study that includes the z-scores for the
specified index. The created vectors are stored in the servers.
Demetris Avraam for DataSHIELD Development Team
## Not run:
# Connecting to the Opal servers
require('DSI')
require('DSOpal')
require('dsBaseClient')
builder <- DSI::newDSLoginBuilder()
builder$append(server = "study1",
url = "http://192.168.56.100:8080/",
user = "administrator", password = "datashield_test&",
table = "ANTHRO.anthro1", driver = "OpalDriver")
builder$append(server = "study2",
url = "http://192.168.56.100:8080/",
user = "administrator", password = "datashield_test&",
table = "ANTHRO.anthro2", driver = "OpalDriver")
builder$append(server = "study3",
url = "http://192.168.56.100:8080/",
user = "administrator", password = "datashield_test&",
table = "ANTHRO.anthro3", driver = "OpalDriver")
logindata <- builder$build()
# Log onto the remote Opal training servers
connections <- DSI::datashield.login(logins = logindata, assign = TRUE, symbol = "D")
# Example 1: Generate the weight-for-height (wfh) index
ds.getWGSR(sex = "D$sex", firstPart = "D$weight", secondPart = "D$height",
index = "wfh", newobj = "wfh_index", datasources = connections)
# Example 2: Generate the BMI for age (bfa) index
ds.getWGSR(sex = "D$sex", firstPart = "D$weight", secondPart = "D$height",
index = "bfa", thirdPart = "D$age", newobj = "bfa_index", datasources = connections)
# clear the Datashield R sessions and logout
datashield.logout(connections)
## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.