<?xml version='1.0' encoding='UTF-8'?>
<metadata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <idinfo>
    <citation>
      <citeinfo>
        <origin>Michael E. Wieczorek</origin>
        <origin>Shannon E. Jackson</origin>
        <origin>Gregory E. Schwarz</origin>
        <pubdate>20230801</pubdate>
        <title>Select Climate and Water Balance Model Attributes: Annual Average Temperature (Celsius) from 1945 - 2015</title>
        <geoform>tabular digital data</geoform>
        <pubinfo>
          <pubplace>Reston, Virginia</pubplace>
          <publish>U.S. Geological Survey</publish>
        </pubinfo>
        <onlink>https://doi.org/10.5066/F7765D7V</onlink>
      </citeinfo>
    </citation>
    <descript>
      <abstract>This tabular data set represents annual average temperature values (Celsius) described in Wolock and McCabe (2017), compiled for the NHDPlus version 2 data suite (NHDPlusV2) for the conterminous United States. Linkage of the temperature data with NHDPlusV2 is achieved through the common unique identifier COMID. The temperature values are estimated both for: 1) individual reach catchments and 2) reach catchments accumulated upstream through the river network. The reach catchment information characterizes data at the local scale, whereas the catchments accumulated through the river network characterize cumulative upstream conditions.  The network-accumulated values are derived using two methods: 1) divergence routing and 2) total upstream routing. Both approaches use a modified routing database (Schwarz and Wieczorek, 2017) to navigate the NHDPlusV2 reach network and to aggregate (accumulate) the metrics derived from the reach catchment scale.</abstract>
      <purpose>This data set was created by the U.S. Geological Survey's (USGS) National Water-Quality Assessment Project (NAWQA) which is part of the USGS National Water Quality Program (NWQP).  This effort was undertaken to estimate the annual average temperature (Celsius) for NHDPlusV2 flowline catchments and upstream river networks to support statistical analyses, map display, and model parameterization.</purpose>
      <supplinf>The data processed here uses a modified routing data base for the NHDPlusV2 flowline network (ENHDPlusV2_us, Schwarz and Wieczorek, 2018). The NHDPlusV2 flowline network serves as the spatial infrastructure for many water-quality modeling efforts included under NAWQA Cycle 3 status and trend assessments including the SPARROW (SPAtially Referenced Regressions On Watershed attributes) model (Rowe and others, 2009). The NHDPlusV2 flowline network is a publically available digital geospatial framework (database) that depicts the network of stream segments and their catchments within the conterminous United States (see Moore and Dewald, 2016 for more detail). The NHDPlusv2 data set includes catchments for each reach covering the conterminous U.S. which includes the catchment boundaries in neighboring Canada and Mexico. These catchments are used as the spatial units for zonal statistics. A statistic (summation, average, minimum or maximum) is calculated for each zone (catchment), based on values from the source ancillary data set (See Process_Description for more details). The output of these values are used as the source input data for an accumulation program which uses a routing database to allocate and accumulate landscape metrics. This database  (ENHDPlusV2_us) is based on a topologically reconditionedversion of the NHDPlusV2 hydrography network and is used for routing purposes only. No cartographic changes were made to the original NHDPlusV2 in either the flowline or catchment line work.</supplinf>
    </descript>
    <timeperd>
      <timeinfo>
        <rngdates>
          <begdate>1945</begdate>
          <enddate>2015</enddate>
        </rngdates>
      </timeinfo>
      <current>publication date</current>
    </timeperd>
    <status>
      <progress>Complete</progress>
      <update>As needed</update>
    </status>
    <spdom>
      <bounding>
        <westbc>-127.910792</westbc>
        <eastbc>-65.327751</eastbc>
        <northbc>51.657387</northbc>
        <southbc>23.243486</southbc>
      </bounding>
    </spdom>
    <keywords>
      <theme>
        <themekt>None</themekt>
        <themekey>average annual temperature</themekey>
        <themekey>SPARROW</themekey>
        <themekey>Inlandwaters</themekey>
        <themekey>NHDPlus</themekey>
        <themekey>Catchment</themekey>
        <themekey>NAWQA</themekey>
        <themekey>water balance model</themekey>
      </theme>
      <theme>
        <themekt>USGS Metadata Identifier</themekt>
        <themekey>USGS:5787ea72e4b0d27deb377b6d</themekey>
      </theme>
      <place>
        <placekt>None</placekt>
        <placekey>Conterminous United States</placekey>
      </place>
    </keywords>
    <accconst>none</accconst>
    <useconst>One should use caution and read this document before using these data to estimate smaller areas. These data should not be used for site-specific evaluation, surveying, or engineering purposes. They should also not be used beyond the limits of the source data's scale. Use of this data is considered acceptance of the limitations of this data and that the user has read and understood this metadata prior to its use in any form.</useconst>
    <ptcontac>
      <cntinfo>
        <cntperp>
          <cntper>Michael E. Wieczorek</cntper>
          <cntorg>US Geological Survey, Maryland Water Science Center</cntorg>
        </cntperp>
        <cntaddr>
          <addrtype>Mailing and Physical</addrtype>
          <address>5522 Research Park Drive</address>
          <city>Baltimore</city>
          <state>MD</state>
          <postal>21228</postal>
          <country>USA</country>
        </cntaddr>
        <cntvoice>443-498-5550</cntvoice>
        <cntemail>mewieczo@usgs.gov</cntemail>
      </cntinfo>
    </ptcontac>
    <datacred>We would like to acknowledge the following USGS employees.  The original conception and rationale for creating these data is from Robert Gilliom and Daren Carlisle.  We also acknowledge Andrew LaMotte in helping to process and format much of this data as well as the helpful colleague reviews provided by Alison Appling and Daren Carlisle.  We also would like to thank Dave Wolock, Curtis Price, Roland Viger, and Drew Ignazio for their invaluable input.</datacred>
    <crossref>
      <citeinfo>
        <origin>Gary L. Rowe</origin>
        <origin>Kenneth Belitz</origin>
        <origin>Hedeff I. Essaid</origin>
        <origin>Robert J. Gilliom</origin>
        <origin>Pixie A. Hamilton</origin>
        <origin>Anne B. Hoos</origin>
        <origin>Dennis D. Lynch</origin>
        <origin>Mark D. Munn</origin>
        <origin>David W. Wolock</origin>
        <pubdate>2009</pubdate>
        <title>Design of Cycle 3 of the National Water-Quality Assessment Program, 2013–2023: Part 1: Framework of Water-Quality Issues and Potential Approaches</title>
        <geoform/>
        <pubinfo>
          <pubplace>Reston, Virginia</pubplace>
          <publish>U.S. Geological Survey</publish>
        </pubinfo>
        <onlink>http://pubs.usgs.gov/of/2009/1296/pdf/OF09-1296.pdf</onlink>
      </citeinfo>
    </crossref>
    <crossref>
      <citeinfo>
        <origin>Richard B. Moore</origin>
        <origin>Thomas G. Diewald</origin>
        <pubdate>2016</pubdate>
        <title>The Road to NHDPlus-Advancements in Digital Stream Networks and Associated Catchments</title>
        <geoform>publication</geoform>
        <pubinfo>
          <pubplace>American Water Resources Association</pubplace>
          <publish>(JAWRA) 1-10.DOI: 10.1111/1752-1688.12389</publish>
        </pubinfo>
        <onlink>http://dx.doi.org/10.1111/1752-1688.12389</onlink>
      </citeinfo>
    </crossref>
  </idinfo>
  <dataqual>
    <attracc>
      <attraccr>Basin metrics were spot checked by randomly creating a set of basins across the country from the NHDPlusV2 reach catchments and using ESRI's ZonalStatisticsAsTable function to compute basin averages of mean annual temperature.  Those values matched the divergence and total upstream routed values in this dataset which demonstrated that the process performed correctly.</attraccr>
    </attracc>
    <logic>None</logic>
    <complete>None</complete>
    <posacc>
      <horizpa>
        <horizpar>No formal positional accuracy tests were conducted</horizpar>
      </horizpa>
      <vertacc>
        <vertaccr>No formal positional accuracy tests were conducted</vertaccr>
      </vertacc>
    </posacc>
    <lineage>
      <srcinfo>
        <srccite>
          <citeinfo>
            <origin>David Wolock</origin>
            <origin>Gregory McCabe</origin>
            <pubdate>2017</pubdate>
            <title>Water Balance Model Inputs and Outputs for the Conterminous United States, 1900-2015</title>
            <geoform>tabular data</geoform>
            <pubinfo>
              <pubplace>Reston, VA</pubplace>
              <publish>the U.S. Geological Survey</publish>
            </pubinfo>
            <onlink>https://doi.org/10.5066/F71V5CWN</onlink>
          </citeinfo>
        </srccite>
        <typesrc>online</typesrc>
        <srctime>
          <timeinfo>
            <rngdates>
              <begdate>1900</begdate>
              <enddate>2015</enddate>
            </rngdates>
          </timeinfo>
          <srccurr>publication date</srccurr>
        </srctime>
        <srccitea>TAVXXXXs.txt</srccitea>
        <srccontr>The source data provided information on average monthly temperature values in Celsius (Wolock and McCabe, 2017) where XXXXs represents decadal periods from the 1900s to the 2010s.</srccontr>
      </srcinfo>
      <srcinfo>
        <srccite>
          <citeinfo>
            <origin>Gregory E. Schwarz</origin>
            <origin>Michael E. Wieczorek</origin>
            <pubdate>2018</pubdate>
            <title>Database of Modified Routing for NHDPlus Version 2.1 Flowlines</title>
            <geoform>tabular data</geoform>
            <pubinfo>
              <pubplace>Reston, VA</pubplace>
              <publish>U.S. Geological Survey</publish>
            </pubinfo>
            <onlink>https://www.sciencebase.gov/catalog/item/5718d2f8e4b0ef3b7cabdc17</onlink>
          </citeinfo>
        </srccite>
        <typesrc>online</typesrc>
        <srctime>
          <timeinfo>
            <sngdate>
              <caldate>2018</caldate>
            </sngdate>
          </timeinfo>
          <srccurr>publication date</srccurr>
        </srctime>
        <srccitea>nhdplusus_v2.sas</srccitea>
        <srccontr>The source data provided routing information for the NHDPlusV2 flow line network.</srccontr>
      </srcinfo>
      <srcinfo>
        <srccite>
          <citeinfo>
            <origin>U.S. Environmental Protection</origin>
            <origin>U.S. Geological Survey</origin>
            <pubdate>2012</pubdate>
            <title>National Hydrography Dataset Version 2.1</title>
            <geoform>vector digital data</geoform>
            <pubinfo>
              <pubplace>Reston, VA</pubplace>
              <publish>U.S. Geological Survey</publish>
            </pubinfo>
            <onlink>http://www.horizon-systems.com/NHDPlus/NHDPlusV2_data.php</onlink>
          </citeinfo>
        </srccite>
        <typesrc>online</typesrc>
        <srctime>
          <timeinfo>
            <sngdate>
              <caldate>2012</caldate>
            </sngdate>
          </timeinfo>
          <srccurr>publication date</srccurr>
        </srctime>
        <srccitea>NHDPlus</srccitea>
        <srccontr>The source data is the basic hydrologic framework used to process  these data.</srccontr>
      </srcinfo>
      <procstep>
        <procdesc>1) Downloaded the text files of monthly temperature values (Wolock and McCabe, 2017) for the years 1945 to 2015 and the raster of unique PRISM (Parameter-elevation Relationships on Independent Slopes Model) identifier (PRISMID) values (Wolock and McCabe, 2017). The file of unique PRISMID data are in ESRI's ArcInfo ASCII raster format, a non-proprietary text interchange format. The item PRISMID in both sets of files is used to link the values from the temperature files to the raster of unique PRISM ids. Average annual temperature values were calculated for each year by summing all values for all months in a given year and dividing by 12.  Rasters of annual temperature values for each year were created by using ESRI's LOOKUP function on the newly calculated annual precipitation value.

2) For each year, mean annual values of temperature were calculated for each NHDPlus version 2 reach catchment using ESRI's "ZonalStatisticsAsTable" function in python using the rasters made in Step #1 above.

3) An aggregation algorithm was performed on the assigned variables. See the metadata for "Database of Modified Routing for NHDPlus Version 2.1 Flowlines: ENHDPlusV2_US" by Schwarz and Wieczorek in Source_Information for more details on the routing databse.  See the landing page for "Select Attributes for NHDPlus Version 2.1 Reach Catchments and Modified Network Routed Upstream Watersheds for the Conterminous United States" for a copy of the aggregation script and its details.

4) Exported results into a comma separated text file format.</procdesc>
        <procdate>20151221</procdate>
      </procstep>
    </lineage>
  </dataqual>
  <spdoinfo>
    <indspref>Common Identifier Code for each catchment and reach segment (COMID)</indspref>
    <direct>Raster</direct>
  </spdoinfo>
  <eainfo>
    <detailed>
      <enttyp>
        <enttypl>TAVYYYY_ANN_CONUS.txt</enttypl>
        <enttypd>comma separated tabular data of average annual temperature values in Celsius for NHDPlusV2 flowline catchments where YYYY is the 4 digit year from 1945- 2015.</enttypd>
        <enttypds>U.S. Geological Survey</enttypds>
      </enttyp>
      <attr>
        <attrlabl>COMID</attrlabl>
        <attrdef>Unique ID to relate to each NHDPlus version 2 catchment and flow line.</attrdef>
        <attrdefs>http://nhd.usgs.gov/NHDDataDictionary_model2.0.pdf</attrdefs>
        <attrdomv>
          <udom>Unique numbers that are automatically generated.</udom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>CAT_TAVXXXX_ANN</attrlabl>
        <attrdef>Average annual temperature (Celsius) per NHDPlus version 2 catchment where XXXX is the 4 digit year from 1945 through 2015. -9999 denotes NODATA.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-9999</rdommin>
            <rdommax>26.39</rdommax>
            <attrunit>Celsius</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>ACC_TAVXXXX_ANN</attrlabl>
        <attrdef>Accumulated average annual temperature (Celsius) for all upstream NHDPlus version 2 catchments based on divergence routing where XXXX is the 4 digit year from 1945 through 2015.  -9999 denotes NODATA.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-9999</rdommin>
            <rdommax>41.43</rdommax>
            <attrunit>Celsius</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>TOT_TAVXXXX_ANN</attrlabl>
        <attrdef>Accumulated average annual temperature (Celsius) for all upstream NHDPlus version 2 catchments based on total upstream routing where XXXX is the 4 digit year from 1945 through 2015.  -9999 denotes NODATA.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-9999</rdommin>
            <rdommax>41.43</rdommax>
            <attrunit>Celsius</attrunit>
          </rdom>
        </attrdomv>
      </attr>
    </detailed>
  </eainfo>
  <distinfo>
    <distrib>
      <cntinfo>
        <cntperp>
          <cntper>Michael E. Wieczorek</cntper>
          <cntorg>U.S. Geological Survey - ScienceBase</cntorg>
        </cntperp>
        <cntaddr>
          <addrtype>Mailing and Physical</addrtype>
          <address>Denver Federal Center, Building 810, Mail Stop 302</address>
          <city>Denver</city>
          <state>CO</state>
          <postal>80225</postal>
          <country>USA</country>
        </cntaddr>
        <cntvoice>443-498-5550</cntvoice>
        <cntemail>mewieczo@usgs.gov</cntemail>
      </cntinfo>
    </distrib>
    <distliab>Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government.
Although this database has been subjected to rigorous review and is substantially complete, the USGS reserves the right to revise the data pursuant to further analysis and review. Furthermore, it is released on condition that neither the USGS nor the U.S. Government may be held liable for any damages resulting from its authorized or unauthorized use.
Although these data have been processed successfully on a computer system at the U.S. Geological Survey, no warranty expressed or implied is made regarding the display or utility of the data on any other system, or for general or scientific purposes, nor shall the act of distribution constitute any such warranty.  The U.S. Geological Survey shall not be held liable for improper or incorrect use of the data described and/or contained herein.</distliab>
  </distinfo>
  <metainfo>
    <metd>20260326</metd>
    <metc>
      <cntinfo>
        <cntperp>
          <cntper>Michael Wieczorek</cntper>
          <cntorg>US Geological Survey</cntorg>
        </cntperp>
        <cntaddr>
          <addrtype>Mailing and Physical</addrtype>
          <address>5522 Research Park Drive</address>
          <city>Baltimore</city>
          <state>Maryland</state>
          <postal>21228</postal>
          <country>USA</country>
        </cntaddr>
        <cntvoice>443-498-5550</cntvoice>
        <cntemail>mewieczo@usgs.gov</cntemail>
      </cntinfo>
    </metc>
    <metstdn>FGDC Content Standard for Digital Geospatial Metadata</metstdn>
    <metstdv>FGDC-STD-001-1998</metstdv>
    <metuc>Record created using USGS Metadata Wizard tool. (https://github.com/usgs/fort-pymdwizard)</metuc>
  </metainfo>
</metadata>
