Struct RirSegment 

pub struct RirSegment {
    pub onset_sample: usize,
    pub end_sample: usize,
    pub toa_sample: usize,
    pub doa: Option<[f32; 3]>,
    pub peak_energy: f64,
    pub is_direct_sound: bool,
}

A single segment of the RIR identified by SSIR analysis.

Each segment represents a discrete acoustic event (direct sound or early reflection) with a constant direction of arrival (DOA). Segments are consecutive — the end of one segment is the onset of the next, preserving the full temporal energy profile.

Fields

onset_sample: usize

Start sample of this segment (onset)

end_sample: usize

End sample (exclusive) — equals the next segment’s onset, or mixing time for the last segment

toa_sample: usize

Sample index of the peak arrival (TOA) within this segment

doa: Option<[f32; 3]>

Direction of arrival as a unit vector [x, y, z], if available from multi-channel input

peak_energy: f64

Peak energy (squared amplitude) at the TOA sample

is_direct_sound: bool

Whether this segment contains the direct sound

Implementations

impl RirSegment

pub fn len(&self) -> usize

Duration of this segment in samples

pub fn is_empty(&self) -> bool

Whether this segment has zero length

pub fn duration_secs(&self, sample_rate: f64) -> f64

Duration of this segment in seconds

pub fn duration_ms(&self, sample_rate: f64) -> f64

Duration of this segment in milliseconds

pub fn toa_ms(&self, sample_rate: f64) -> f64

Time of arrival relative to the RIR start, in milliseconds

pub fn azimuth_deg(&self) -> Option<f32>

DOA azimuth in degrees (0 = front, positive = left), if DOA is available. Computed from the x,y components of the DOA unit vector.

pub fn elevation_deg(&self) -> Option<f32>

DOA elevation in degrees, if DOA is available. Computed from the z component of the DOA unit vector.

Trait Implementations

impl Clone for RirSegment

fn clone(&self) -> RirSegment

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RirSegment

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.