geoprior.scripts.plot_physics_fields

Plot spatial physics fields and “physics tension”.

This script renders a 2×3 panel for a single city:

1. log10(K) — hydraulic conductivity

2. log10(Ss) — specific storage

3. Hd — effective drainage thickness / head depth

4. log10(tau) — learned relaxation time scale

5. log10(tau_p) — prior / closure time scale

6. Δlog10(tau) — log10(tau) − log10(tau_p)

Optional Nature polish

• Coastline / boundary overlay (if a shapefile exists)

• Scale bar + north arrow (panel c only)

• PDF export in addition to PNG/SVG

Inputs

Either:

• --payload PATH

  (explicit payload file)

• --src DIR_OR_FILE

  (auto-detect physics payload under src)

Optional:

• --coords-npz PATH

  (if payload lacks x/y or lon/lat)

The payload is expected to come from: GeoPriorSubsNet.export_physics_payload.

Outputs

By default, the script writes:

• <out>.png

• <out>.svg

• <out>.pdf

Functions

main([argv, prog])
plot_physics_fields(payload, meta, *, x, y, ...)	Render and save the physics fields panel.
plot_physics_fields_main([argv, prog])

geoprior.scripts.plot_physics_fields.plot_physics_fields(payload, meta, *, x, y, city, out, agg, grid, clip_q, delta_q, cmap, cmap_div, coord_kind, dpi, font, render, hex_gridsize, hex_mincnt, cbar_label_mode, cbar_labelpad, cbar_tickpad, show_legend, show_labels, show_ticklabels, show_title, show_panel_titles, show_panel_labels, hatch_censored, title, out_json, export_pdf, boundary_segs, boundary_style, scalebar, north_arrow, scalebar_km)

Render and save the physics fields panel.

Parameters:

• payload (dict)

• meta (dict)

• x (ndarray)

• y (ndarray)

• city (str)

• out (str)

• agg (str)

• grid (int)

• clip_q (tuple[float, float])

• delta_q (float)

• cmap (str)

• cmap_div (str)

• coord_kind (str)

• dpi (int)

• font (int)

• render (str)

• hex_gridsize (int)

• hex_mincnt (int)

• cbar_label_mode (str)

• cbar_labelpad (float)

• cbar_tickpad (float)

• show_legend (bool)

• show_labels (bool)

• show_ticklabels (bool)

• show_title (bool)

• show_panel_titles (bool)

• show_panel_labels (bool)

• hatch_censored (bool)

• title (str | None)

• out_json (str | None)

• export_pdf (bool)

• boundary_segs (list[tuple[ndarray, ndarray]] | None)

• boundary_style (_BoundaryStyle)

• scalebar (bool)

• north_arrow (bool)

• scalebar_km (float | None)

Return type:

list[str]

geoprior.scripts.plot_physics_fields.plot_physics_fields_main(argv=None, *, prog=None)

Parameters:

• argv (list[str] | None)

• prog (str | None)

Return type:

None

geoprior.scripts.plot_physics_fields.main(argv=None, *, prog=None)

Parameters:

• argv (list[str] | None)

• prog (str | None)

Return type:

None