animate
Generate animations from time series data or camera orbits to visualize 3D scientific simulations. Create videos in MP4, WebM, GIF, or PNG formats with customizable playback speed, resolution, and visual overlays.
Instructions
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.
Args: file_path: Path to simulation file (or first file in series) field_name: Field to visualize mode: "timesteps" for time series, "orbit" for camera rotation colormap: Color map preset camera: Camera preset (used for initial view in orbit mode) fps: Frames per second (15-60) time_range: [start, end] physics time range, None for all speed_factor: Playback speed multiplier (1.0=real-time) orbit_duration: Orbit video length in seconds (orbit mode only) width: Frame width height: Frame height files: Explicit list of file paths for VTK time series file_pattern: Glob pattern for file series (e.g., "/data/PartFluid_*.vtk") output_format: Output format — "frames" (PNG only), "mp4", "webm", or "gif" video_quality: Video CRF quality (lower=better, 18-28 typical, default 23) text_overlay: Text to overlay on video frames (e.g., case name)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | ||
| field_name | Yes | ||
| mode | No | timesteps | |
| colormap | No | Cool to Warm | |
| camera | No | isometric | |
| fps | No | ||
| time_range | No | ||
| speed_factor | No | ||
| orbit_duration | No | ||
| width | No | ||
| height | No | ||
| files | No | ||
| file_pattern | No | ||
| output_format | No | frames | |
| video_quality | No | ||
| text_overlay | No |