We've made some changes to EPA.gov. If the information you are looking for is not here, you may be able to find it on the EPA Web Archive or the January 19, 2017 Web Snapshot.

Watershed Characterization Service


Description

The Watershed Characterization Service provides a variety of information on NHDPlus 2.1 hydrologic features. When provided with an identifier the service will respond with a report showing available size, stream flow, precipitation, temperature and NLCD land cover percentages for catchments and their cumulative upstream drainage area.

This service by default provides a report in HTML format for consumption in web browsers. Alternatively the data may be requested as a JSON object which also in turn may alternatively include spatial representations of the flowline and catchment features. To obtain a spatial representation of the entire upstream drainage area, use the Navigation Delineation service.

Top of Page


Input

Service Endpoint

http://ofmpub.epa.gov/waters10/Watershed_Characterization.Control

Input Parameters

The service requires one pComID, pPermanentIdentifier or pFeatureID parameter value. All other parameters are optional and provided for customizing the alternative JSON output format. The default HTML report output is intended to be consumed as a web page.

HTML Examples

JSON Examples

Parameter Description
pComID The NHDPlus ComID identifier of the flowline feature. ComIDs are integer values assigned by NHDPlus to hydrologic features in the dataset.
pPermanentIdentifier The NHDPlus Permanent_Identifier value of the feature. Currently only Hawaii, Puerto Rico and the US Virgin Islands utilize permanent identifiers in NHDPlus. If in doubt, use the ComID to reference NHDPlus hydrology. Permanent Identifiers are string values of a maximum length of 40 characters. The values may vary being in some cases character representations of the numeric ComID, in other cases a character representation of a unique integer value and in other cases a 38 character global unique identifier. However the value is always unique to the feature.
pFeatureID The NHDPlus FeatureID identifier of the catchment feature. FeatureIDs are integer values assigned by NHDPlus to catchments in the dataset. Positive values always match to the ComID of the catchment's associated flowline. A negative value indicates the catchment is a sink without an associated flowline. In this case the information provided by the service is limited to the single catchment only.
optOutFormat Optional parameter: either HTML or JSON to indicate the type of output requested from the service, the default value is HTML.
optOutPrettyPrint Optional integer parameter for JSON format. If provided will return JSON results formatted for visual inspection with line breaks and indented three spaces multiplied by the value of the parameter. The default action is to provide compact unformatted JSON.
optOutGeomFormat Optional parameter for JSON format. If provided with value GEOJSON, the service will return the geometry of the flowline and catchment in GEOJSON format. The default action is to forgo providing geometries in the output.
optOutCS Optional parameter for JSON format and GEOJSON output. If provided with a value as defined under common http service parameters here, the resulting GEOJSON representation of the features will be projected to that coordinate reference system. The default is to provide GEOJSON in the NAD83 geodetic coordinate reference system (EPSG:4269).
optOutPruneNumber Optional parameter for JSON format and GEOJSON output. If provided then coordinates of the GEOJSON features will be truncated to the number of digits provided. Depending on the user's need for precision (as well as the coordinate system utilized in optOutCS), clipping numeric coordinates to 8 or 12 digits of precision may lower the size of the service payload. Truncating too many digits may result in duplicated vertices which may or may not affect how the feature is utilized.
optJSONPCallback Optional parameter for JSON format to allow consumption of the service as JSONP.

Top of Page


Output

The default HTML report is intended to be self-explanatory with additional information being available from the NHDPlus user guide Exit.

For the alternative JSON output, the output object returned is flat with the following fields which attempt to closely follow existing NHDPlus dataset naming conventions.

Name Data Type Description Source
permanent_identifier String The Permanent_Identifier identifier of the flowline feature. This value will be null when the input parameter is a sink FeatureID. NHDSnapshot NHDFlowline
comid Integer The ComID identifier of the flowline feature. This value will be null when the input parameter is a sink FeatureID. NHDSnapshot NHDFlowline
reachcode String The Reach Code value of the flowline feature. This value will be null when the input parameter is a sink FeatureID. NHDSnapshot NHDFlowline
fmeasure Double The From Measure value of the flowline feature indicating the percentage of the reach measure at which this feature begins. NHDSnapshot NHDFlowline
tmeasure Double The To Measure value of the flowline feature indicating the percentage of the reach measure at which this feature ends. NHDSnapshot NHDFlowline
featureid Integer The FeatureID value of the catchment feature. If the feature examined does not have a matching catchment feature, then this value will be null. NHDPlusCatchment Catchment
gnis_name String The GNIS Name value of the flowline feature. NHDSnapshot NHDFlowline
streamorder Integer The Modified Strahler stream order value of the flowline.

NHDPlusAttributes PlusFlowlineVAA

streamlevel Integer The NHDPlus stream level value of the flowline. NHDPlusAttributes PlusFlowlineVAA
startflag Integer

Flag indicating the headwater status of the flowline.

0 –feature is not a headwater flowline

1 –feature is a headwater flowline

NHDPlusAttributes PlusFlowlineVAA
Q0001E Double Extended unit runoff method flow from gage adjustment. EROMExtension EROM_MA0001
mavelv Double Vogel Method Mean Annual Velocity (fps) at bottom of flowline using Jobson Method (1996) with MAFlowV. VogelExtension VogelFlow
cumdrainag Double Total upstream cumulative drainage area, in square kilometers, at the downstream end of the flowline feature. NHDPlusAttributes CumulativeArea
cumtempvc Double Mean annual temperature in area upstream of the bottom of flowline in degrees centigrade * 100. Note that the HTML report divides this value by 100 for human readability but the original NHDPlus value is preserved in the JSON output. VPUAttributeExtension CumTotTempMA
cumprecipvc Double Mean annual precipitation in area upstream of the bottom of flowline in millimeters * 100. Note that the HTML report divides this value by 100 for human readability but the original NHDPlus value is preserved in the JSON output. VPUAttributeExtension CumTotPrecipMA
cumnlcd_11 Double Area-weighted percent of NLCD class 11, Open Water, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_21 Double Area-weighted percent of NLCD class 21, Developed, Open Space, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_22 Double Area-weighted percent of NLCD class 22, Developed, Low Intensity, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_23 Double Area-weighted percent of NLCD class 23, Developed, Medium Intensity, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_24 Double Area-weighted percent of NLCD class 24, Developed, High Intensity, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_31 Double Area-weighted percent of NLCD class 31, Barren Land, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_41 Double Area-weighted percent of NLCD class 41, Deciduous Forest, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_42 Double Area-weighted percent of NLCD class 42, Evergreen Forest, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_43 Double Area-weighted percent of NLCD class 43, Mixed Forest, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_51 Double Area-weighted percent of NLCD class 51, Dwarf Scrub, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_52 Double Area-weighted percent of NLCD class 52, Shrub/Scrub, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_71 Double Area-weighted percent of NLCD class 71, Grassland/Herbaceous, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_72 Double Area-weighted percent of NLCD class 72, Sedge/Herbaceous, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_73 Double Area-weighted percent of NLCD class 73, Lichens, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_74 Double Area-weighted percent of NLCD class 74, Moss, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_81 Double Area-weighted percent of NLCD class 81, Pasture/Hay, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_82 Double Area-weighted percent of NLCD class 82, Cultivated Crops, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_90 Double Area-weighted percent of NLCD class 90, Woody Wetlands, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_95 Double Area-weighted percent of NLCD class 95, Emergent Herbaceous Wetlands, occurring in cumulative drainage area upstream of the bottom of flowline. VPUAttributeExtension CumTotNLCD2011
cumnlcd_missing Double Derived field representing percentage of missing NLCD data divided by total area of cumulative drainage area upstream of the bottom of flowline. For use in displaying the percentage of missing data. Derived
areasqkm Double Area in square kilometers of the catchment. NHDPlusCatchment Catchment
tempv Double Mean annual temperature in degrees centigrade * 100 for catchment. Note that the HTML report divides this value by 100 for human readability but the original NHDPlus value is preserved in the JSON output.

NHDPlusAttributeExtension IncrTempMA

precipv Double Mean precipitation in millimeters * 100 for catchment. Note that the HTML report divides this value by 100 for human readability but the original NHDPlus value is preserved in the JSON output. NHDPlusAttributeExtension IncrPrecipMA
nlcd_11 Double Area-weighted percent of NLCD class 11, Open Water, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_21 Double Area-weighted percent of NLCD class 22, Developed, Open Space, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_22 Double Area-weighted percent of NLCD class 22, Developed, Low Intensity, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_23 Double Area-weighted percent of NLCD class 23, Developed, Medium Intensity, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_24 Double Area-weighted percent of NLCD class 24, Developed, High Intensity, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_31 Double Area-weighted percent of NLCD class 31, Barren Land, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_41 Double Area-weighted percent of NLCD class 41, Deciduous Forest, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_42 Double Area-weighted percent of NLCD class 42, Evergreen Forest, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_43 Double Area-weighted percent of NLCD class 43, Mixed Forest, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_51 Double Area-weighted percent of NLCD class 51, Dwarf Scrub, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_52 Double Area-weighted percent of NLCD class 52, Shrub/Scrub, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_71 Double Area-weighted percent of NLCD class 71, Grassland/Herbaceous, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_72 Double Area-weighted percent of NLCD class 72, Sedge/Herbaceous, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_73 Double Area-weighted percent of NLCD class 73, Lichens, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_74 Double Area-weighted percent of NLCD class 74, Moss, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_81 Double Area-weighted percent of NLCD class 81, Pasture/Hay, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_82 Double Area-weighted percent of NLCD class 82, Cultivated Crops, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_90 Double Area-weighted percent of NLCD class 90, Woody Wetlands, occurring in catchment. VPUAttributeExtension IncrNLCD2011
nlcd_95 Double Area-weighted percent of NLCD class 95, Emergent Herbaceous Wetlands, occurring in catchment. VPUAttributeExtension IncrNLCD2011
flowline_shape Geometry When requested, a GEOJSON geometry object representing the flowline. NHDSnapshot NHDFlowline
catchment_shape Geometry When requested, a GEOJSON geometry object representing the catchment. NHDPlusCatchment CatchmentSP

Top of Page


Changelog

Version: 1.0 - Released: September 3, 2009

  • Initial Release of NHDPlus 1.0 Watershed Characterization Report

Version: 2.0 - Released: February 27, 2014

  • Updated to NHDPlus 2.1 (without NLCD information).

Version: 2.1 - Released: May 8, 2015

  • Updated with new NHDPlus 2.1 NLCD information.

Top of Page