iwfm.iwfm_read_gw

iwfm.iwfm_read_gw(gw_file, verbose=False, node_coords=None)[source]

Read an IWFM Simulation Groundwater file and return a dictionary of sub-process file names, and arrays of parameters.

Parameters:

  • gw_file (str) – IWFM Simulation Groundwater file name

  • verbose (bool, default=False, optional) – True = command-line output on

  • node_coords (dict or list, optional) – model node coordinates in simulation units (node-file values scaled by the node-file conversion factor), as {id: (x, y)} or as a list of [id, x, y] rows (the shape returned by iwfm_read_nodes). Only used for parametric-grid files (NGROUP > 0): when provided, aquifer parameters are interpolated from the parametric grid to these model nodes; when omitted, parametric files return empty parameter arrays.

Returns:

  • gw_files (GroundwaterFiles) – Groundwater sub-process file names

  • node_id (list) – node numbers

  • layers (int) – number of layers

  • Kh (list) – hydraulic conductivity

  • Ss (list) – specific storage

  • Sy (list) – specific yield

  • Kq (list) – horizontal anisotropy ratio

  • Kv (list) – vertical anisotropy ratio

  • init_cond (list) – initial groundwater heads

  • units (list) – time units for Kh, Kv, and Ss

  • hydrographs (dict) – dictionary mapping well_name to (order, layer, x, y) order: 1-based column index in hydrograph output layer: aquifer layer number x, y: coordinates (scaled by factxy)

  • factxy (float) – (X,Y) scale factor for hydrographs