Inspect a simulation file and return metadata.

Returns bounds, point/cell arrays with ranges, timestep info, and multiblock structure. Use this first to understand what data is available before rendering or extracting.

Render a field visualization and return a PNG screenshot.

Create a slice (cut plane) visualization.

Create an iso-surface (contour) visualization.

Create a clipped visualization.

Create a streamline visualization for vector fields.

Sample field values along a line between two points.

Returns coordinate arrays and field values for plotting.

Extract statistical summary (min/max/mean/std) for fields.

Integrate a field over a surface to compute forces, areas, or fluxes.

Create an animation from time series data or camera orbit.

Time mapping (timesteps mode): speed_factor=1.0: real-time (physics 1s = video 1s) speed_factor=5.0: 5x fast-forward speed_factor=0.2: 5x slow-motion (physics 1s = video 5s)

For VTK file series (e.g., PartFluid_0000.vtk through PartFluid_0100.vtk), use 'files' with an explicit list or 'file_pattern' with a glob pattern.

Create a split-pane synchronized animation with multiple views.

Render 2-4 panes in a grid layout, combining 3D visualizations with time-series graphs. All panes are timestep-synchronized and output as a single GIF or PNG sequence.

Run DualSPHysics IsoSurface to generate VTK surface mesh files.

Converts bi4 particle data into VTK surface meshes (iso-surfaces). The output files can then be used with animate() or render() via SourceDef(files=[...]) for visualization.

Execute a custom pipeline definition (advanced).

Accepts a full PipelineDefinition JSON for maximum flexibility. This is the primary interface for CFD/FEA/CAE specialist agents.

The pipeline JSON structure: { "source": {"file": "/data/file.foam", "timestep": "latest"}, "pipeline": [ {"filter": "Slice", "params": {"origin": [0,0,0], "normal": [1,0,0]}}, {"filter": "Calculator", "params": {"expression": "mag(U)", "result_name": "Umag"}} ], "output": { "type": "image", "render": {"field": "Umag", "colormap": "Viridis"} } }

Available filters: Slice, Clip, Contour, Threshold, StreamTracer, Calculator, Gradient, IntegrateVariables, GenerateSurfaceNormals, ExtractBlock, ExtractSurface, WarpByVector, WarpByScalar, CellDatatoPointData, PlotOverLine, Glyph, ProgrammableFilter, Decimate, Triangulate.

Output types: image, data, csv, animation, export, multi.

Cinematic-quality rendering with auto-framing, 3-point lighting, SSAO, and PBR.

Produces publication/presentation-quality images with:

• PCA-based auto-camera: analyzes object shape and picks optimal viewing angle

• 3-point cinematic lighting (key + fill + rim)

• SSAO (Screen-Space Ambient Occlusion) for contact shadows

• FXAA anti-aliasing

• Gradient backgrounds

• PBR material support (metallic/roughness)

Quality presets:

• draft: 960x540, no post-processing (fast preview)

• standard: 1920x1080, SSAO + FXAA

• cinematic: 1920x1080, all effects + ground plane

• ultra: 3840x2160, all effects + ground plane

• publication: 2400x1800, clean lighting, white background

Volume render 3D data (CT, MRI, CFD fields) with transfer function presets.

Presets: generic, ct_bone, ct_tissue, mri_brain, thermal, isosurface_like

Compare two simulation results side-by-side or as a difference map.

Renders both datasets with identical camera, colormap, and scalar range for direct visual comparison. Essential for design comparison, mesh convergence studies, and solver validation.

Modes:

• side_by_side: Two panels with shared colorbar and consistent framing

• diff: Absolute field difference map (|A - B|) rendered on dataset A's mesh

Sample a field value at a fixed point across timesteps.

Useful for monitoring pressure/velocity at a sensor location over time. Returns dict with times and values arrays.

Render multiple fields from the same dataset in one call.

Returns a dict with images list, each containing field name and base64 PNG. Useful for comparing pressure, velocity, temperature, etc. side-by-side.

Export dataset to glTF/glB for interactive 3D viewing in a browser.

Returns the exported file path and a viewer URL hint. Requires VTK >= 9.4 with vtkGLTFExporter support.

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.

[DEPRECATED — use inspect_physics instead] Analyze VTK/simulation data.

This tool is deprecated. Use inspect_physics for structured physics data extraction with vortex detection, critical points, and solver metadata.

Compose multiple assets into a deliverable format.

Autonomous post-processing: inspect → visualize → evaluate → refine.

Analyzes the file, detects the simulation domain (CFD/FEA/SPH), and produces 3-5 visualizations automatically. With sampling-capable clients, evaluates results and refines parameters iteratively.