Reference dams for geoconnex.us

This repository houses workflow software for compilation of community reference dams. The output of this workflow will generate Persistent Identifiers for the geoconnex.us system, reference landing page content for the reference.geoconnex.us system, and a set of best available network locations for the Network Linked Data Index.

The base dataset that informs this work can be found at in the "Final_NID_2018.zip" file associated with this data release:

Wieczorek, M.E., Wolock, D.M., and McCarthy, P.M., 2021, Dam impact/disturbance metrics for the conterminous United States, 1800 to 2018: U.S. Geological Survey data release, https://doi.org/10.5066/P92S9ZX6.

These reference locations are intended to be a shared community resource that anyone can contribute to.

Workflow

graph LR
  style Graph fill:#FFFFFF00,stroke:#000000;
  subgraph Graph
    direction LR
    x45079be5e9dad71e(["nat_db"]):::none --> x0d37c0787182d513(["nhdpv2_fline"]):::none
    x26c28590358ed1f6(["nid_gpkg"]):::none --> xde13d5897adf176a(["nid"]):::none
    xa0ffbbb184c91736(["nid_meta"]):::none --> xde13d5897adf176a(["nid"]):::none
    x5a093a06e6e82fb6(["dams"]):::none --> x367057a71281c312(["dam_locations"]):::none
    xde13d5897adf176a(["nid"]):::none --> x367057a71281c312(["dam_locations"]):::none
    x7b8f98c0b818a18a(["registry"]):::none --> x164a1fd6fa5b800d(["registry_out"]):::none
    xe9d41804ff4ab7c0(["dam_hydrologic_locations_with_mainstems"]):::none --> x2dd2f719129b7fe6(["reference_out"]):::none
    x2ed57357c0c06777(["providers"]):::none --> x2dd2f719129b7fe6(["reference_out"]):::none
    x7b8f98c0b818a18a(["registry"]):::none --> x2dd2f719129b7fe6(["reference_out"]):::none
    x0d37c0787182d513(["nhdpv2_fline"]):::none --> x6c59ac2b7db5bcf8(["nhdpv2_fline_proc"]):::none
    x367057a71281c312(["dam_locations"]):::none --> x7b8f98c0b818a18a(["registry"]):::none
    x2ed57357c0c06777(["providers"]):::none --> x7b8f98c0b818a18a(["registry"]):::none
    xf871d39e1e4f2234(["dam_hydrologic_locations"]):::none --> xe9d41804ff4ab7c0(["dam_hydrologic_locations_with_mainstems"]):::none
    xaa2c6f0a5f97fbb7(["mainstems"]):::none --> xe9d41804ff4ab7c0(["dam_hydrologic_locations_with_mainstems"]):::none
    x36d41497a1d9cc73(["vaa"]):::none --> xe9d41804ff4ab7c0(["dam_hydrologic_locations_with_mainstems"]):::none
    x367057a71281c312(["dam_locations"]):::none --> xf871d39e1e4f2234(["dam_hydrologic_locations"]):::none
    x6c59ac2b7db5bcf8(["nhdpv2_fline_proc"]):::none --> xf871d39e1e4f2234(["dam_hydrologic_locations"]):::none
    x36d41497a1d9cc73(["vaa"]):::none --> xf871d39e1e4f2234(["dam_hydrologic_locations"]):::none
    x60fc93676537b647(["providers_csv"]):::none --> x2ed57357c0c06777(["providers"]):::none
  end
  classDef none stroke:#000000,color:#000000,fill:#94a4ac;

Architecture

This project exists in a linked data architecture that relies on Web uniform resource identifiers (URIs) for both digital and real world entities.

There are three types of resources in the architecture:

Real-world dams identified by a so-called "non-information URI".
Community reference information about the real world dam identified by a URL that is the target of a redirect from a non-information URI.
A particular organization's information available for the real world monitoring location.

In practice, these urls will look like:

https://geoconnex.us/ref/dams/1000047 (which will redirect to 2)
https://reference.geoconnex.us/collections/dams/items/1000047 (which will provide information about the reference location, including a link to 3)
https://nid.sec.usace.army.mil#/dams/system/####/summary (which is the USACE's site information for this particular reference location.)

It is important to maintain this separation because no one organization, other than a community organization set up to fulfill this role, can be expected to be both the community reference catalog and a provider of their own information.

Project structure

/R functions defined for this project.
/data data downloaded for this project.
/temp temporary output that may be of interest for debugging.
/out output to be contributed elsewhere.
/reg registry of dams tracked in source control.
/docs contains artifacts to be served via github.io

Contributing

First, thank you for considering a contribution! For this to work, everyone with unique dam locations need to be willing to contribute those locations here.

This is a new project and, as such, exactly how contributions are made will be flexible and a work in progress. If you have locations to add, just reach out in the issues and/or submit a pull request. The maintainer(s) are more than happy to coordinate and do whatever legwork is needed to get new reference locations into the registry.

As time goes on and the nature of contributions becomes more clear, this guidance will become more specific, but until then, just get in touch and we'll work together.

Disclaimer

This information is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The information has not received final approval by the U.S. Geological Survey (USGS) and is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the information.

This software is in the public domain because it contains materials that originally came from the U.S. Geological Survey (USGS), an agency of the United States Department of Interior. For more information, see the official USGS copyright policy at https://www.usgs.gov/visual-id/credit_usgs.html#copyright

Although this software program has been used by the USGS, no warranty, expressed or implied, is made by the USGS or the U.S. Government as to the accuracy and functioning of the program and related program material nor shall the fact of distribution constitute any such warranty, and no responsibility is assumed by the USGS in connection therewith.

This software is provided "AS IS."

internetofwater / ref_dams

readme