DataTools Package

Contains:

• functions and modules that can be applied across the Isomemo Apps, and
• an app to test the modules.

Documenation

• https://pandora-isomemo.github.io/data-tools/

Release notes:

• see NEWS.md

The Import Data Module

Access to uploads from file, url, and the Pandora Platform. Optionally, merge data before the import via UI or SQL.

UI function:

DataTools::importDataUI(id, label = "Import Data")

Server function:

DataTools::importDataServer(id, rowNames = NULL, colNames = NULL, customWarningChecks = list(), customErrorChecks = list(), ignoreWarnings = FALSE, defaultSource = "ckan")

Example how to apply the UI and the server function in a shiny module:

data-tools/R/01-toolsPanel.R

Line 13 in 91a16dd

importDataUI(ns("localData"), "Import Data")

data-tools/R/01-toolsPanel.R

Lines 31 to 37 in 91a16dd

	importedData <- importDataServer(
	"localData",
	customWarningChecks = list(reactive(checkWarningEmptyValues)),
	customErrorChecks = list(reactive(checkErrorNoNumericColumns)),
	ignoreWarnings = TRUE,
	defaultSource = defaultSource
	)

Functions to check the validity of imports:

DataTools::checkWarningEmptyValues(data)
DataTools::checkAnyNonNumericColumns(data)
DataTools::checkErrorNoNumericColumns(data)

General helper functions

• function to catch and forward errors and warnings to the app's UI

  shinyTools::shinyTryCatch(expr, messagePreError)

---

Naming conventions in this package

Numbers as Prefix. Grouped into files with same type of functionality.
Lower number indicate that the functions are closer to the functionality of the app / higher abstraction level

00: Start application / main functionality / Namespace
01: Main shiny modules (basically tabs in the app)
02: Helper shiny modules (files include ui + server component)
03: Helper functions