.. _auto_d3plot_extract_image:

* EXTRACT INFORMATION FROM D3PLOT FILE*
=======================================

Renders a static image from an LS-DYNA D3PLOT (or LS-POST database) file at a specified simulation state, camera orientation, and shading mode. Use this worker to generate thumbnail or report-quality snapshots of crash/structural simulation results without a full post-processor session.

When to use
-----------

Classification: **process**.

Tagged: ``d3plot``, ``image_render``, ``ls-dyna``, ``lspost``, ``postprocessing``, ``snapshot``, ``thumbnail``, ``visualization``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Data Type
     - datatype
     - string
     - dyna_d3plot
     - 
     - Source file format to read: 'dyna_d3plot' for a standard LS-DYNA D3PLOT binary or 'lspost_db' for an LS-POST database; defaults to 'dyna_d3plot' and can be left at default unless an LS-POST DB is supplied.
   * - State
     - state
     - string
     - final
     - 
     - Simulation time state to render: 'initial' captures the t=0 geometry while 'final' (default) captures the last available time step — leave at default to show the end-of-simulation deformed shape.
   * - Orientation
     - orientation
     - string
     - left
     - 
     - Camera viewpoint for the rendered image: one of 'left', 'top', 'bottom', 'front', or 'back'; defaults to 'left' — choose the view that best exposes the region of interest for the report.
   * - Shading
     - shading
     - string
     - shad
     - 
     - Surface rendering style: 'shad' (smooth shaded, default) for realistic appearance, 'wireframe' to show element edges only, or 'mesh' to overlay edges on the shaded surface.
   * - Format
     - format
     - string
     - png
     - 
     - Output image file format: 'png' (default, lossless) or 'jpg' (compressed) — use PNG for reports requiring crisp edges and JPG when file size is a concern.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - d3plot_extract_image_output_1
     - d3plot_extract_image_output_1
     - view
     - Rendered image of the simulation model (PNG or JPG) at the requested state, orientation, and shading, suitable for embedding in dashboards or automated reports.

Disciplines
-----------

- cae.postprocessing.visualization
- engineering.crash.dynamics

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>d3plot_extract_image</code>. Schema hash: <code>338d8ef296dc</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>