The Signal Report export produces a UTF-8 encoded JSON file containing source file metadata and a flat array of computed metrics. Use the 

Use window_title field for programmatic metric lookup — it is stable across SIGVIEW versions.

File Structure


Top-level object:

{

  "schema":  { "name": "sigview.signal_report_payload", "version": "0.1.0" },

  "file":    { ... },

  "metrics": [ ... ]

}


file Object

Field

Type

Description

path

string

Full absolute path of the source file

file_name

string

File name only

start_time

string

Recording start timestamp (ISO 8601 + millisecond suffix)

sample_rate

integer

Sample rate in Hz

length

number

Signal duration in x_unit

num_samples

integer

Total number of samples

x_unit

string

Time axis unit (e.g. "sec")

y_unit

string

Amplitude unit; empty string if dimensionless

description

string

User-defined signal description; may be empty

Metric Types

Every metric object contains window_title, type, description, and unit (where applicable). The type field determines additional fields:

type value

Extra fields

Description

"value"

y_value, optional x_value

Single numeric result. x_value gives the position on the x-axis where the value occurs (e.g. time or frequency).

"value distribution"

x_unit, y_unit, values

Histogram. values is an array of {x_from, x_to, y} bins. Bins are contiguous; probabilities sum to 1.0.

"octave values"

x_unit, y_unit, value_representation, values

Ordered array of band levels. Band edges listed in description. Currently value_representation = "db_rms".

"highest peaks"

x_unit, y_unit, requested_peak_count, peaks

peaks is an array of {x, y} objects sorted by amplitude descending.

Exported Metrics

Time-Domain Signal Statistics

window_title

Unit

Description

stdev

—

Standard deviation of the signal

variance

—

Variance of the signal

skewness

—

Skewness of the signal

kurtosis

—

Kurtosis of the signal

rms

—

RMS level of the signal

crest

—

Crest factor

median

—

Median amplitude

peak_to_peak_amplitude

—

Peak-to-peak amplitude

max_amplitude

—

Maximum amplitude. x_value = time position

min_amplitude

—

Minimum amplitude. x_value = time position

25_percent_quantile

—

25th percentile amplitude

75_percent_quantile

—

75th percentile amplitude

zero_crossing_rate

—

Zero-crossing rate

snr

dB

Signal-to-noise ratio

thd

%

Total harmonic distortion (THD)

thd_n

%

Total harmonic distortion plus noise (THD+N)

probability_distribution

prob

Histogram of signal amplitudes, 10 bins (value distribution)

Frequency-Domain — Raw Spectrum

Computed from a single FFT of the full signal, without averaging.

window_title

Unit

Description

spectrum_mean

Hz

Mean frequency of the spectrum. x_value = same

spectrum_median

Hz

Median frequency of the spectrum. x_value = same

spectrum_max_frequency

Hz

Frequency of the highest spectral peak

spectrum_max_frequency_amplitude

—

Amplitude of the highest spectral peak. x_value = frequency

spectrum_probability_distribution

prob

Histogram of spectrum amplitudes, 10 bins (value distribution)

spectral_centroid

Hz

Spectral centroid (amplitude-weighted mean frequency)

spectral_flatness

—

Spectral flatness (Wiener entropy)

dominant_frequency

Hz

Dominant (highest-energy) frequency

Frequency-Domain — Averaged Spectrum

Averaged over 10 spectra with 25 % overlap.

window_title

Unit

Description

avg_spectrum

—

Top 5 spectral peaks (highest peaks, x_unit = Hz)

avg_spectrum_mean

Hz

Mean frequency of the averaged spectrum. x_value = same

avg_spectrum_median

Hz

Median frequency of the averaged spectrum. x_value = same

avg_spectrum_max_frequency

Hz

Frequency of the highest peak

avg_spectrum_max_frequency_amplitude

—

Amplitude of the highest peak. x_value = frequency

avg_spectrum_probability_distribution

prob

Histogram of averaged spectrum amplitudes, 10 bins (value distribution)

2x_harmonics_avg_spectra

—

Amplitude of the 2nd harmonic of the dominant frequency. x_value = frequency

3x_harmonics_avg_spectra

—

Amplitude of the 3rd harmonic. x_value = frequency

4x_harmonics_avg_spectra

—

Amplitude of the 4th harmonic. x_value = frequency

5x_harmonics_avg_spectra

—

Amplitude of the 5th harmonic. x_value = frequency

Octave Band Analysis

window_title

Unit

Description

1_1_octave_plot

dB

1/1-octave band levels (octave values). Bands: 22–44, 44–88, 88–177, 177–355, 355–710, 710–1420, 1420–2840, 2840–5680, 5680–11360, 11360–22720 Hz

1_3_octave_plot

dB

1/3-octave band levels (octave values), 30 bands from 22.4 Hz to 22390 Hz. Band edges listed in the description field.

Note: Values are present only up to the Nyquist frequency of the signal. Higher bands are omitted.


Over-Time Curve Statistics

Each time-varying curve exports five derived scalar values: stdev, variance, mean, min, max. For min and max, x_value gives the time position of the extremum. The window_title is formed by combining the prefix below with the suffix (e.g. rms_over_time_min).

window_title prefix

Unit

Curve

rms_over_time_

dB

RMS level over time

stdev_over_time_

—

Standard deviation over time

crest_over_time_

—

Crest factor over time

kurtosis_over_time_

—

Kurtosis over time

skewness_over_time_

—

Skewness over time

dominant_frequency_over_time_

—

Dominant frequency over time

Time-FFT Slice Statistics

Statistics computed on the amplitude slice through the spectrogram (Time-FFT) at the dominant frequency.

window_title

Unit

Description

std_dev_of_max_frequency_slice

—

Standard deviation of the amplitude slice

variance_of_max_frequency_slice

—

Variance of the amplitude slice

skewness_of_max_frequency_slice

—

Skewness of the amplitude slice

kurtosis_of_max_frequency_slice

—

Kurtosis of the amplitude slice

Autocorrelation

window_title

Unit

Description

autocorrelation

—

Top 5 autocorrelation peaks (highest peaks, x_unit = sec). First peak is always at x = 0, y = 1.