Repository files navigation

ServerlessDataSHIELD Interface (DSI) implementation which purpose is to mimicthe behavior of a distant (virtualized or barebone) data repository server (seeDSOpal for instance). Thedatasets that are being analyzed are fully accessible in the local environment. The DataSHIELD configuration (set ofallowed aggregation and assignment functions) is discovered at runtime by inspecting the DataSHIELD server-side R packagesinstalled locally. This configuration can also be amended or provided explicitly.

The DSLite "server" (seeDSLiteServer) is aR6 class. An instance of this class will host the datasets to be analyzed and the DataSHIELDconfiguration and will perform the DataSHIELD operations in the context of a session (a contained R environment).

DSLite can be used to:

• speed up development and testing cycle when developping new DataSHIELD functions (both at server and client side): noneed to deploy a data repository infrastructure.
• allow DataSHIELD analysis with combined datasets, some of them being accessible remotely in secure data repositories,others being privatly accessible (in a governmental institution for instance).

The following figure illustrates a setup where a singleDSLiteServerholds several data frames and is used by two different DataSHIELD Connection (DSConnection) objects.All these objects live in the same R environment (usually the Global Environment). The "server" is responsible for managing DataSHIELDsessions that are implemented as distinct R environments inside of which R symbols are assigned and R functions are evaluated.Using theR environment paradigm ensures that the different DataSHIELD execution context(client and servers) are contained and exclusive from each other.

The minimum steps to follow for this kind of setup:

• make sure that both DataSHIELD client-side and server-side R packages are installed in your local R session,
• load harmonized datasets in data frames (with the method of your choice),
• instanciate a newDSLiteServer and provide a named list of these data frames,
• prepare DataSHIELD logindata object where thetable to assign is the name of one the data frames and theurl is the symbol that refers to theDSLiteServer object,
• perform DataSHIELD login and do analysis.

See usageexamples.

Article about DataSHIELD:

• DataSHIELD: taking the analysis to the data, not the data to the analysis