Struct BeamFieldAnalysis 

pub struct BeamFieldAnalysis {
    pub beam_angle_ies: f64,
    pub field_angle_ies: f64,
    pub beam_angle_cie: f64,
    pub field_angle_cie: f64,
    pub max_intensity: f64,
    pub center_intensity: f64,
    pub max_intensity_gamma: f64,
    pub is_batwing: bool,
    pub beam_threshold_ies: f64,
    pub beam_threshold_cie: f64,
    pub field_threshold_ies: f64,
    pub field_threshold_cie: f64,
}

Comprehensive beam and field angle analysis.

Compares IES (maximum intensity based) and CIE (center-beam intensity based) definitions of beam angle and field angle. This is important for luminaires with non-standard distributions like “batwing” patterns.

See Wikipedia “Beam angle” article for the distinction between these definitions.

Fields

beam_angle_ies: f64

Beam angle using IES definition (50% of max intensity) in degrees

field_angle_ies: f64

Field angle using IES definition (10% of max intensity) in degrees

beam_angle_cie: f64

Beam angle using CIE definition (50% of center-beam intensity) in degrees

field_angle_cie: f64

Field angle using CIE definition (10% of center-beam intensity) in degrees

max_intensity: f64

Maximum intensity anywhere in the distribution (cd/klm)

center_intensity: f64

Center-beam intensity at nadir/0° gamma (cd/klm)

max_intensity_gamma: f64

Gamma angle at which maximum intensity occurs (degrees)

is_batwing: bool

True if this is a “batwing” distribution (center < max)

beam_threshold_ies: f64

50% of max intensity (IES beam threshold)

beam_threshold_cie: f64

50% of center intensity (CIE beam threshold)

field_threshold_ies: f64

10% of max intensity (IES field threshold)

field_threshold_cie: f64

10% of center intensity (CIE field threshold)

Implementations

impl BeamFieldAnalysis

pub fn beam_angle_difference(&self) -> f64

Returns the difference between CIE and IES beam angles.

A large positive value indicates a batwing distribution where the CIE definition gives a wider beam angle.

pub fn field_angle_difference(&self) -> f64

Returns the difference between CIE and IES field angles.

pub fn center_to_max_ratio(&self) -> f64

Returns the ratio of center intensity to max intensity.

A value less than 1.0 indicates a batwing or off-axis peak distribution.

pub fn distribution_type(&self) -> &'static str

Get descriptive classification of the distribution type.

pub fn to_string_detailed(&self) -> String

Format for display with both IES and CIE values.

Trait Implementations

impl Clone for BeamFieldAnalysis

fn clone(&self) -> BeamFieldAnalysis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BeamFieldAnalysis

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

Formats the value using the given formatter.

impl Default for BeamFieldAnalysis

fn default() -> BeamFieldAnalysis

Returns the “default value” for a type.

impl Display for BeamFieldAnalysis

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

Formats the value using the given formatter.

impl PartialEq for BeamFieldAnalysis

fn eq(&self, other: &BeamFieldAnalysis) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for BeamFieldAnalysis

impl StructuralPartialEq for BeamFieldAnalysis