|
| 1 | +# movedesign |
| 2 | + |
| 3 | +## Why `movedesign`? |
| 4 | + |
| 5 | +`movedesign` is built using R language with Shiny for an easy-to-use |
| 6 | +user interface (GUI). This application will allow you to test different |
| 7 | +tracking schedules while considering an initially set research question |
| 8 | +(currently *home range* and *speed/distance* estimation). |
| 9 | + |
| 10 | +- Doesn’t require R coding experience. |
| 11 | +- Leverages the `ctmm` R package for statistically unbiased methods. |
| 12 | + |
| 13 | +## How to start: |
| 14 | + |
| 15 | +The application includes a built-in guided tutorial to help you navigate |
| 16 | +its features. When you open the `'Home'` tab, you’ll find the following: |
| 17 | + |
| 18 | + |
| 19 | + |
| 20 | +This step-by-step guide will walk you through the app, ensuring you |
| 21 | +understand its features and functionality. When an action is required, |
| 22 | +it will be clearly highlighted. Please follow these instructions |
| 23 | +carefully, as each step builds on the previous one. If no action is |
| 24 | +needed, simply continue to the next step by clicking `'Next'` or |
| 25 | +pressing the right arrow key on your keyboard. The information from the |
| 26 | +guided tour is also partially available below. |
| 27 | + |
| 28 | +Warning: |
| 29 | +During the guided tutorial, refrain from interacting with anything |
| 30 | +outside the highlighted zones to avoid interruptions. |
| 31 | + |
| 32 | +This tutorial provides an overview of key features but does not cover |
| 33 | +detailed definitions. For more in-depth explanations, you can access |
| 34 | +comprehensive |
| 35 | +**help |
| 36 | +tips** at any time. Documentation is also available on Silva *et al.* |
| 37 | +([2023](#ref-silva2023movedesign)). |
| 38 | + |
| 39 | +### Workflows |
| 40 | + |
| 41 | +These are the current options for `movedesign` workflows. Users may |
| 42 | +configure their study design by selecting different options for data |
| 43 | +source, research target, and analytical target. All workflows follow a |
| 44 | +stepwise approach, with tabs displayed sequentially on the right |
| 45 | +sidebar. Irrelevant tabs for the current workflow will be automatically |
| 46 | +hidden. |
| 47 | + |
| 48 | +**Step 1.** *Data source:* |
| 49 | + |
| 50 | +Users can specify what is their data source: |
| 51 | + |
| 52 | +`Upload`: Import a dataset from a local file. |
| 53 | + |
| 54 | +`Select`: Choose from pre-existing datasets available in the |
| 55 | +application. |
| 56 | + |
| 57 | +`Simulate`: Generate synthetic data for testing or modeling purposes. |
| 58 | + |
| 59 | +**Step 2.** *Research target:* |
| 60 | + |
| 61 | +Users can define their research targets: |
| 62 | + |
| 63 | +`Home range`: Estimate long-term space-use requirements. |
| 64 | + |
| 65 | +`Speed & distance`: Estimate fine-scale movement metrics, such as speed |
| 66 | +and distance traveled. |
| 67 | + |
| 68 | +**Step 3.** *Analytical target:* |
| 69 | + |
| 70 | +Users can decide on their analytical target for the estimates: |
| 71 | + |
| 72 | +`Individual estimate`: Obtain metrics for a single individual. |
| 73 | + |
| 74 | +`Mean estimate of sampled population`: Obtain a mean estimate across a |
| 75 | +sampled group. |
| 76 | + |
| 77 | +`Compare estimates of two sampled groups`: Perform a comparative |
| 78 | +analysis between two groups within a tracked population (for the |
| 79 | +detection of sub-groups). |
| 80 | + |
| 81 | +Additionally, users have the option to: |
| 82 | + |
| 83 | +`Add individual variation`: Include variation among individuals during |
| 84 | +simulations (only available for mean and estimate comparisons). |
| 85 | + |
| 86 | +Go |
| 87 | +[here](https://ecoisilva.github.io/movedesign/articles/tutorial_ind.html) |
| 88 | +for more detailed information regarding the `Individual estimate` |
| 89 | +workflow. |
| 90 | + |
| 91 | +### Related work |
| 92 | + |
| 93 | +- The [ctmm](https://github.com/ctmm-initiative/ctmm) R package and |
| 94 | + [ctmmweb](https://github.com/ctmm-initiative/ctmmweb) Shiny |
| 95 | + application. |
| 96 | + |
| 97 | +### References |
| 98 | + |
| 99 | +Silva, I., Fleming, C. H., Noonan, M. J., Fagan, W. F., & Calabrese, J. |
| 100 | +M. (2023). Movedesign: Shiny r app to evaluate sampling design for |
| 101 | +animal movement studies. *Methods in Ecology and Evolution*, *14*(9), |
| 102 | +2216–2225. <https://doi.org/10.1111/2041-210X.14153> |
0 commit comments