Skip to content

CellFlows

CellFlows

Per-cell flow data (heads, budgets, face flows) used during particle tracking.

All arrays are indexed by zero-based cell ID. Produced by hydrate_cell_flows().

Sign conventions

Pass raw MODFLOW values — do not negate. face_flow positive = into cell (MODFLOW-USG / MF6 convention). q_well negative = extraction, positive = injection.

head property

head: List[float]

Simulated hydraulic head in each cell (model units).

water_table property

water_table: List[float]

Water-table elevation in each cell (model units).

q_top property

q_top: List[float]

Total flow through the cell top (L³/T), positive upward, i.e. out of the cell; recharge entering the top is negative (mod-PATH3DU's qtop + qtopface). Used for the vertical velocity.

q_bot property

q_bot: List[float]

Total flow through the cell bottom (L³/T), positive upward, i.e. into the cell from below (mod-PATH3DU's qbot + qbotface). Used for the vertical velocity.

q_vert property

q_vert: List[float]

Net vertical flow term without storage (L³/T): minus the net inflow through the cell's top and bottom faces, cell-to-cell and boundary flows alike (mod-PATH3DU's (qtop - qbot) + (qtopface - qbotface)).

q_well property

q_well: List[float]

Well volumetric flux (L³/T). Negative = extraction, positive = injection.

q_other property

q_other: List[float]

Sum of all other (non-well, non-face) boundary fluxes (L³/T).

q_storage property

q_storage: List[float]

Storage flow (L³/T, MODFLOW's sign: positive = water released from storage into the cell). For MODFLOW 6 the sum of STO-SS and STO-SY; zeros for steady state. fit_waterloo() subtracts it from q_vert (since 0.1.2).

has_well property

has_well: List[bool]

True for each cell that contains an active well.

face_offset property

face_offset: List[int]

Start index into face_flow / face_neighbor for each cell.

face_flow property

face_flow: List[float]

Face-by-face volumetric fluxes (L³/T). Positive = into cell.

face_neighbor property

face_neighbor: List[Optional[int]]

Zero-based cell index of the neighbouring cell across each face, or None for domain-boundary faces.

n_cells

n_cells() -> int

Return the number of cells.