inspect_physics
Extract structured physics data from simulation files to generate AI-driven narratives. Analyzes field topology, vortex detection, boundary conditions, and mesh quality, returning JSON for quantitative storytelling.
Instructions
Extract structured physics data for AI storytelling.
Analyzes simulation data to extract:
L2 FieldTopology: vortex detection (Q-criterion), critical points, centerline profiles, gradient statistics per field
L3 CaseContext: boundary conditions, transport properties, solver info, mesh quality, derived quantities (Re, Ma, etc.)
Returns structured JSON for LLM to build physics narratives. Replaces analyze_data with quantitative topology data instead of hardcoded heuristics.
Args: file_path: Path to VTK/OpenFOAM/CGNS simulation file case_dir: OpenFOAM case directory for full solver metadata. If None, only mesh quality is extracted. fields: Specific field names to analyze (None = all fields) probe_lines: Number of auto centerline probe lines (1-3) vortex_threshold: Q-criterion threshold for vortex detection
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | ||
| case_dir | No | ||
| fields | No | ||
| probe_lines | No | ||
| vortex_threshold | No |