View source: R/ds.recodeValues.R
ds.recodeValues | R Documentation |
This function takes specified values of elements in a vector and converts them to a matched set of alternative specified values.
ds.recodeValues(
var.name = NULL,
values2replace.vector = NULL,
new.values.vector = NULL,
missing = NULL,
newobj = NULL,
datasources = NULL,
notify.of.progress = FALSE
)
var.name |
a character string providing the name of the variable to be recoded. |
values2replace.vector |
a numeric or character vector specifying the values
in the variable |
new.values.vector |
a numeric or character vector specifying the new values. |
missing |
If supplied, any missing values in var.name will be replaced by this value.
Must be of length 1. If the analyst want to recode only missing values then it should also
specify an identical vector of values in both arguments |
newobj |
a character string that provides the name for the output object
that is stored on the data servers.
Default |
datasources |
a list of |
notify.of.progress |
logical. If TRUE console output should be produced to indicate progress. Default FALSE. |
This function recodes individual values with new individual values. This can
apply to numeric and character values, factor levels and NAs. One particular use of
ds.recodeValues
is to convert NAs to an explicit value. This value is specified
in the argument missing
. If tthe user want to recode only missing values, then it
should also specify an identical vector of values in both arguments values2replace.vector
and new.values.vector
(see Example 2 below).
Server function called: recodeValuesDS
Assigns to each server a new variable with the recoded values. Also, two validity messages are returned to the client-side indicating whether the new object has been created in each data source and if so whether it is in a valid form.
DataSHIELD Development Team
## Not run:
## Version 6, for version 5 see the Wiki
# 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 = "CNSIM.CNSIM1", driver = "OpalDriver")
builder$append(server = "study2",
url = "http://192.168.56.100:8080/",
user = "administrator", password = "datashield_test&",
table = "CNSIM.CNSIM2", driver = "OpalDriver")
builder$append(server = "study3",
url = "http://192.168.56.100:8080/",
user = "administrator", password = "datashield_test&",
table = "CNSIM.CNSIM3", driver = "OpalDriver")
logindata <- builder$build()
connections <- DSI::datashield.login(logins = logindata, assign = TRUE, symbol = "D")
# Example 1: recode the levels of D$GENDER
ds.recodeValues(var.name = "D$GENDER",
values2replace.vector = c(0,1),
new.values.vector = c(10,20),
newobj = 'gender_recoded',
datasources = connections)
# Example 2: recode NAs in D$PM_BMI_CATEGORICAL
ds.recodeValues(var.name = "D$PM_BMI_CATEGORICAL",
values2replace.vector = c(1,2),
new.values.vector = c(1,2),
missing = 99,
newobj = 'bmi_recoded'
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.