iwfm.diagnostics.assemble_bundle

iwfm.diagnostics.assemble_bundle(diagnostics_dir, model_name='IWFM', pest_iteration=0, n_gw_nodes=0, n_elements=0, n_layers=4, n_stream_nodes=0, max_iter_store=50, convergence_file=None, elemmb_file=None, stream_file=None, residual_file=None, pest_res_file=None, pest_rec_file=None, pest_par_file=None, pest_pst_file=None, pest_sen_file=None, param_bounds=None, node_coords=None, last_n_timesteps=12, verbose=False)[source]

Assemble a complete DiagnosticBundle from HDF5 files and PEST state.

Parameters:

  • diagnostics_dir (str) – Directory containing diagnostic HDF5 files.

  • model_name (str) – Model identifier for the bundle.

  • pest_iteration (int) – Current PEST iteration number.

  • n_gw_nodes (int) – Number of groundwater nodes per layer.

  • n_elements (int) – Number of model elements.

  • n_layers (int) – Number of model layers.

  • n_stream_nodes (int) – Number of stream nodes.

  • max_iter_store (int) – Max N-R iterations stored per timestep in residual file.

  • convergence_file (str, optional) – Override filename for convergence HDF5.

  • elemmb_file (str, optional) – Override filename for element mass balance HDF5.

  • stream_file (str, optional) – Override filename for stream diagnostics HDF5.

  • residual_file (str, optional) – Override filename for residual history HDF5.

  • pest_res_file (str, optional) – Path to PEST .res file.

  • pest_rec_file (str, optional) – Path to PEST .rec file.

  • pest_par_file (str, optional) – Path to PEST .par file.

  • param_bounds (dict, optional) – Parameter bounds: {name: (lower, upper)}.

  • node_coords (list of (float, float), optional) – XY coordinates per node for spatial clustering.

  • last_n_timesteps (int) – Number of recent timesteps for residual/stream analysis.

  • verbose (bool) – Print progress.

Return type:

DiagnosticBundle