Skip to main content

Connect Control Structure Junctions

Description​

Connects HydroJunctions of Hydraulic Type Inlet/Outlet (INLET) or Control Structure (CS) associated to a Control Structure Sequence to the spider web trace network. A Control Structure Sequence is defined as one or many linear structures of hydraulic type Conduit (CON) or Channel (CHAN) and point structures of hydraulic type INLET/CS connected together through HydroJunctions and HydroEdges to move water between Catchments. The junctions and edges hydraulic types are default defined in the code.

The tool will generate structure Linear Structure HydroEdges for each most upstream and downstream HydroJunctions in a Control Structure Sequence, whether those are in the same Catchment or not, which are not already connected to the network. The tool will not create the downstream HydroJunctions at the end of the new Linear Structure HydroEdges. Those should already have been generated either as Sink Node or Stream Confluence. If the Catchment has an associated Junction, the tool will use to set the end point of the new edge.

Usage​

Parameters​

DirectionTypeParameter NameData TypeDialog Reference
InputRequiredInput Hydro JunctionGPFeatureLayerInput Hydro Junction features to process. Tool works on a selected set of junctions or on all junctions if there is no selection. This layer must participate to a trace network. Only HydroJunctions meeting all of the following conditions will be processed:
  • INCLUDECONNECT_DESC = 1
  • AND HYDROID IS NOT NULL
  • AND (CONNECTDONE=0 OR CONNECTDONE IS NULL)
  • AND HYDRAULIC_TYPE_DESC IN ('CS','INLET')

    • The tool will create the following fields if they do not exist:
  • HYDROID
  • CONNECTDONE
  • INCLUDECONNECT_DESC
  • HYDRAULIC_TYPE_DESC
  • ISPREFERRED

    • The tool will populate the field CONNECTDONE with 1.
    InputRequiredInput Hydro EdgeGPFeatureLayerHydro Edge feature class processed. This layer must participate to a trace network as a simple edge. The field INCLUDECONNECT_DESC (SHORT) should exist and be set to the network attribute INCLUDECONNECT_DESC. All edges that do not participate to control structures, i.e. having HYDROEDGE_HYDRAULIC_TYPE not in ('CON',CHAN')
    The tool will create the following fields if they do not exist and populate them as follows:
  • HYDROID: Unique identifier of the HydroEdge in the database
  • DRAINID: HydroID of the Catchment where the HydroEdge is located
  • NEXTDOWNID: -1
  • FLOWDIR: 0 (Uninitialized)
  • FTYPE: Linear Structure
  • EDGETYPE: 1
  • INCLUDECONNECT_DESC: 0
  • HYDROEDGE_TYPE_DESC: HYD (Hydraulic Element)
  • HYDROEDGE_HYDRAULIC_TYPE_DESC: SC (Shallow Concentrated)
  • HYDROEDGE_PLACEMENT_TXT: AH (Arc Hydro)
  • ISPREFERRED: 1

    • The tool will populate the Trace Network Flow Direction field with 3 (Undeterminate).
    InputRequiredInput Drainage AreaGPFeatureLayerInput Drainage Area feature class. Must contain the field HydroID that will be used to populate the DrainID field in the output edges.
    The field HydroID will be created if it does not exist but it will not be populated.
    The field JunctionID is optional and stores the HydroID of the associated HydroJunction for dendritic areas. If this field exists, the tool will check whether it is populated for the drainage area intersecting the junction, and if it is, it will use the associated junction as the to point of the new edge.
    InputRequiredInput Flow Direction RasterGPRasterLayerInput Flow Direction raster used to trace from the HydroJunctions to the associated Sink/Drainage Points.
    OutputDerivedOutput Hydro JunctionGPFeatureLayer
    OutputDerivedOutput Hydro EdgeGPFeatureLayer