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.
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;
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.
/Rfunctions defined for this project./datadata downloaded for this project./temptemporary output that may be of interest for debugging./outoutput to be contributed elsewhere./regregistry of dams tracked in source control./docscontains artifacts to be served via github.io
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.
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."
