visualize_fields

What problem does it solve?

Provides a structured toolkit to visualize multi-dimensional field data (e.g., 3D, 4D, matrices) and to diagnose and adjust plot axes, ticks, and display ranges to ensure physical accuracy and clarity.

Core Features & Use Cases

• Infrastructure layer: separates physics-to-index mapping from plotting code, enabling reusable coordinate utilities.
• Extraction API Layer: adds methods to data types to generate visualization-ready subsets without mutating the original data.
• Plotting API Layer: provides user-facing plotting methods named consistently (e.g., plot_map2d, plot_timeseries_points).
• Diagnostic workflows: built-in checks for unit propagation, coordinate accuracy, and proper scaling to prevent misinterpretation.

Quick Start

Construct a basic 2D map from a 4D field and render it with the plotting API to verify axis scales.