Skip to main content

Volume Statistics

The Volume Statistics tool calculates grayscale-based statistics for the active volume dataset and generates a histogram of pixel intensities. Statistics can be filtered by mask regions and computed for individual slices or the entire volume.

Accessing the Tool​

  1. Navigate to the Measure tab in the ribbon
  2. Click the Volume Statistics button in the Statistics section

Overview​

Calculate grayscale-based statistics for the active volume dataset and generate a histogram of pixel intensities, with an option to filter data by selecting corresponding masks.

Prerequisites

An active volume dataset must be loaded in the project. Mask-based filtering requires at least one mask object.


User Interface​

Description​

Displays: "Calculate grayscale-based statistics for the active volume dataset and generate a histogram of pixel intensities, with an option to filter data by selecting corresponding masks."

Options​

ControlDescription
TargetSelect the data source for statistics calculation
SliceChoose which slice(s) to analyze

Target Options​

OptionDescription
Active volumeCalculate statistics for all pixels in the active volume dataset
Active maskCalculate statistics for pixels within the active mask only
Visible masksCalculate statistics for pixels within the union of all visible masks

Slice Options​

OptionDescription
Current Plane 1 (YZ) sliceAnalyze only the current Plane 1 (YZ) slice
Current Plane 2 (XZ) sliceAnalyze only the current Plane 2 (XZ) slice
Current Plane 3 (XY) sliceAnalyze only the current Plane 3 (XY) slice
All slicesAnalyze the entire volume (default)

Histogram Chart​

The histogram is drawn in the Interactive Histogram Chart. Right-click the chart to reach its display options, its interval actions, and its export actions.

SettingDescription
ScaleLinear or logarithmic frequency axis
GraphBars, line, or filled line
BinningGroups the bins before they are drawn

Drag across the chart to mark a gray value range. The marked range reports its borders, mean, standard deviation, total, and share of the analyzed data, which complements the tables below with a value for a region of the distribution.

Information Table​

The group is titled Information and displays context about the analysis:

FieldDescription
VolumeName of the active volume dataset
MaskName of the mask (if mask filtering is used)
SliceWhich slice or "All slices"

Whole Volume Statistics Table​

The group is titled Whole volume statistics and lists the calculated statistics for the analyzed region as Name and Value rows, in this order:

StatisticDescription
Mean gray valueAverage gray value
Median gray valueMiddle value when the gray values are sorted
Std. dev. of gray valuesMeasure of gray value variation
Voxel countNumber of voxels analyzed
Volume (mm³)Physical volume of the analyzed region
Volume fraction (%)Analyzed volume relative to the total image volume
Min. gray value / Max. gray valueLowest and highest gray value
Min. gray value index / Max. gray value indexVoxel index where each extreme occurs
VarianceSquare of the standard deviation
RMSRoot mean square of the gray values
SkewnessMeasure of distribution asymmetry
KurtosisMeasure of distribution tail weight
UniformityUniformity of the gray values
EntropyEntropy of the gray value distribution
Mean of positive pixelsMean over the positive gray values only
Uniformity of positive pixelsUniformity over the positive gray values only
5% / 25% / 50% / 75% / 95% quantile valueGray value below which that share of the voxels falls

A skewed gray value distribution with the mean, median, 5 and 95 percent quantiles and the standard deviation marked, and the statistics table computed from it

Three statistics are renamed in slice mode

A single slice has no volume, so Voxel count becomes Pixel count, Volume (mm³) becomes Area (mm²), and Volume fraction (%) becomes Area fraction (%).

Volume Statistics Within Individual Visible Mask​

When the Visible masks target is selected, an additional table titled Volume statistics within individual visible mask shows the statistics for each visible mask separately.


Workflow​

Basic Statistics Calculation​

  1. Ensure a volume dataset is active
  2. Open the Volume Statistics tool
  3. Select Active volume as the target
  4. Choose All slices to analyze the complete volume
  5. Statistics are calculated and displayed automatically
  6. The histogram updates to show the intensity distribution

Masked Region Statistics​

  1. Create or activate a mask covering the region of interest
  2. Open the Volume Statistics tool
  3. Select Active mask or Visible masks as the target
  4. Statistics are calculated only for voxels within the mask

Slice-Specific Statistics​

  1. Navigate to the slice of interest
  2. Open the Volume Statistics tool
  3. Select the corresponding slice option
  4. Statistics reflect only that slice's pixel values

Export​

Click the Export... button to save results. Export options include:

  • CSV file: Tabular statistics data, followed by the histogram at its full resolution
  • PDF Report: Formatted report with statistics, histogram, and optional snapshots

The PDF report includes:

  • Analysis settings (target, slice, histogram binning, frequency axis scaling)
  • Information table
  • Statistics table
  • Histogram visualization
  • Histogram data table

The histogram picture in the report always shows the whole gray value range, so a zoom you set on screen does not change it. The histogram data table groups the gray values into as many rows as the chart draws bars, so that it fits into the report. Each row states the gray value range it covers, in a Grayvalue from and a Grayvalue to column, and the pixel count next to it is the exact number of pixels within that range.

The histogram in the CSV file and the Export as CSV... action in the chart context menu are both written at the full resolution of the analyzed region, not at the resolution the chart is drawn with. For an integer image this resolves every gray value, so each row carries one gray value and its pixel count. A floating point image has no gray value step, so each row covers a range of gray values and states it in a Grayvalue from and a Grayvalue to column. Use either file when the distribution is analysed further, and the report table when it documents what the chart shows. The chart can also be saved as a picture from the same menu; see Exporting the Chart.

If the active volume changes while the file dialog is open, the histogram can no longer be recomputed for the volume the chart shows. The export is then cancelled with a message instead of writing a file, so a report never carries a distribution measured on a different volume.


Use Cases​

Image Quality Assessment​

Analyze mean, standard deviation, and histogram shape to assess image quality and noise levels.

Tissue Characterization​

Compare statistics across different masked regions to characterize tissue types.

Threshold Determination​

Use histogram visualization and statistics to determine appropriate segmentation thresholds.

Comparative Analysis​

Compare statistics between different volumes or time points for longitudinal studies.


PageDescription
Interactive Histogram ChartReading, navigating, and evaluating the histogram chart
HistogramFocused histogram visualization without statistics tables
Volume Similarity StatisticsCompare two volumes
Mask StatisticsShape and intensity statistics for masks