[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.

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.

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.

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.

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

Create a clipped visualization.

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

Compose multiple assets into a deliverable format.

Create an iso-surface (contour) 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.

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

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.

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.

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

Sample field values along a line between two points.

Returns coordinate arrays and field values for plotting.

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.

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.

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.

Render a field visualization and return a PNG screenshot.

Create a slice (cut plane) visualization.

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.

Create a streamline visualization for vector fields.

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

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