LS-DYNA IMAGE GENERATOR¶
Generates static images and animations from LS-DYNA d3plot files using LS-PrePost, supporting fringe/contour plots (plastic strain, von Mises stress, displacement, pressure, shear), part highlighting/hiding/transparency, custom view angles or quaternion overrides, and PNG/GIF/MP4 output. Use this worker to produce publication-ready visuals or animation sequences from any LS-DYNA simulation result.
When to use¶
Tagged: animation, contour, d3plot, displacement, fringe, gif, ls-prepost, lsdyna.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Simulation | simulation_id | remote_lookup | — | d3VIEW simulation record to source the d3plot from; use this instead of a direct file path when the simulation is already registered in the platform. Either this or d3plot_file must be provided. | |
| d3plot File | d3plot_file | file | — | Absolute or relative path to the d3plot binary file on disk; used as a direct alternative when simulation_id is not available. | |
| Time State | time_state | text | last | 1-based integer timestep index to render (e.g. ‘42’), or the keywords ‘first’ or ‘last’; for animation outputs this sets the initial display state — leave at default ‘last’ for the final result frame. | |
| View Angle | view_angle | select | isometric | Predefined camera orientation to apply (isometric, front, back, left, right, top, bottom); ignored when custom_quaternion is supplied. Default is ‘isometric’. | |
| Custom Quaternion | custom_quaternion | text | — | Four space-separated floats representing an LS-PrePost view quaternion ‘x y z w’ (e.g. ‘0.5 0.5 -0.5 0.5’); when provided this overrides the view_angle selection entirely. | |
| Zoom Factor | zoom | text | 0.8 | Floating-point zoom factor where values < 1.0 zoom out, 1.0 is the default fit, and values > 1.0 zoom in (e.g. ‘0.5’, ‘0.8’, ‘2.0’); default is ‘0.8’. | |
| Fringe Component | fringe_component | select | none | Result quantity to map as a colour fringe overlay; choose ‘none’ for geometry-only (no contour), or one of: plastic_strain, von_mises, x/y/z/r_displacement, pressure, max_shear. Default is ‘none’. | |
| Fringe Min | fringe_min | text | — | Lower bound of the fringe colour scale in the result’s native units (e.g. ‘0.0’ for strain or ‘0.0’ for stress in Pa/MPa); leave empty to use the automatic data-driven minimum. | |
| Fringe Max | fringe_max | text | — | Upper bound of the fringe colour scale in the result’s native units; leave empty to use the automatic data-driven maximum. | |
| Fringe Levels | fringe_levels | text | 16 | Number of discrete colour bands in the fringe legend (integer, e.g. ‘16’); higher values give smoother gradients. Default is ‘16’. | |
| Highlight Parts | highlight_parts | text | — | Space- or comma-separated list of LS-DYNA part IDs to render in a highlighted colour, drawing attention to specific components in the scene. | |
| Hide Parts | hide_parts | text | — | Space- or comma-separated list of LS-DYNA part IDs to hide entirely from the rendered scene, useful for exposing interior components. | |
| Transparent Parts | transparent_parts | text | — | Space- or comma-separated list of LS-DYNA part IDs to render semi-transparently, allowing internal geometry to remain visible. | |
| Colormap | colormap | text | — | LS-PrePost colormap name to use for the fringe legend (e.g. ‘rainbow’, ‘cool_warm’); leave empty to use the LS-PrePost default colormap. | |
| Output Format | output_format | select | png | File format for the generated output: ‘png’ for a single static image, ‘gif’ for an animated GIF, or ‘mp4’ for an H.264 video; default is ‘png’. | |
| Image Size | image_size | text | 1440x1080 | Output image resolution as ‘WIDTHxHEIGHT’ in pixels (e.g. ‘1440x1080’, ‘1920x1080’); default is ‘1440x1080’. | |
| Animation Start State | anim_start | text | 1 | 1-based timestep index at which the animation sequence begins; only relevant when output_format is ‘gif’ or ‘mp4’. Default is ‘1’. | |
| Animation End State | anim_end | text | 10 | 1-based timestep index at which the animation sequence ends; only relevant when output_format is ‘gif’ or ‘mp4’. Default is ‘10’. | |
| Title | title | text | — | Optional text string to overlay as a title annotation on the rendered image or animation frames; leave empty for no title. | |
| Sensor IDs to Highlight | sensor_ids | text | — | Comma-separated d3VIEW sensor IDs whose corresponding LS-DYNA entities (nodes, parts) will be resolved and highlighted in the scene automatically. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Generated Image | image | image | Primary rendered output — a PNG still image, animated GIF, or MP4 video file depending on output_format, ready for inline display in the platform. |
| Output Files | files | dataset | Dataset record containing all generated output files from the working directory (PNG, GIF, MP4, etc.), useful when multiple frames or formats are produced in a single run. |
| STDOUT | stdout | textarea | Raw standard output captured from the LS-PrePost process; useful for confirming successful command execution or diagnosing rendering issues. |
| STDERR | stderr | textarea | Raw standard error captured from the LS-PrePost process; inspect this when the output image is missing or the run fails unexpectedly. |
Disciplines¶
- cae.postprocessing.extraction
- cae.postprocessing.visualization
- engineering.crash.dynamics
Auto-generated from platform schema. Worker id: lsdyna_image_generator. Schema hash: 99e026fc77da. Hand-curated docs in workerexamples/ override this page when present.