Skip to content

Commit

Permalink
rerun with metadata changes
Browse files Browse the repository at this point in the history
  • Loading branch information
joefutrelle committed Jun 23, 2022
1 parent a5bb082 commit 448489d
Showing 1 changed file with 28 additions and 12 deletions.
40 changes: 28 additions & 12 deletions knb-lter-nes.20.1.xml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
</allow>
</access>
<dataset>
<title>Event logs from Northeast U.S. Shelf NES-LTER Transect cruises, ongoing since 2017</title>
<title>Event logs from Northeast U.S. Shelf Long Term Ecological Research (NES-LTER) Transect cruises, ongoing since 2017</title>
<creator>
<organizationName>Northeast U.S. Shelf LTER</organizationName>
<electronicMailAddress>[email protected]</electronicMailAddress>
Expand Down Expand Up @@ -45,7 +45,7 @@
<electronicMailAddress>[email protected]</electronicMailAddress>
<role>metadataProvider</role>
</associatedParty>
<pubDate>2022-06-14</pubDate>
<pubDate>2022-06-23</pubDate>
<abstract>
<para>This package provides a concatenated table of events recorded on seasonal Transect cruises for Northeast U.S. Shelf Long-Term Ecological Research (NES-LTER). Events were recorded onboard with Rolling Deck to Repository (R2R) event logger (elog) software. Event listings include date, time, ship’s position, instrument, and action for use in physical sample cataloging and post-cruise data integration. Cruises include winter and summer cruises dedicated to NES-LTER, spring and fall cruises in collaboration with the Ocean Observatories Initiative (OOI), and additional fall cruises.</para>
</abstract>
Expand Down Expand Up @@ -104,14 +104,14 @@
<methodStep>
<description>
<para># Original event logs&#13;
Events were recorded onboard with Rolling Deck to Repository (R2R) event logger (elog) software described at: https://www.rvdata.us/about/event-log. Prior to each cruise an NES-LTER Information Manager works with shipboard technicians and the R2R elog software team to configure the elog with instruments and actions from a controlled vocabulary. The event log is started when the ship leaves port, and concluded upon arrival. During the cruise the events are added manually by shipboard technicians and science participants. Contents of the event log are reviewed regularly by an on-board Information Manager during a cruise to ensure completeness and accuracy. The elog is often available online during the cruise so that an on-shore Information Manager can review contents as well. The original event logs (elogs) are available per cruise in R2R with Public Domain Mark 1.0 license: https://www.rvdata.us/data.</para>
Events were recorded onboard with Rolling Deck to Repository (R2R) event logger (elog) software described at: https://www.rvdata.us/about/event-log. Prior to each cruise an NES-LTER Information Manager works with shipboard technicians and the R2R elog software team to configure the elog with instruments and actions from a controlled vocabulary. The event log is started when the ship leaves port, and concluded upon arrival. During the cruise the events are added manually by shipboard technicians and science party. Contents of the event log are reviewed regularly by an on-board Information Manager during a cruise to ensure completeness and accuracy. The elog is often available online during the cruise so that an on-shore Information Manager can review contents as well. The original event logs (elogs) are available per cruise in R2R with Public Domain Mark 1.0 license: https://www.rvdata.us/data.</para>
<para># Event listings output by NES-LTER REST API&#13;
NES-LTER maintains a RESTful Application Programming Interface (REST API) to provide a set of consistent URLs that, when fetched, returns data in machine-readable form that may be used by application code. For the events product provided by the NES-LTER REST API, a subset of columns is retained from the original elogs, including date, time, ship’s position, instrument, and action (parsing code available at: https://github.com/WHOIGit/nes-lter-ims/blob/master/neslter/parsing/elog.py). For some but not all cruises we corrected and/or added events. Event logs are available per-cruise with the following URL pattern, using cruise en627 as example: https://nes-lter-data.whoi.edu/api/events/en627.csv.</para>
NES-LTER maintains a RESTful Application Programming Interface (REST API) to provide a set of consistent URLs that, when fetched, returns data in machine-readable form that may be used by application code. For the events product provided by the NES-LTER REST API, a subset of columns is retained from the original elogs, including date, time, ship’s position, instrument, and action (parsing code available at: https://github.com/WHOIGit/nes-lter-ims/blob/master/neslter/parsing/elog.py). For some but not all cruises we corrected and/or added events. Blanks are retained (not filled with missing value code) in the station, cast, and comment columns. Event logs are available per-cruise with the following URL pattern, using cruise en627 as example: https://nes-lter-data.whoi.edu/api/events/en627.csv.</para>
<para># Data assembly&#13;
The concatenated data product is built from event logs output by the NES-LTER REST API.&#13;
In this first version of this data package, we used a script in Python to acquire all available elogs from the REST API and concatenate into a file “nes_lter_events_raw.csv” that is used in the Data assembly script in R (file and code available at: https://github.com/WHOIGit/nes-lter-events-transect). Cleaning of the concatenated table included formatting datetime, excluding extraneous columns, and excluding instruments specific to Ocean Observatories Initiative (OOI)-led cruises (CPM, CSM, Falcon ROV, Glider, Kraken ROV, REMUS, Slocum Glider, USBL). We did not exclude events listed with instrument “Other” that are pertinent to OOI-led cruises. We added a column project_id to indicate LTER-dedicated or partner cruises.</para>
In this first version of this data package, we used a script in Python to acquire all available elogs from the REST API and concatenate into a file “nes_lter_events_raw.csv” that is used in the data assembly script in R (file and code available at: https://github.com/WHOIGit/nes-lter-events-transect). Cleaning of the concatenated table included formatting datetime, excluding extraneous columns, and excluding instruments specific to Ocean Observatories Initiative (OOI)-led cruises (CPM, CSM, Falcon ROV, Glider, Kraken ROV, REMUS, Slocum Glider, USBL). We did not exclude events listed with instrument “Other” that are pertinent to OOI-led cruises. We added a column project_id to indicate LTER-dedicated or partner cruises.</para>
<para># Quality Assurance&#13;
We assured that the geographic and temporal coverage of the concatenated data product were within expected ranges. For corrections made or still needed for the NES-LTER REST API product, see README per-cruise with the following URL pattern, using cruise en627 as example: https://nes-lter-data.whoi.edu/api/events/en627/README. We did not yet regularize the names of LTER-specific instruments, for example “Bongo” and “Bongo net” are equivalent.&#13;
We assured that the geographic and temporal coverage of the concatenated data product were within expected ranges. For corrections made or still needed for the NES-LTER REST API product, see README per-cruise with the following URL pattern, using cruise en627 as example: https://nes-lter-data.whoi.edu/api/events/en627/README. We did not yet regularize the names of LTER-specific instruments, for example “Bongo” and “Bongo net” are equivalent. For cruises prior to ar28a in spring 2018, we had not yet established controlled vocabulary terms related to IFCB, nor had we distinguished the instrument "IFCB continuous" from underway science seawater with action "IFCB discrete". For cruises en608, ar28b, and ar31c, the instrument IFCB refers to IFCB continuous. For cruises ar24a and ar24c, the instrument IFCB109 represents IFCB continuous, and the instrument IFCB102 represents an IFCB analyzing discrete samples.&#13;
</para>
</description>
</methodStep>
Expand Down Expand Up @@ -289,6 +289,10 @@ We assured that the geographic and temporal coverage of the concatenated data pr
</nonNumericDomain>
</nominal>
</measurementScale>
<missingValueCode>
<code>NaN</code>
<codeExplanation>Missing value</codeExplanation>
</missingValueCode>
</attribute>
<attribute>
<attributeName>dateTime8601</attributeName>
Expand All @@ -300,6 +304,10 @@ We assured that the geographic and temporal coverage of the concatenated data pr
<dateTimeDomain/>
</dateTime>
</measurementScale>
<missingValueCode>
<code>NaN</code>
<codeExplanation>Missing value</codeExplanation>
</missingValueCode>
</attribute>
<attribute>
<attributeName>Instrument</attributeName>
Expand All @@ -314,6 +322,10 @@ We assured that the geographic and temporal coverage of the concatenated data pr
</nonNumericDomain>
</nominal>
</measurementScale>
<missingValueCode>
<code>NaN</code>
<codeExplanation>Missing value</codeExplanation>
</missingValueCode>
</attribute>
<attribute>
<attributeName>Action</attributeName>
Expand All @@ -328,6 +340,10 @@ We assured that the geographic and temporal coverage of the concatenated data pr
</nonNumericDomain>
</nominal>
</measurementScale>
<missingValueCode>
<code>NaN</code>
<codeExplanation>Missing value</codeExplanation>
</missingValueCode>
</attribute>
<attribute>
<attributeName>Station</attributeName>
Expand All @@ -345,21 +361,17 @@ We assured that the geographic and temporal coverage of the concatenated data pr
</attribute>
<attribute>
<attributeName>Cast</attributeName>
<attributeDefinition>CTD rosette cast number or other designation</attributeDefinition>
<attributeDefinition>Cast number count for Instrument associated with event if applicable</attributeDefinition>
<storageType>string</storageType>
<measurementScale>
<nominal>
<nonNumericDomain>
<textDomain>
<definition>CTD rosette cast number or other designation</definition>
<definition>Cast number count for Instrument associated with event if applicable</definition>
</textDomain>
</nonNumericDomain>
</nominal>
</measurementScale>
<missingValueCode>
<code>NaN</code>
<codeExplanation>Missing value</codeExplanation>
</missingValueCode>
</attribute>
<attribute>
<attributeName>Latitude</attributeName>
Expand Down Expand Up @@ -449,6 +461,10 @@ We assured that the geographic and temporal coverage of the concatenated data pr
</nonNumericDomain>
</nominal>
</measurementScale>
<missingValueCode>
<code>NaN</code>
<codeExplanation>Missing value</codeExplanation>
</missingValueCode>
</attribute>
</attributeList>
<numberOfRecords>3307</numberOfRecords>
Expand Down

0 comments on commit 448489d

Please sign in to comment.