From df2af6338d4fd7b3f5de0f63943acfbd38762fab Mon Sep 17 00:00:00 2001 From: annaramji Date: Mon, 10 Jun 2024 11:57:29 -0700 Subject: [PATCH] updated structure, added data inclusion page, media folder organization, figs folder and readme for figs folder --- OHI-score-anatomy.qmd | 2 +- data-inclusion-gaps.qmd | 17 +++++++++++++++++ media/figs/README.md | 14 ++++++++++++++ models/models.qmd | 3 --- regions.qmd | 2 +- 5 files changed, 33 insertions(+), 5 deletions(-) create mode 100644 data-inclusion-gaps.qmd create mode 100644 media/figs/README.md diff --git a/OHI-score-anatomy.qmd b/OHI-score-anatomy.qmd index 3d55deb..442f85e 100644 --- a/OHI-score-anatomy.qmd +++ b/OHI-score-anatomy.qmd @@ -54,7 +54,7 @@ Goal (and subgoal scores) are calculated using several variables (referred to as **Table 2.3. Dimension used to calculate an OHI goal score** Goal scores are the average of current and likely future status. Likely future status adjusts current status scores based on pressures and resilience variables acting on the goal as well as recent trends in status. | Dimension | Subdimension | Description | More information | Calculating | -|-------------------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +|----------|----------|--------------------------|----------|-----------------| | Current status | \- | Current state of the goal relative to the desired "reference point". Values range from 0-100. | *Section 6. Goal models and data* | Calculated using functions in ohi-global repo: https://github.com/OHI-Science/ohi-global/blob/draft/eez/conf/functions.R and the *scenario_data_years.csv* file (in same folder) | | Predicted future status | Resilience | Variables such as good governance and ecological factors that provide resilience to pressures, and thus, are likely to improve future status. Values range from 0-100 | *Section 5.3 Likely future status dimensions* | Calculated using functions in ohicore package.And, files: *resilience_categories.csv* and *resilience_matrix.csv* located here: https://github.com/OHI-Science/ohi-global/tree/draft/eez/conf | | Predicted future status | Pressure | Pressures stress the system and threaten future delivery of benefits, and thus, are likely to reduce future status. Values range from 0-100 | *Section 5.3 Likely future status dimensions* | Calculated using function in ohicore package. And, files: *pressure_categories.csv* and *pressures_matrix.csv*, located here: https://github.com/OHI-Science/ohi-global/tree/draft/eez/conf | diff --git a/data-inclusion-gaps.qmd b/data-inclusion-gaps.qmd new file mode 100644 index 0000000..064bb58 --- /dev/null +++ b/data-inclusion-gaps.qmd @@ -0,0 +1,17 @@ +--- +title: "Data: Inclusion & Gaps" + +--- + + +# Data inclusion and data gaps + +Ideally, regional and local assessments should use the best available data, but this decision limits the ability to compare across scales. For direct comparisons among locations to be valid, they must use consistent data. For this reason, we focused on using global datasets so differences in Index scores across regions are driven by differences in ocean health rather than variation in the data. Although, in reality, many global datasets are compilations of local or regional datasets and their quality varies spatially. In some cases, data for a particular component or dimension of a goal were available for most, but not all, countries. Gaps in these data were known to not be true zero values. Rather than exclude these data layers, we employed several different methods to fill these data gaps [@frazier2016mapping]. + +These guidelines both motivated and constrained our methods. The development of the model frameworks for each goal (including reference points) was heavily dictated by the availability of global datasets. And, ultimately, several key elements related to ocean health could not be included due to lack of existing or appropriate global datasets. As new and better data become available in the future, details of how goals or dimensions are modeled will likely change, although the framework we have developed can accommodate these changes. + +For Index scores to be comparable, every region must have a value for each data layer included in the analysis, unless it is known to not be relevant to a region. In other words, missing data are not acceptable [@burgass2017navigating]. Adhering to this criterion is critical to avoid influencing the Index score simply because of inclusion (or absence) of a particular data layer for any reporting region. + +Gaps in data are common; many developing countries lack the resources to gather detailed datasets, and even developed, data-rich countries have inevitable data gaps. We use a variety of methods to estimate missing data, including: averages of closely related groups (e.g., regions sharing ecological, spatial, political attributes; taxonomic groups; etc.), spatial or temporal interpolation (e.g., raster or time-series data), and predictive models (e.g., regression analysis, machine learning, etc.). Gapfilling is a major source of uncertainty, especially for certain goals and regions. Given how common gaps in data are, clear documentation of gapfilling is a critical step of index development because it provides a measure of the reliability of index scores. + +One of the ongoing goals of the Ocean Health Index (OHI) has been to improve our approach to dealing with missing data, by quantifying the potential influence of gapfilled data on index scores, and developing effective methods of tracking, quantifying, and communicating this information [@frazier2016mapping]. diff --git a/media/figs/README.md b/media/figs/README.md new file mode 100644 index 0000000..3e50e50 --- /dev/null +++ b/media/figs/README.md @@ -0,0 +1,14 @@ + +! Work in progress!! + +This folder contains (will contain) the figures that the various subpages refer to. + +For example, the regions.qmd file currently contains this inherited file path: + +![](../../yearly_results/global2023/Results/figures/maps_by_goal_mol/global_map_Index_2023_mol.png) + +which goes to nothing. Instead, it should have the path: + +media/figs/name_of_figure.png + +where name_of_figure is the name of the figure that the subpage refers to (which we'll need to download from ohi-global) diff --git a/models/models.qmd b/models/models.qmd index 1dbf35f..4ca9ff2 100644 --- a/models/models.qmd +++ b/models/models.qmd @@ -1,9 +1,6 @@ --- title: "4. Models" toc: TRUE -editor: - markdown: - wrap: 72 --- ```{r models_setup} diff --git a/regions.qmd b/regions.qmd index 17b2ccc..29d7658 100644 --- a/regions.qmd +++ b/regions.qmd @@ -3,7 +3,6 @@ title: "3. Regions" --- - # Regions One of the first steps of conducting an OHI assessment is defining regions of interest. These can be based on political and/or ecological boundaries. The definition of a “region” varies depending on the goals and scale of the OHI assessment. For the global OHI, each region is defined as the Exclusive Economic Zone boundaries [EEZ, @claus2012marine] area (300 nm offshore) for all coastal countries and territories (e.g., US Virgin Islands). @@ -12,6 +11,7 @@ There are 220 global coastal countries and territorial regions (Table 4.1). Regi **Figure 4.1. Global regions** Map of the OHI regions (with color corresponding to 2022 regional index scores). Mollweide coordinate reference system is used because it accurately represents area. +[add to media/figs folder!] ![](../../yearly_results/global2023/Results/figures/maps_by_goal_mol/global_map_Index_2023_mol.png) **Table 4.1. Global regions**