Skip to content

Template including all files needed to create a app with R Shiny

Notifications You must be signed in to change notification settings

movestore/Template_R_Shiny_App

Repository files navigation

Name of App (Give your app a short and informative title. Please adhere to our convention of Title Case without hyphens (e.g. My New App))

MoveApps

Github repository: github.com/yourAccount/Name-of-App (provide the link to the repository where the code of the App can be found)

Description

Enter here the short description of the App that might also be used when filling out the description during App submission to MoveApps. This text is directly presented to Users that look through the list of Apps when compiling Workflows.

Documentation

Enter here a detailed description of your App. What is it intended to be used for. Which steps of analyses are performed and how. Please be explicit about any detail that is important for use and understanding of the App and its outcomes. You might also refer to the sections below.

Application scope

Generality of App usability

State here if the App was developed for a specific species, taxon or taxonomic group, or to answer a specific question. How might it influence the scope and utility of the App. This information will help the user to understand why the App might be producing no or odd results.

Examples:

This App was developed using data of birds.

This App was developed using data of red deer.

This App was developed for any taxonomic group.

This App was developed to identify kill sites, but can probably be used to identify any kind of location clusters like nests, dens or drinking holes.

Required data properties

State here the required and/or optimal data properties for this App to perform properly.

Examples:

This App is only applicable to data that reflect range resident behavior.

The data should have a fix rate of at least 1 location per 30 minutes.

The App should work for any kind of (location) data.

Input type

Indicate which type of input data the App requires.

Example: move2::move2_loc

Output type

Indicate which type of output data the App produces to be passed on to subsequent Apps.

Example: move2::move2_loc

Artefacts

If the App creates artefacts (e.g. csv, pdf, jpeg, shapefiles, etc), please list them here and describe each.

Example: rest_overview.csv: csv-file with Table of all rest site properties

Settings

Please list and define all settings that the App requires to be set by the App user, if necessary including their unit. Please state each of the settings that the user will encounter in the UI of the shiny app.

Example: Radius of resting site (radius): Defined radius the animal has to stay in for a given duration of time for it to be considered resting site. Unit: metres.

Always include the "Store settings" setting as it will appear automatically in all shiny apps Store settings: click to store the current settings of the App for future Workflow runs.

Changes in output data

Specify here how and if the App modifies the input data. Describe clearly what e.g. each additional column means.

Examples:

The App adds to the input data the columns Max_dist and Avg_dist. They contain the maximum distance to the provided focal location and the average distance to it over all locations.

The App filterers the input data as selected by the user.

The output data is the outcome of the model applied to the input data.

The input data remains unchanged.

Most common errors

Please describe shortly what most common errors of the App can be, how they occur and best ways of solving them.

Null or error handling

Please indicate for each setting as well as the input data which behaviour the App is supposed to show in case of errors or NULL values/input. Please also add notes of possible errors that can happen if settings/parameters are improperly set and any other important information that you find the user should be aware of.

Example: Setting radius: If no radius AND no duration are given, the input data set is returned with a warning. If no radius is given (NULL), but a duration is defined then a default radius of 1000m = 1km is set.