ds.dim | R Documentation |
Gives the dimensions of an R object on the server-side.
This function is similar to R function dim
.
ds.dim(x = NULL, type = "both", checks = FALSE, datasources = NULL)
x |
a character string providing the name of the input object. |
type |
a character string that represents the type of analysis to carry out.
If |
checks |
logical. If TRUE undertakes all DataSHIELD checks (time-consuming). Default FALSE. |
datasources |
a list of |
The function returns the dimension of the server-side input object (e.g. array, matrix or data frame) from every single study and the pooled dimension of the object by summing up the individual dimensions returned from each study.
In checks
parameter is suggested that checks should only be undertaken once the
function call has failed.
Server function called: dimDS
ds.dim
retrieves to the client-side the dimension of the object
in the form of a vector where the first
element indicates the number of rows and the second element indicates the number of columns.
DataSHIELD Development Team
ds.dataFrame
to generate a table of the type data frame.
ds.changeRefGroup
to change the reference level of a factor.
ds.colnames
to obtain the column names of a matrix or a data frame
ds.asMatrix
to coerce an object into a matrix type.
ds.length
to obtain the size of a vector.
## 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")
# Calculate the dimension
ds.dim(x="D",
type="combine", #global dimension
checks = FALSE,
datasources = connections)#all opal servers are used
ds.dim(x="D",
type = "both",#separate dimension for each study
#and the pooled dimension (default)
checks = FALSE,
datasources = connections)#all opal servers are used
ds.dim(x="D",
type="split", #separate dimension for each study
checks = FALSE,
datasources = connections[1])#only the first opal server is used ("study1")
# 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.