create_volume_3d
Render a 3D volume from scattered scalar field samples to visualize interior distributions like pollution or temperature, with configurable opacity and iso-surfaces.
Instructions
Interactive 3D volume render of a volumetric scalar field (WebGL, orbit-able).
Renders the full semi-transparent scalar field across (x, y, z) — a
see-through cloud whose density + color encode value_column, with a
configurable number of internal iso-surfaces. Distinct from
create_isosurface_3d (which draws only the single boundary where value
equals a threshold): a volume shows the interior distribution of the field,
not just its level-set shell. The ray-marched rendering runs client-side, so
scattered samples are accepted without a regular grid or SciPy.
Ideal for: 3D pollution / concentration clouds, temperature or humidity fields across a monitoring volume, groundwater head distributions, any scalar field where the interior structure — not just the boundary — matters.
Returns: {filepath, title, rows}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Row dicts (one per volumetric sample point) | |
| theme | No | 'dark', 'light', or 'professional' | dark |
| title | No | Chart title | |
| isomax | No | Upper scalar bound (defaults to column max) | |
| isomin | No | Lower scalar bound (defaults to column min) | |
| opacity | No | Volume opacity (0–1); keep low so the interior stays legible | |
| filename | No | Output filename (without .html) | volume_3d |
| x_column | Yes | Column for the X axis | |
| y_column | Yes | Column for the Y axis | |
| z_column | Yes | Column for the Z axis (depth) | |
| colorscale | No | Plotly colorscale name for value mapping | Viridis |
| show_surface | No | False = pure translucent cloud (no internal surfaces) | |
| value_column | Yes | Column whose values fill the volume | |
| surface_count | No | Number of internal iso-surfaces drawn inside the volume |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||