get_volume_info
Reports per-volume name, resolution, active voxels, value range, mean and sum, plus threshold and histogram stats to confirm a density field is non-empty before wiring solver sourcing.
Instructions
Per-volume name, resolution, active voxels, value range, mean and sum.
A primitive count cannot tell a correctly named non-empty density field from an empty one, which is the question worth asking before wiring a solver's sourcing. This is the SOP counterpart of get_cop_vdb.
threshold or bins read the voxels (VDB: active ones) for percentiles, a histogram, the count over threshold and box_above_threshold, the world box of the voxels over it: where the smoke is, not where the grid is.
voxel_size, first_voxel_center and last_voxel_center place the grid (a VDB's: its active voxels): two volumes share a grid when all three match, which their bboxes cannot tell.
Args: node_path: SOP node path holding volume or VDB primitives. max_volumes: Cap on volumes reported. threshold: Split the voxels at this value and box the ones above it. bins: Histogram bin count, or a list of bin edges.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"node_path": "<node_path>"
},
"name": "get_volume_info"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bins | No | ||
| node_path | Yes | ||
| threshold | No | ||
| max_volumes | No |