-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathREADME.Rmd
More file actions
83 lines (65 loc) · 6.87 KB
/
README.Rmd
File metadata and controls
83 lines (65 loc) · 6.87 KB
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
---
output: md_document
---
# Ecosystem and Socioeconomic Profiles
```{r, echo = FALSE, results='asis', message=FALSE}
`%>%` <- magrittr::`%>%`
# custom code size badge
files <- list.files(recursive = TRUE, all.files = TRUE) %>%
stringr::str_subset(pattern = ".Rproj", negate = TRUE) %>%
stringr::str_subset(pattern = ".Rhistory", negate = TRUE) %>%
stringr::str_subset(pattern = ".RData", negate = TRUE) %>%
stringr::str_subset(pattern = ".Ruserdata", negate = TRUE) %>%
stringr::str_subset(pattern = ".Renviron", negate = TRUE)
total_size <- (sum(file.size(files))/1073741824) %>%
stringr::str_trunc(width = 4, ellipsis = "")
cat(badger::badge_last_commit("NOAA-EDAB/esp_data_aggregation"),
badger::badge_custom("repo size", paste(total_size, "GB"), color = "blue"))
```
[](https://github.com/NOAA-EDAB/esp_data_aggregation/actions/workflows/secretScan.yml)
[/badge.svg)](https://github.com/NOAA-EDAB/esp_data_aggregation/actions/workflows/render_indicator_reports_dev.yaml)
[/badge.svg)](https://github.com/NOAA-EDAB/esp_data_aggregation/actions/workflows/render_regression_reports_dev.yaml)
## View current data products
https://nefsc.github.io/READ-EDAB-ESP_docs/docs
## Introduction
Ecosystem and Socioeconomic Profiles (ESPs) are a scientific product to support [Integrated Ecosystem Assessment](https://www.integratedecosystemassessment.noaa.gov/) (IEA). IEA seeks to improve understanding and management of fisheries through incorporating natural, social, and economic data into fisheries analyses and management plans. ESPs are a structured framework developed by the Alaska Science Center to integrate ecosystem and socioeconomic information into the stock assessment process.<sup>[1]</sup>
Here we adapt the ESP process for use in the management of Northeast stocks. Our scientific roadmap consists of these steps:
1. Gather existing data on ecology, biology, socioeconomics, and the human dimension of Northeast fisheries.
2. Conduct a risk analysis of Northeast stocks to determine which stocks are most vulnerable.
3. Create detailed reports for the most vulnerable stocks, incorporating data from the originial risk assessment as well as detailed species-specific information.
## The Northeast ESP suite
There are currently 4 github repos associated with the Northeast ESP initiative.
1. [`NOAA-EDAB/esp_data_aggregation`](https://github.com/NOAA-EDAB/esp_data_aggregation) is the original repo and currently houses development and exploratory work.
2. [`NEFSC/READ-EDAB-NEesp`](https://github.com/NEFSC/READ-EDAB-NEesp) houses an R package that contains relevant data, functions for low-level data analysis and plotting, and report templates.
3. [`NEFSC/READ-EDAB-NEespShiny`](https://github.com/NEFSC/READ-EDAB-NEespShiny) houses an R Shiny app (in the form of an R package) that provides a graphical user interface for creating reports with the `NEesp` package.
4. [`NEFSC/READ-EDAB-ESP_docs`](https://github.com/NEFSC/READ-EDAB-ESP_docs) houses reports on Northeast stocks and ecosystem/socioeconomic indicators.
## Data and analysis
The current preliminary report aggregates data from many existing sources and creates several data visualizations. Reports for all northeast stocks have been compiled and can be viewed [here](https://nefsc.github.io/READ-EDAB-ESP_docs/docs). We have recently aggregated our data, functions, and report templates into a preliminary R package that can be viewed in the [package repo](https://github.com/NEFSC/READ-EDAB-NEesp). The package can be downloaded locally in R with the command `devtools::install_github("NEFSC/READ-EDAB-NEesp")`.
## Running a report
### Running a report with code
After downloading the `NEesp` R package, a report can be generated locally with the command `NEesp::render_ind_report("Acadian redfish")` (replace "Acadian redfish" with the name of species of interest). Please note, report generation will take some time (2+ minutes per species).
### Running a report with `R shiny`
We have recently developed an `R shiny` app to visualize Northeast ESP data, which is bundled into the `NEespShiny` R package. The app can be installed in R with: `remotes::install_github("NEFSC/READ-EDAB-NEespShiny")`. If installation throws an error, you may have to override package installation errors from warnings with: `sys.setenv(R_REMOTES_NO_ERRORS_FROM_WARNINGS="true")`. Once you have installed the package, you can use the Shiny app by running: `NEespShiny::run_NEesp()`.
## Next steps
We continue to synthesize existing data on Northeast stocks, environment, and socioeconomics. We are currently refining our data analyses and beginning the preliminary risk assessment process.
## Disclaimer
These reports are a work in progress and should not be viewed as a final or complete product at this time. We do not guarantee that these reports are free from errors; please contact us if you notice any issues.
[1]: https://meetings.npfmc.org/CommentReview/DownloadFile?p=8f5233fb-3b62-4571-9b49-8bb7ce675916.pdf&fileName=ESP_Shotwell.pdf
## Developers
| [atyrell3](https://github.com/atyrell3) | [rtabandera](https://github.com/rtabandera) |
|-------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| [](https://github.com/atyrell3) | [](https://github.com/rtabandera) |
#### Legal disclaimer
*This repository is a scientific product and is not official
communication of the National Oceanic and Atmospheric Administration, or
the United States Department of Commerce. All NOAA GitHub project code
is provided on an 'as is' basis and the user assumes responsibility for
its use. Any claims against the Department of Commerce or Department of
Commerce bureaus stemming from the use of this GitHub project will be
governed by all applicable Federal law. Any reference to specific
commercial products, processes, or services by service mark, trademark,
manufacturer, or otherwise, does not constitute or imply their
endorsement, recommendation or favoring by the Department of Commerce.
The Department of Commerce seal and logo, or the seal and logo of a DOC
bureau, shall not be used in any manner to imply endorsement of any
commercial product or activity by DOC or the United States Government.*