Appendix: QGIS Plugin Layer Attributes Reference
Layer Attributes Reference
The following tables detail the attribute fields for the default layers created by the New OilFlow2D Project tool and the New Template Layer Tool.
MeshDensityLine
| Field Name |
Type |
Description |
| CellSize |
Real |
Target mesh element size along this line. |
MeshDensityPolygon
| Field Name |
Type |
Description |
| CellSize |
Real |
Target mesh element size within this area. |
MeshBreakLine
| Field Name |
Type |
Description |
| CellSize |
Real |
Target mesh element size along this enforced breakline. |
MultipleDemBoundaries
| Field Name |
Type |
Description |
| dem_layer |
String |
Identifier or path for the DEM layer associated with this boundary. |
Domain_Outline
| Field Name |
Type |
Description |
| CellSize |
Real |
Specifies the default cell size for mesh generation within the domain. |
BoundaryConditions
| Field Name |
Type |
Description |
| BCID |
String |
User-defined identifier for the boundary segment. |
| BCType |
Integer |
Type: 1=WSE vs Time (Free), 6=Discharge vs Time, 9=Rating Curve, 12=Normal Depth (Outflow), etc. See plugin UI for full list. |
| BCFileName |
String |
Path/Name of the associated data file (e.g., hydrograph, rating curve). |
Manning N
| Field Name |
Type |
Description |
| ManningN |
Real |
Isotropic Manning's roughness coefficient for this area. |
Manning_Nz
| Field Name |
Type |
Description |
| MANNNFILE |
String |
Path to the file defining anisotropic Manning's values (n, nx, ny, angle). |
Initial_WSE
| Field Name |
Type |
Description |
| InitialWSE |
Real |
Initial water surface elevation value for this zone. |
MaximumErosionDepth
| Field Name |
Type |
Description |
| MAXERODEPT |
Real |
Maximum allowable erosion depth in this zone. |
Infiltration
| Field Name |
Type |
Description |
| INFILFILE |
String |
Path to the file defining infiltration parameters for this zone. |
RainEvap
| Field Name |
Type |
Description |
| RAINEVFILE |
String |
Path to the file defining rainfall/evaporation rates for this zone. |
Wind
| Field Name |
Type |
Description |
| CD |
Real |
Wind drag coefficient. |
| AIRDENSITY |
Real |
Air density. |
| WINDFILE |
String |
Path to the file containing wind speed and direction time series. |
Bridges
| Field Name |
Type |
Description |
| BRIDGEID |
String |
Unique identifier for the bridge. |
| LELEM |
Integer |
Number of elements spanned by the bridge representation. |
| BRIDGEFILE |
String |
Path to the file defining bridge geometry/properties. |
| ZUPPER |
Real |
Elevation of the bridge deck soffit (underside). |
| DECK |
Real |
Thickness of the bridge deck. |
Gates
| Field Name |
Type |
Description |
| GATEID |
String |
Unique identifier for the gate. |
| LELEM |
Integer |
Number of elements spanned by the gate representation. |
| GATEFILE |
String |
Path to the file defining gate operation rules (time vs opening). |
| CRESTELEV |
Real |
Elevation of the gate sill/crest. |
| GHEIGHT |
Real |
Height of the gate opening when fully open. |
| GATECD |
Real |
Discharge coefficient for the gate. |
Culverts
| Field Name |
Type |
Description |
| CULVERTID |
String |
Unique identifier for the culvert. |
| CULVERTYPE |
Integer |
Type defining culvert shape and hydraulic calculation method (e.g., 1=Rectangular, 2=Circular). See plugin UI for full list. |
| CULVERTFIL |
String |
Path to rating curve file (if CULVERTYPE=0). |
| Nb |
Integer |
Number of identical barrels. |
| Ke |
Real |
Entrance loss coefficient. |
| nc |
Real |
Manning's n for the culvert barrel. |
| KP |
Real |
Coefficient used in FHWA equation. |
| M |
Real |
Coefficient used in FHWA equation. |
| Cp |
Real |
Coefficient used in FHWA equation. |
| Y |
Real |
Coefficient used in FHWA equation. |
| m1 |
Real |
Coefficient used in FHWA equation (0.7 or -0.5). |
| Hb |
Real |
Height of box culvert. |
| Base |
Real |
Base width of box culvert. |
| Dc |
Real |
Diameter of circular culvert. |
| INVERT_Z1 |
Real |
Invert elevation at the upstream end. |
| INVERT_Z2 |
Real |
Invert elevation at the downstream end. |
Weirs
| Field Name |
Type |
Description |
| WEIR_ID |
String |
Unique identifier for the weir. |
| WEIRCD |
Real |
Discharge coefficient for the weir. |
| WCRESTELEV |
String |
Path to the file defining weir crest elevation profile or a constant value. |
| LELEM |
Real |
Number of elements spanned by the weir representation. |
DamBreach
| Field Name |
Type |
Description |
| DAMID |
String |
Unique identifier for the dam/breach segment. |
| DAMFILE |
String |
Path to file defining prescribed breach parameters (if iFailure=1). |
| L_CENTER |
Real |
Location of breach center along the dam line. |
| Z_CREST |
Real |
Initial elevation of the dam crest. |
| BREACHANG |
Real |
Angle of the breach side slopes. |
| BREACHCD |
Real |
Discharge coefficient for the breach flow. |
| LELEM |
Real |
Number of elements spanned by the dam representation. |
| iFailure |
Integer |
Failure mode: 1=Prescribed, 2=Overtopping, 3=Piping. |
| D50 |
Real |
Median grain size of dam material (for erosion modes). |
| Tau_c |
Real |
Critical shear stress (for erosion modes). |
| K_sm |
Real |
Coefficient (for erosion modes). |
| T_initial |
Real |
Time of breach initiation (for erosion modes). |
| GS |
Real |
Specific gravity of dam material (for erosion modes). |
| Porosity |
Real |
Porosity of dam material (for erosion modes). |
| kd |
Real |
Erodibility coefficient (for erosion modes). |
| Zb0 |
Real |
Initial breach bottom elevation (for erosion modes). |
| C |
Real |
Coefficient (for erosion modes). |
| cWidth |
Real |
Crest width of the dam. |
| uSlope |
Real |
Upstream slope of the dam. |
| dSlope |
Real |
Downstream slope of the dam. |
Sources_Sinks
| Field Name |
Type |
Description |
| SOURCEID |
String |
Unique identifier for the source/sink. |
| SOURCETYPE |
Integer |
Type: 1=Discharge vs Time, 2=Rating Curve (Depth vs Q). |
| FILENAME |
String |
Path to the associated data file (hydrograph or rating curve). |
InitialConcentrations
| Field Name |
Type |
Description |
| CONCENTFIL |
String |
Path to file defining initial concentration values for this zone. |
Internal_Rating_Table
| Field Name |
Type |
Description |
| IRT_ID |
String |
Unique identifier for the internal rating table location. |
| IRT_BCType |
Integer |
Boundary condition type (typically 19 for Stage vs Discharge). |
| IRTFileName |
String |
Path to the file containing the stage-discharge data. |
| CellSize |
Real |
Cell size parameter related to the internal boundary representation. |
Piers
| Field Name |
Type |
Description |
| PIERID |
String |
Unique identifier for the pier. |
| ICOMP |
Integer |
Calculation method: 1=Complex piers, 2=HEC-18, 3=Coarse Bed, 4=Cohesive Materials. |
| ALFA |
Real |
Angle of attack (flow relative to pier alignment). |
| ISHAPE |
Integer |
Pier shape: 1=Square Nose, 2=Round Nose, 3=Cylindrical, 4=Sharp Nose, 5=Group of Cylinders. |
| PIER_L |
Real |
Length of the pier parallel to flow. |
| PIER_A |
Real |
Width of the pier perpendicular to flow. |
| IBEDCO |
Integer |
Bed condition: 1=Clear-Water Scour, 2=Plane bed and Antidune flow, 3=Small Dunes, 4=Medium Dunes, 5=Large Dunes. |
| D50 |
Real |
Median grain size of bed material. |
| D84 |
Real |
Grain size for which 84% of bed material is finer. |
| SS |
Real |
Specific gravity of sediment. |
| SW |
Real |
Specific weight of water. |
| THETA |
Real |
Critical Shields parameter. |
| VC |
Real |
Critical velocity for initiation of motion. |
| CD |
Real |
Drag coefficient for the pier. |
Abutments
| Field Name |
Type |
Description |
| ABUTID |
String |
Unique identifier for the abutment. |
| IABUTMENT |
Integer |
Abutment type: 1=Spill-through, 2=Vertical wall with wind walls. |
| IXSECTION |
Integer |
Cross-section type: 1=Bridge Section, 2=Upstream Section. |
| D50 |
Real |
Median grain size of bed material. |
| SW |
Real |
Specific weight of water. |
OilSpills
| Field Name |
Type |
Description |
| IDSPILLSTE |
String |
Unique identifier for the spill source/site. |
| WDENSITY |
Real |
Density of the water. |
| COORD_X |
Real |
X-coordinate of the spill location. |
| COORD_Y |
Real |
Y-coordinate of the spill location. |
| COORD_Z |
Real |
Z-coordinate (elevation) of the spill location. |
| NPARCELS |
Integer |
Number of parcels released per time step for this spill. |
| OILDENSITY |
Real |
Density of the spilled oil. |
| OILVISCOS |
Real |
Viscosity of the spilled oil. |
| INITIALST |
Real |
Initial time (hours) when the spill starts. |
| DISP_L |
Real |
Longitudinal dispersion coefficient. |
| DISP_T |
Real |
Transverse dispersion coefficient. |
| DISP_V |
Real |
Vertical dispersion coefficient. |
| HYDROGFILE |
String |
Path to the file defining the spill hydrograph (volume vs time). |
| s_bottom |
Boolean |
Flag to activate interaction with the bottom. |
| s_shore |
Boolean |
Flag to activate interaction with the shoreline. |
| s_dispapp |
Boolean |
Flag related to dispersant application effects. |
| s_vegtrapp |
Boolean |
Flag to activate trapping by vegetation. |
Shorelines
| Field Name |
Type |
Description |
| IDTYPE |
Integer |
Type of shoreline (e.g., 1=Rocky cliffs, 2=Sand beaches, etc. See plugin UI for full list). |
InitialBedFractions
| Field Name |
Type |
Description |
| CONCENTFIL |
String |
Path to file defining initial bed sediment fraction values for this zone. |
SpillBooms
| Field Name |
Type |
Description |
| BOOMID |
String |
Unique identifier for the spill boom. |
| BOOMTYPE |
Integer |
Type of boom (e.g., 1=Curtain, 2=Fence, 3=Sorbent, 4=Bubble). See plugin UI for full list. |
| SKIRTHEIGH |
Real |
Skirt height of the boom. |
| POILLOSS |
Real |
Percentage of oil loss through the boom. |
| VU |
Real |
Boom velocity component in U direction. |
| VV |
Real |
Boom velocity component in V direction. |
SpillPaths
| Field Name |
Type |
Description |
| IDSPILLSTE |
String |
Unique identifier for the spill source/site associated with this path. |
| WDENSITY |
Real |
Density of the water. |
| NPARCELS |
Integer |
Number of parcels released per time step along this path. |
| OILDENSITY |
Real |
Density of the spilled oil. |
| OILVISCOS |
Real |
Viscosity of the spilled oil. |
| INITIALST |
Real |
Initial time (hours) when the spill starts. |
| DISP_L |
Real |
Longitudinal dispersion coefficient. |
| DISP_T |
Real |
Transverse dispersion coefficient. |
| DISP_V |
Real |
Vertical dispersion coefficient. |
| HYDROGFILE |
String |
Path to the file defining the spill hydrograph (volume vs time). |
OilPipelines
| Field Name |
Type |
Description |
| OPLID |
String |
Unique identifier for the pipeline segment. |
| OPLFILE |
String |
Path to file containing detailed pipeline properties or data. |
OilPipeLineBoundCond
| Field Name |
Type |
Description |
| OPLBCID |
String |
Unique identifier for the pipeline boundary condition point. |
| OPLBCTYPE |
Integer |
Type of boundary condition (e.g., leak rate, pressure). |
| OPLBCFILE |
String |
Path to file containing time series data for the boundary condition. |
OilRetDepth
| Field Name |
Type |
Description |
| RETDEPFIL |
String |
Path to file defining oil retention depth parameters for this zone. |
VegTrapp
| Field Name |
Type |
Description |
| VEGTRAPFIL |
String |
Path to file defining vegetation trapping parameters for this zone. |
CrossSections
| Field Name |
Type |
Description |
| XSECID |
String |
Unique identifier for the cross-section line. |
| ND_CS |
Integer |
Number of discretization points along the cross-section for output. |
Profiles
| Field Name |
Type |
Description |
| PROFILEID |
String |
Unique identifier for the profile line. |
| ND_PR |
Integer |
Number of discretization points along the profile line for output. |
ObservationPoints
| Field Name |
Type |
Description |
| ObsID |
String |
Unique identifier for the observation point. |