Merge branch 'main' of github.com:MNiMORPH/Trout-Creek-stream-gauge i…

…nto main

CITATION.cff

@@ -0,0 +1,24 @@
+cff-version: 1.2.0
+message: "Please cite this data set and ancillary information as follows."
+authors:
+- family-names: "Wickert"
+  given-names: "Andrew D."
+  orcid: "https://orcid.org/0000-0002-9545-3365"
+- family-names: "Barefoot"
+  given-names: "Eric"
+  orcid: "https://orcid.org/0000-0001-5770-2116"
+- family-names: "Schulz"
+  given-names: "Bobby"
+  orcid: "https://orcid.org/0000-0002-9272-4756"
+- family-names: "Wickert"
+  given-names: "Peter D."
+- family-names: "Wickert"
+  given-names: "Karen M."
+  orcid: "https://orcid.org/0000-0002-3313-7391"
+- family-names: "Wickert"
+  given-names: "Joshua S."
+title: "Trout Creek stream gauge"
+version: 20221012
+doi: 
+date-released: 2022-10-12
+url: "https://github.com/MNiMORPH/Trout-Creek-stream-gauge"

README.md

@@ -4,3 +4,57 @@ River stage in distance from strut on bridge condemned after 2007 flood and plot
 GNU GPL v3 license applies to software.
 
 CC-BY 4.0 license applies to data.
+
+## Location
+
+**Lon**|**Lat**
+-----|-----
+44.19646|-91.94081
+
+## Data collection timeline
+
+### Full date range
+
+2021-06-03 to 2022-09-13
+
+### Start: 2021-06-03
+
+Installed during field work associated with NSF-funded project, [1944782 -- CAREER: Alluvial-river dynamics through watershed networks](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1944782).
+
+### Reprogram: 2021-08-17
+
+ADW realized that even if the [Margay data logger](github.com/NorthernWidget/Project-Margay) should be able to last for >1 year at 1-minute logging intervals, the laser required much more power. ADW reduced the logging frequency from once per minute to once per five minutes.
+
+### Removal: 2022-09-13
+
+The condemned bridge to which we installed the logger was taken out for replacement. Jaime Edwards and Garrett Owens, both of the Minnesota Department of Natural Resources, rescued the stream gauge and data logger and delivered it to ADW at SAFL. Shortly thereafter, ADW shipped the Margay logger to colleagues working on the Athabasca Glacier.
+
+## Data columns
+
+**CSV column**|**Description**
+-----|-----
+Time [UTC]|Universal Coordinated Time
+PressOB [mBar]|Atmospheric pressure from the on-board (and housing-enclosed) BME280 sensor, in units of millibars
+RH\_OB [%]|Atmospheric relative humidity from the on-board (and housing-enclosed) BME280 sensor, in percent saturation
+TempOB [C]|Atmospheric temperature from the on-board (and housing-enclosed) BME280 sensor, in degrees Celsius
+Temp RTC [C]|Atmospheric temperature from the on-board DS3231 real-time clock, in degrees Celsius
+Bat [V]|Voltage of the batteries comprising the main power supply; during the 2021–2022 deployment, this was provided by 3x AA cells in series
+Range [cm]|Distance reported by the LiDAR Lite laser rangefinder in centimeters
+Pitch [deg]|Pitch from horizontal, along long axis of rangefinder assembly ([See annotated figure in README](https://github.com/NorthernWidget-Skunkworks/Project-Symbiont-LiDAR))
+Roll [deg]|Roll from horizontal, along long axis of rangefinder assembly ([See annotated figure in README](https://github.com/NorthernWidget-Skunkworks/Project-Symbiont-LiDAR))
+
+## Deployment images
+
+![Stream gauge in context, bolted to bridge. Wide-angle camera shot. Prof. Crystal Ng under bridge with acoustic Doppler velocimiter (ADV); Profs. Doug Faulkner, Colin Belby, and students in the far distance.](images/DSC_2517_BridgeWideAngle.JPG)
+
+![Margay data logger and box with mounting plate and stand-offs.](images/DSC_3278_TroutGaugeLoggerTopOpen.JPG)
+
+![Laser rangefinder from the base of the stream-gauge installation. Held on by square U bolts via a cutting board from the local hardware store (St. Charles, MN).](images/DSC_2522_TroutGaugeBottomLiDARLite.JPG)
+
+## Funding support
+
+<img src="https://www.nsf.gov/news/mmg/media/images/nsf_logo_f_ba321daf-8607-41d7-94bc-1db6039d7893.jpg" alt="NSF" width="240px">
+
+<img src="https://ane4bf-datap1.s3-eu-west-1.amazonaws.com/wmocms/s3fs-public/styles/featured_media_detail/public/advanced_page/featured_media/wmologo2016_fulltext_horizontal_rgb_en-2.jpg?C4guHHfFZ0Uv029Eo5AvJLFg6nMR47hI&itok=NVNNIT7H" alt="WMO" width="240px">
+
+<img src="https://northernwidget.com/assets/images/NWseal_600px.png" alt="Northern Widget LLC" width="160px">

images/.gitattributes

@@ -0,0 +1 @@
+*.JPG filter=lfs diff=lfs merge=lfs -text