Getting started with FreesearchR
Below is a simple walk-trough and basic instructions for the functions on the FreesearchR app.
Launching
The easiest way to get started is to launch the hosted version of the app on shinyapps.io (click this link).
Additionally you have the option to run the app locally with access to any data in your current working environment.
To do this, open R (or RStudio or similar), and run the following code to install the latest version of FreesearchR and launch the app:
require("pak")
pak::pak("agdamsbo/FreesearchR")
library(FreesearchR)
FreesearchR::launch_FreesearchR()As a small note, a standalone Windows app version is on the drawing board as well, but no time frame is available.
Importing data
Once in the app and in the “Import”, you have three options available for importing data: file upload, REDCap server export and local or sample data.
After choosing a data source, you can set a threshold to filter data be completenes and further manually specify variables to include for analyses.
File upload
Currently several data file formats are supported for easy import (csv, txt, xls(x), ods, rds, dta). If importing workbooks (xls(x) or ods), you are prompted to specify sheet(s) to import. If choosing multiple sheets, these are automatically merged by common variable(s), so please make sure that key variables are correctly named identically.
A notification is posted with error or success. After succesfull import data can be previewed directly by clicking “click to see data” in the notification.
REDCap server export
Export data directly from a REDCap server. You need to first generate an API-token (see these instruction) in REDCap. Make sure you have the necessary rights to do so.
Please don’t store the API-key on your device unless encrypted or in a keyring, as this may compromise data safety. Log in to your REDCap server and retrieve the token when needed.
Type the correct webaddress of your REDCap server.
The module will validate the information and you can click “Connect”.
This will unfold options to preview your data dictionary (the main database metadata), choose fields/variables to download as well as filtering options.
Visuals
There are a number of plotting options to visualise different aspects of the data.
Below are the available plot types listed.
| Data type | Plot type | Description |
|---|---|---|
| continuous | Violin plot | A modern alternative to the classic boxplot to visualise data distribution |
| continuous | Scatter plot | A classic way of showing the association between to variables |
| continuous | Box plot | A classic way to plot data distribution by groups |
| dichotomous | Stacked horizontal bars | A classical way of visualising the distribution of an ordinal scale like the modified Ranking Scale and known as Grotta bars |
| dichotomous | Violin plot | A modern alternative to the classic boxplot to visualise data distribution |
| dichotomous | Sankey plot | A way of visualising change between groups |
| dichotomous | Box plot | A classic way to plot data distribution by groups |
| dichotomous | Euler diagram | Generate area-proportional Euler diagrams to display set relationships |
| ordinal | Stacked horizontal bars | A classical way of visualising the distribution of an ordinal scale like the modified Ranking Scale and known as Grotta bars |
| ordinal | Violin plot | A modern alternative to the classic boxplot to visualise data distribution |
| ordinal | Sankey plot | A way of visualising change between groups |
| ordinal | Box plot | A classic way to plot data distribution by groups |
| categorical | Stacked horizontal bars | A classical way of visualising the distribution of an ordinal scale like the modified Ranking Scale and known as Grotta bars |
| categorical | Violin plot | A modern alternative to the classic boxplot to visualise data distribution |
| categorical | Sankey plot | A way of visualising change between groups |
| categorical | Box plot | A classic way to plot data distribution by groups |