3D Hydrography Program 3DHP_all: Flowline
Flowline is a z-enabled line spatial table containing linear representations of water features.
3D Hydrography Program Products: 3DHP_all 2023 Service
3D Hydrography Program Product Specification
flownetworkderivatives (table)
flowline (spatial table)- Flowline is a z-enabled line spatial table containing linear representations of water features that uses the flowlinefeaturetype, flowdirectiontype, and onsurfacetype domains. Note: In the 3DHP_all, the flowline and flownetworkderivatives tables are joined. They are separate here for better readability.
Name (Alias) |
Definition |
Type |
Allow Nulls |
Length |
Domain |
Default Values |
Comments |
id3dhp |
Unique identifier for 3DHP features. |
Text |
Yes |
7 |
- |
- |
This is a base-36 7-digit alphanumeric unique identifier that is not persistent. Applied to hydrolocation features in this case. |
featuredate |
Date the feature was loaded into the 3DHP core database. |
Date |
Yes |
- |
- |
- |
- |
mainstemid |
A cross-dataset identifier for all flowlines that represent the headwater to outlet path of a river. |
Text |
Yes |
200 |
- |
- |
A mainstem is equivalent to a feature with the same levelpathid in NHDPlus HR. The text field will be a <geoconnex.us>*. |
gnisid |
A permanent, unique number assigned by the Geographic Names Information System (GNIS)** to a geographic feature name for the sole purpose of uniquely identifying that name. |
Long Integer |
Yes |
- |
- |
- |
gnisid = "null" if no name is associated with the feature. The gnisid is conflated from points and assigned to features. The most recent name, and any historic names, can be retrieved from the GNIS data base using the gnisid. |
featuretype |
Feature type description. |
Short Integer |
Yes |
- |
flowline feature type |
- |
- |
featuretypelabel |
The name of the feature type. |
Text |
Yes |
50 |
- |
- |
The featuretype label is based on the coded value description in the featuretype field. Allows label display in non-ESRI datasets. |
lengthkm |
Length of linear flowline feature. Value based on regional spatial reference systems. |
Double |
Yes |
- |
- |
- |
Computed in projections based on specific locations, please see the Spatial Reference System Section of this specification for more information. |
waterbodyid3dhp |
The id3dhp of the waterbody that a waterbody connector flows through. |
Text |
Yes |
7 |
|
- |
- |
flowdirection |
Identifies the flow direction of a feature relative to the direction it was digitized. |
Short Integer |
No |
- |
Flow direction type |
1 |
- |
onsurface |
Defines vertical relationship of flowline features. |
Short Integer |
No |
- |
Onsurface type |
1 |
Indicates whether the flowline feature is on the land surface, below the surface, or elevated above the ground and another hydrography feature. |
*More information about geoconnex can be found here: https://waterdata.usgs.gov/blog/nldi-geoconnex/.
**More information about GNISID can be found here: https://www.usgs.gov/tools/geographic-names-information-system-gnis.
Note: A flowpath refers to the primary path water follows through a catchment and may be comprised of multiple flowline features. More information about flowpaths can be found at: https://docs.ogc.org/is/14-111r6/14-111r6.html#_flowpath_also_flow_path.
flowlinefeaturetype (domain)- The flowline spatial table uses the flowline feature type as a coded value domain to classify the featuretype attribute.
Code |
Description |
Definition |
Catchment Generated |
Comments |
1 |
River |
Flowing body of water that receives inflow from upstream and surrounding catchment. |
Yes |
In elevation-derived hydrography a River is a feature that is delineated within elevation-surface channelization. |
2 |
Canal |
Flowing body of water that receives inflow from upstream but not the surrounding catchment. |
No |
Integrated with elevation but not thought to integrate with surrounding hydrology in most cases. |
3 |
Drainageway |
Drainage pathway in a low drainage area setting (headwater) upstream of the onset of discernable channelization. |
No |
- |
4 |
Surface Connector |
Abstract surface or near surface path used to connect upstream channelized features with downstream channelized features. |
Yes |
In elevation-derived hydrography a Surface Connector is a feature that is delineated where there is no elevation-surface channelization. |
5 |
Waterbody Connector |
Abstract connector over a portion of the landscape covered by water. |
Yes |
- |
6 |
Elevation Breaching Connector |
A known or inferred connection that is used to breach values in the elevation surface that are blocking the natural downstream flow of a hydrologic feature. |
Yes |
Culverts across transportation features are the most common occurrence. |
7 |
Hydro Unenforced Connector |
Specific or abstract connector representing flow that is not determined by the surface-water hydrologic network. |
No |
Most pipelines and underground flowpaths through karst terrain are included here. |
flowdirectiontype (domain)- The flowline spatial table uses the flow direction type coded value domain to classify the flowdirection attribute.
Code |
Description |
0 |
Flow direction is unable to be determined from elevation surface |
1 |
Flow direction is in digitized direction, and z-values on vertices flow downslope |
2 |
Flow direction is in digitized direction, and z-values on vertices flow upslope |
onsurfacetype (domain)- The flowline spatial table uses the on-surface type coded value domain to classify the onsurface attribute.
Code |
Description |
0 |
Feature is above another hydrography feature, elevated above the surface |
1 |
Feature is on the land surface |
2 |
Feature is below the land surface |
flownetworkderivatives (table)- The flownetwork derivates table contains information that relate flowlines to catchments and attributes that support network navigation and flow analysis. The flownetworkderivatives table uses the divergencetype domain.
Name (Alias) |
Definition |
Type |
Allow Nulls |
Length |
Domain |
Default Values |
Comments |
id3dhp |
Unique identifier for identified 3DHP flowline feature. |
Text |
No |
7 |
- |
- |
This is a base-36 7- digit alphanumeric unique identifier that is not persistent. |
catchmentid3dhp |
Unique identifier of catchment for catchment aggregation |
Text |
No |
7 |
- |
- |
All hydro-enforced flowlines within an aggregate catchment will be identified in catchmentid3dhp. Flowlines that are not hydro-enforced will not be associated with a catchment and the catchmentid3dhp will be NULL. |
flowpathid3dhp |
Unique identifier of catchment for flowpath aggregation. |
Text |
Yes |
7 |
- |
- |
Identifies the flowlines along the main path of a catchment. Flowlines within a catchment that are not on the mainstem path will have a NULL flowpathid3dhp. |
streamlevel |
StreamLevel is a numeric code that traces main paths of water flow upstream through the drainage network. |
Long Integer |
Yes |
- |
- |
- |
StreamLevel should be constant for a mainstemid. StreamLevel increase from downstream to upstream. |
startflag |
Startflag is used to differentiate headwater features from non-headwater features. |
Short Integer |
Yes |
0 |
logical |
- |
Set to true if the flowline feature is a headwater according to the flownetwork table, otherwise false. |
terminalflag |
Terminalflag is used to differentiate terminal flow features from non-terminal flow features. |
Short Integer |
Yes |
0 |
logical |
- |
Set to true if the flowline feature is a terminal feature (flows into ocean, Great Lakes, Canada, Mex. or the ground) otherwise set to false. |
streamorder |
Strahler stream order number for the flowline feature. |
Long Integer |
Yes |
- |
- |
- |
Streamorder does not increment when a path emanating from a diversion joins a main path. |
streamcalculator |
Further modification of streamorder created to assist with tracking divergences and is computed with streamorder. |
Long Integer |
Yes |
- |
- |
- |
Streamcalculator is assigned the value 0 along diverted paths. |
hydrosequence |
Nationally unique sequence number that places the reach in hydrologic sequence. |
Double |
Yes |
- |
- |
- |
If a path exists between two flowlines, the upstream flowline will have a larger hydrosequence value. If no path exists between the flowlines, hydrosequence has no significance. Hydrosequence is equivalent to a topological sort of the dendritic network. |
dnhydrosequence |
Downstream mainstem hydrologic sequence number. |
Double |
Yes |
- |
- |
- |
- |
uphydrosequence |
Upstream mainstem hydrologic sequence number. |
Double |
Yes |
- |
- |
- |
- |
levelpath |
Hydrologic sequence number of the most downstream flowline feature that is on the same StreamLevel path as this flowline feature according to the flownetwork table. |
Long Integer |
Yes |
- |
- |
- |
- |
uplevelpath |
Levelpath identifier of the feature on the main path immediately upstream. |
Double |
Yes |
- |
- |
- |
- |
dnlevelpath |
Levelpath identifier of the feature on the main path immediately downstream. |
Double |
Yes |
- |
- |
- |
- |
pathlength |
Distance to terminal flowline feature downstream along main path in kilometers using an equal area projection. |
Double |
Yes |
- |
- |
- |
Computed in projections based on specific locations, please see the Spatial Reference System Section of this specification for more information |
terminalpath |
Hydrologic sequence number of terminal flowline of the basin the feature is in. |
Double |
Yes |
- |
- |
- |
- |
arbolatesum |
The sum of the lengths of every upstream feature in the flownetwork, as well as the length of the current feature. |
Double |
Yes |
- |
- |
- |
- |
divergence |
Indicates if a flowline feature is a diversion based on the divergencetype. |
Short Integer |
Yes |
0 |
divergence type |
- |
- |
rtrndivergence |
Indicates that one or more of the paths contributing to a given flowline originates in a divergence that recombines with its main path at the current flowline. |
Short Integer |
Yes |
0 |
logical |
- |
Set to true if flowline feature is a return divergence, otherwise false. |
divergencetype (domain)- The flownetworkderivates table uses the divergencetype domain to classify the divergence attribute.
Code |
Description |
---|---|
0 |
No divergence |
1 |
Main path through a divergence |
2 |
Minor path through a divergence |
Back to the 3D Hydrography Program 3DHP_all Specification