diff --git a/docs/About/Status/Tool_ReportCard_0-1-00.md b/docs/About/Status/Tool_ReportCard_0-1-00.md new file mode 100644 index 0000000..8c0122e --- /dev/null +++ b/docs/About/Status/Tool_ReportCard_0-1-00.md @@ -0,0 +1,96 @@ +--- +title: Riverscapes Report Card Template +weight: 1 +--- + + +Research Grade +Tool Logo **RIM** is an ArcGIS Toolbox and some ArcPy scripts that take care of file house keeping and metric calculation for mapping (i.e. digitizing) riverscape inundation paterns for individual "data capture events". This report card communicates RIM's compliance with the Riverscape Consortium's published [tool standards](https://riverscapes.net/Tools). + +# Report Card Summary + +| Tool | [Riverscape Inundation Mapper (RIM) Tool](https://rim.riverscapes.net) | +| Version | [0.1.00](https://github.com/Riverscapes/RIM/releases/tag/v0.1.0) | +| Date of Review | 2022, October | +| Assessment Team | Names and/or Links | +| Current Assessment | ![research](https://raw.githubusercontent.com/Riverscapes/riverscapes-website/master/assets/images/tools/grade/TRL_3_32p.png) [Research Grade](https://riverscapes.net/Tools/discrimination.html#tool-grade) | +| Target Status | ![research](https://raw.githubusercontent.com/Riverscapes/riverscapes-website/master/assets/images/tools/grade/TRL_3_32p.png) [Research Grade](https://riverscapes.net/Tools/discrimination.html#tool-grade) → No further development as its own tool, Getting subsumed into ![professional](https://raw.githubusercontent.com/Riverscapes/riverscapes-website/master/assets/images/tools/grade/TRL_5_32p.png) [Professional Grade](https://riverscapes.net/Tools/discrimination.html#professional-grade) [QRiS](https://qris.riverscapes.net)| +| Riverscapes Compliance | ![Riverscapes Compliant](https://riverscapes.net/assets/images/rc/RiverscapesCompliantPending_28.png) [Pending Riverscapes Compliance](https://riverscapes.net/Tools/#riverscapes-compliant-tools) - Because it is Research Grade | +| Assessment Rationale | 1-3 Sentence Summary by reviewers justifying assessment determination and summarizing from details below. | + + + +# Report Card Details + +This tool's [discrimination](https://riverscapes.net/Tools/discrimination#model-discrimination) evaluation by the [Riverscapes Consortium's](https://riverscapes.net) is: + +**Evaluation Key:** +None or Not Applicable: • +Minimal or In Progress: • +Functional: • +Fully Developed: + +| Criteria | Value | Evaluation | Comments and/or Recommendations | +|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| :----------------------------- | :----------------------------- | | :----------------------------- | +| [Tool Interface(s)]({{ site.baseurl }}/Tools/discrimination.html#interface) | ArcPy Python Scripts | | While the ArcPy scripts are functional, they are also fragile (typical of many toolboxes and code with ArcPy dependencies). | +| Scale | Reach (cell scale resolution, reach scale extent) | | This toolbox really creates empty feature classes with consistent attributes and naming, to allow the user to digitize riverscape inundation paterns and features at the reach-scale. The user chooses the basemaps (and therefore resolution of imagery), and can decide how detailed to digitize the features. | +| Language(s) and Dependencies | dependencies | | Comments. | +| Vetted in Peer-Reviewed Literature | Pending review in ESPL. Vetted as Masters Thesis: Bartelt [2021](https://doi.org/10.26076/a66b-0708) | | Awaiting peer review of manuscript. Thesis: - Bartelt K. 2021. Valley Bottom Inundation Patterns in Beaver-Modified Streams: A Potential Proxy for Hydrologic Inefficiency, Masters Thesis, Utah State University: Logan, UT. Available from: [https://digitalcommons.usu.edu/etd/8226](https://digitalcommons.usu.edu/etd/8226). DOI: [10.26076/a66b-0708](https://doi.org/10.26076/a66b-0708). | +| Source Code Documentation | Some comments in source code, and some troubleshooting clear from commit history. | | Missing ReadMe file. Also, no documentation on specific Python and ArcPy dependencies. | +| Open Source | [Open Source](https://github.com/Riverscapes/RIM) with [GNU General Public License v 3.0](https://github.com/Riverscapes/gcd/blob/master/LICENSE) | | Follows Riverscape Compliance standards. | +| Tool and Source Code Citable | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7265508.svg)](https://doi.org/10.5281/zenodo.7265508) | | Karen Barelt, Joe Wheaton, Matt Reimer, Margaret Hallerud, Philip Bailey, & Jordan Gilbert. (2022). Riverscapes Inundation Mapper - RIM 0.1 (v0.1.0). Zenodo. [https://doi.org/10.5281/zenodo.7265508](https://doi.org/10.5281/zenodo.7265508]) | +| User Documentation | Basic documentation on [Running the RIM Tool]({{ sitebase.url }}/Documentation/running/) and a [Protocol]({{ site.baseurl}}/Documentation/Protocols/). For users looking to visualize [outputs]({{ site.baseurl }}/Examples/ExampleData), there are a [few videos]({{ site.baseurl }}/Documentation/Viewing.html)). | | There is basic, minimal documentation that complies with the [Tool Website Documentation Standards](https://riverscapes.net/Tools/Technical_Reference/Documentation_Standards/WebSites/). However, the help could be elaborated and improved with some video tutorials. | +| Easy User Interface | Basic ArcPy Toolboxes with limited help. | | These are really basic research scripts and toolboxes. Those familiar with using and loading Toolboxes in ArcGIS 10.X will find the [workflows]({{ sitebase.url }}/Documentation/running/) familiar. | +| Scalability | Desc. | | Comments. | +| Produces [Riverscapes Projects]({{ site.baseurl }}/Tools/Technical_Reference/Documentation_Standards/Riverscapes_Projects/) | Tool is outputting to disk data in a Riverscapes Project that can be opened in [RV](http://rave.riverscapes.net). | | Comments. | + +## F-A-I-R Assessment + + **F**-**A**-**I**-**R**, corresponds to the **f**indable, **a**ccessible, **i**nteroperable and **r**e-useable [Principles](https://force11.org/info/the-fair-data-principles/) (Wilkinson et al. [2016](https://www.nature.com/articles/sdata201618)), which the RC strives to follow and to help facilitate making it easier for the riverscapes community to follow. **F**-**A**-**I**-**R** can apply to metadata, data and the tool itself. + + + + +| FAIR Principle | Value | Evaluation | Comments | +| ----------------- | ----- | ------------------------------------------------------ | --------- | +| **METADATA** | | | | +| **F**indable | Desc. | | Comments. | +| **A**vailable | Desc. | | Comments. | +| **I**nteroperable | Desc. | | Comments. | +| **R**e-useable | Desc. | | Comments. | +| **DATA** | | | | +| **F**indable | Desc. | | Comments. | +| **A**vailable | Desc. | | Comments. | +| **I**nteroperable | Desc. | | Comments. | +| **R**e-useable | Desc. | | Comments. | +| **TOOL** | | | | +| **F**indable | Desc. | | Comments. | +| **A**vailable | Desc. | | Comments. | +| **I**nteroperable | Desc. | | Comments. | +| **R**e-useable | Desc. | | Comments. | + +Overall summary of tool **FAIR**-ness : Tool evaluation summary. + +## Tool Output Utility + +All Riverscapes tools package up data in Riverscapes Projects. This section evaluates the utility of those outputs to end-users that are not running the tool, but instead leveraging its outputs. + +| Criteria | Value | Evaluation | Comments | +|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------|----------------------------------------------------------|--------------------------------| +| :----------------------------- | :----------------------------- | :----------------------------- | :----------------------------- | +| [RV](https://rave.riverscapes.net)- Compliant Riverscapes Projects ? | Desc. | | Comments. | +| [RV](https://rave.riverscapes.net) Business Logic Defined? | Desc. | | Comments. | +| Riverscapes Projects hosted in public-facing [Riverscapes Warehouse(s)](https://riverscapes.net/Data_Warehouses/#warehouse-explorer-concept) | Desc. | | Comments. | +| Riverscapes Projects connected to [Web-Maps](https://riverscapes.net/Data_Warehouses#web-maps) | Desc. | | Comments. | +| Riverscapes Projects connected to Field [Apps](https://riverscapes.net//Data_Warehouses#apps---pwas) | Desc. | | Comments. | + +## Developer Intent + +*Development team (not evaluation team) should provide 1-3 paragraphs and/or some bullets and/or figures describing where they hope to go in future releases.* + +If you share the above vision, get in touch with the developers to support/fund the effort. + +-------------------- + +The [Riverscapes Consortium's](https://riverscapes.net) Technical Committee provides report cards for tools either deemed as "[riverscapes-compliant](https://riverscapes.net/Tools/#riverscapes-compliant)" or "[pending riverscapes-compliance](https://riverscapes.net/Tools/#tools-pending-riverscapes-compliance)" . diff --git a/docs/About/acknowledgements.md b/docs/About/acknowledgements.md new file mode 100644 index 0000000..a933127 --- /dev/null +++ b/docs/About/acknowledgements.md @@ -0,0 +1,42 @@ +--- +title: Acknowledgements +weight: 2 +--- + + +## Funding + +RIM was part of graduate research supported by the [Utah Public Lands Initiative](https://caas.usu.edu/uaes/publications/public-lands/index), [U.S. Forest Service](https://www.fs.usda.gov/detail/r4/landmanagement/resourcemanagement/?cid=stelprd3845865) (Grant Number: 19-CS-11046000-026), [Bureau of Land Management](https://www.blm.gov/programs/aquatics) (Grant Number: L20AC00514), and Utah State University Office of Research and Graduate Studies. [Anabranch Solutions](https://anabranchsolutions.com) paid for curation of business logic and symbology for [RV integration](https://rave.riverscapes.net). + +
+
+ +
+
+ +
+
+
+Special thanks to Carl Saunders (USFS) and Alden Shalcross (BLM) for their continued support of the RIM effort. + +## RIM Development Team + +RIM was primarily developed by [Karen Barelt](http://etal.joewheaton.org/karen-bartelt.html) as part of her Masters Thesis int the [ETAL Lab](https://etal.joewheaton.org), with guidance from [Joe Wheaton](https://joewheaton.org) and [Philip Bailey](https://www.northarrowresearch.com/people). Karen now works for the USGS. For a complete list of developers and their contributions, see the [RIM Github repository](https://github.com/Riverscapes/RIM/graphs/contributors). Chalese Hafen was critical in helping with curation of the RIM project types and Jordan Gilbert helped get the releases packaged up. Thanks to Matt Reimer and Jordan Gilbert for getting the [RIM projects into the warehouse]({{ site.baseurl }}/Examples/ExampleData.html). + + +
+ +
+ +
+
+ +
+
+ + + + + + + diff --git a/docs/About/license.md b/docs/About/license.md new file mode 100644 index 0000000..f1b842f --- /dev/null +++ b/docs/About/license.md @@ -0,0 +1,32 @@ +--- +title: License & Source Code +weight: 2 +--- + +The Riverscapes Inundation Mapping (RIM) Tool is: +- [Open-Source](https://github.com/Riverscapes/RIM) +- Strving to follow [FAIR](https://force11.org/info/the-fair-data-principles/) Principles +- [Pending Riverscapes Compliance](https://riverscapes.net/Tools/#riverscapes-compliant-tools) + +
+ See RIM's Report Card from Riverscapes Consortium +
+ +## Source Code +The RIM Plugin source code is available on [GitHub](https://github.com/Riverscapes/RIM): + +
+ View RIM Source Code on GitHub +
+ +The source code and this website are tracked with Zendo: +[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7265508.svg)](https://doi.org/10.5281/zenodo.7265508) + +Cite as: +> Karen Barelt, Joe Wheaton, Matt Reimer, Margaret Hallerud, Philip Bailey, & Jordan Gilbert. (2022). Riverscapes Inundation Mapper - RIM 0.1 (v0.1.0). Zenodo. [https://doi.org/10.5281/zenodo.7265508](https://doi.org/10.5281/zenodo.7265508]) + + +## License + + RIM is licensed under the [GNU Public License Version 3](https://github.com/Riverscapes/RIM/blob/docs/LICENSE). + diff --git a/docs/Documentation/Viewing.md b/docs/Documentation/Viewing.md new file mode 100644 index 0000000..f37236c --- /dev/null +++ b/docs/Documentation/Viewing.md @@ -0,0 +1,36 @@ +--- +title: Viewing RIM Projects +weight: 1 +--- + +## Exploring RIM Project in Web RV + +
View or Download Projects
from Baretlt 2021 using Riverscapes Viewer
+Before downloading anything, you can explore RIM projects in the web. Choose one from [here]({{ site.baseurl }}/Examples/ExampleData) → + + + + + +The first video below shows you how to view a RIM [**riverscapes projects** ](https://riverscapes.net/Tools/Technical_Reference/Documentation_Standards/Riverscapes_Projects/), and download it. + +
+ +
+ + + + +## Exploring RIM Projects in Desktop GIS with RV (Riverscapes Viewer) + +In the next video below, we show you how to explore a RIM project in the QGIS Riverscape Viewer ([QRV](https://rave.riverscapes.net/Download/install_qrave.html)). + +
+ +
+ + +### Install RV for your Deskotp GIS +If you want to view a RIM project in desktop GIS, they are designed to work well with Riverscapes Viewer (RV). Follow the instructions [here](http://rave.riverscapes.net) to install the RAVE toolbar for QGIS or ArcGIS. Takes less than a minute. + diff --git a/docs/Documentation/running/index.md b/docs/Documentation/running/index.md index aea6077..bb0704b 100644 --- a/docs/Documentation/running/index.md +++ b/docs/Documentation/running/index.md @@ -5,12 +5,12 @@ weight: 1 These steps take you through the necessary steps to run the RIM tool. The methods themselves are elaborated in [Bartelt et al. 2021](https://digitalcommons.usu.edu/etd/8226/). -- [Step 1: Gather Inputs]({{ site.baseurl }}/Documentation/tool_users/3-Step3.html) -- [Step 2: Project Builder]({{ site.baseurl }}/Documentation/tool_users/2-Step2_createproject) -- [Step 3: Mapping]({{ site.baseurl }}/Documentation/tool_users/3-Step3) - - [Step 3a: Mappings]({{ site.baseurl }}/Documentation/tool_users/3a) - - [Step 3b: Create New DCE]({{ site.baseurl }}/Documentation/tool_users/3b) -- [Step 4: Calculate Metrics]({{ site.baseurl }}/Documentation/tool_users/4-Step4_calcMetrics) +- [Step 1: Gather Inputs]({{ site.baseurl }}/Documentation/running/step1.html) +- [Step 2: Project Builder]({{ site.baseurl }}/Documentation/running/step2) +- [Step 3: Mapping]({{ site.baseurl }}/Documentation/running/step3) + - [Step 3a: Mappings]({{ site.baseurl }}/running/step3a) + - [Step 3b: Create New DCE]({{ site.baseurl }}/running/step3b) +- [Step 4: Calculate Metrics]({{ site.baseurl }}/Documentation/running/step4)
diff --git a/docs/Documentation/tool_viewers/index.md b/docs/Documentation/tool_viewers/index.md deleted file mode 100644 index 01fd84d..0000000 --- a/docs/Documentation/tool_viewers/index.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Viewing RIM Projects -weight: 1 ---- - -## Download RAVE -Follow the instructions [here](http://rave.riverscapes.net) to install the RAVE toolbar for ArcGIS -## Download RIM Project - -## Exploring RIM Projects in RAVE - diff --git a/docs/Examples/ExampleData.md b/docs/Examples/ExampleData.md index c4f2a94..6c17f6e 100644 --- a/docs/Examples/ExampleData.md +++ b/docs/Examples/ExampleData.md @@ -9,7 +9,7 @@ title: Example RIM Data from Bartelt (2021) Example of a RIM project (Summit Creek, Idaho) visualized in web Riverscapes Viewer. The project can also be downloaded and used in desktop GIS with QRV and ArcRV.
- Instructions on exploring
RIM projects in Riverscapes Viewer
diff --git a/docs/Examples/index.md b/docs/Examples/index.md index a5d5ddc..a54e772 100644 --- a/docs/Examples/index.md +++ b/docs/Examples/index.md @@ -4,6 +4,7 @@ weight: 1 --- ## Beaver Dam Building Opportunities In Figure 2 and Appendix A of Bartelt ([2021](https://digitalcommons.usu.edu/etd/8226)), 'Beaver Dam Building Opportunities' are differentiated into _classic_, _steep_ and _floodplain_. +
------ diff --git a/docs/index.md b/docs/index.md index 966283a..43b5c36 100644 --- a/docs/index.md +++ b/docs/index.md @@ -21,7 +21,7 @@ src="{{ site.baseurl }}/assets/images/RIM_04.png" width="75"> View or Download P -**RIM** [0.0.2](https://github.com/Riverscapes/RIM/releases/tag/v0.0.2) as published here, is a BETA [research-grade tool](https://riverscapes.net/Tools/discrimination.html#research-grade). It is a mix of Python and R with ArcPY dependencies. It has been successfully deployed by others, but is finicky to deploy. +**RIM** [0.1.0](https://github.com/Riverscapes/RIM/releases/tag/v0.1.0) as published here, is a BETA [research-grade tool](https://riverscapes.net/Tools/discrimination.html#research-grade). It is a mix of Python and R with ArcPY dependencies. It has been successfully deployed by others, but is finicky to deploy. Development of RIM has shifted from its own ArcToolbox into a Protocol implemented as part of data capture events in Riverscapes Studio for QGIS or [QRiS](https://qris.riverscapes.net/) thanks to support from the USFS and NOAA. @@ -34,4 +34,4 @@ The types of beaver dam building activity impacting riverscapes that RIM was des ## References -- Bartelt K. 2021. Valley Bottom Inundation Patterns in Beaver-Modified Streams: A Potential Proxy for Hydrologic Inefficiency, Masters Thesis, Utah State University: Logan, UT. Available from: https://digitalcommons.usu.edu/etd/8226 +- Bartelt K. 2021. Valley Bottom Inundation Patterns in Beaver-Modified Streams: A Potential Proxy for Hydrologic Inefficiency, Masters Thesis, Utah State University: Logan, UT. Available from: [https://digitalcommons.usu.edu/etd/8226](https://digitalcommons.usu.edu/etd/8226). DOI: [10.26076/a66b-0708](https://doi.org/10.26076/a66b-0708).