-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.Rmd
85 lines (60 loc) · 3.41 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# vprr <a href="https://eogrady21.github.io/vprr/"><img src="man/figures/vprr_hex.png" align="right" height="138" /></a>
<!-- badges: start -->
[](https://cran.r-project.org/package=vprr)
[](https://github.com/EOGrady21/vprr/actions/workflows/r.yml)
<!-- badges: end -->
The goal of vprr is to process Video Plankton Recorder (VPR) data in R.
This package allows for manual image classification,
calculation of important ecological metrics such as concentration of
plankton, data visualization, and data output with self-contained
metadata.
Detailed information about vprr can be found in the
package vignette.
## Installation
You can install the released version of vprr from [CRAN](https://CRAN.R-project.org) with:
``` r
install.packages("vprr")
```
And the development version from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github("EOGrady21/vprr")
```
## Details
vprr is designed to be used after processing VPR data with an automated image classification system. vprr utilizes file formats and directory structures consistent with those from Visual Plankton (VP), a Matlab image classification software designed for VPR datasets; however, vprr is not dependent on any specific elements of VP.
All the technical details of vprr can be found in the package vignette,
available through Rstudio or at <https://eogrady21.github.io/vprr/>
(under Articles).

Figure 1. VPR data processing flow chart. Blue boxes represent software, green and yellow boxes represent data sets, where yellow is visual data and green is text format data. This package represents 'Processing and Visualization (R)'.
The first element of processing VPR data is to classify the images
collected. This can be done using
machine learning techniques and then checked and manually edited in
vprr. vprr uses a GUI, called through `vpr_manual_classification()` to
allow a user to review and change image classifications.

Figure 2. A screenshot from the vprr manual reclassification process. VPR images are displayed in the RStudio Viewer (right), prompts are displayed in the RStudio console (left). Users are asked if classifications are correct, if not, they are asked to select the proper classification from a pre-set list of categories.
Once images have been properly classified, all data sources are
combined, in order to analyze data and calculate
metrics such as plankton concentration. Data from CTD files
(`vpr_ctd_read()`) and image classification (`vpr_autoid_read()`) can be
read in and combined into data frames. vprr can combine VPR
CTD, and VPR image classifications into depth bins, and calculate
concentration (`vpr_roi_concentration()`).
After data is processed, it can be visualized for easy interpretation.
Although this package does not focus on visualization, it does provide
some basic plotting functions for tow-yo VPR data
(`vpr_plot_contour()`).

Figure 3. An example of visualization of VPR data showing calculated concentration of Calanus along the VPR tow-yo path, over density contours.