Struct IsccNbsClassifier 

pub struct IsccNbsClassifier {
    pub wedge_system: MechanicalWedgeSystem,
    /* private fields */
}

ISCC-NBS color naming engine with deterministic boundary handling and performance caching.

This classifier translates Munsell color specifications into standardized ISCC-NBS color names using a mechanical wedge system for precise hue-based categorization and polygon containment testing.

Architecture

The classifier uses a two-stage approach:

1. Hue-based wedge selection: Determines which hue wedge contains the color
2. Polygon containment testing: Tests if the (value, chroma) point falls within any color polygons in that wedge

Thread Safety

This struct is thread-safe and can be shared across multiple threads using Arc<T>. The internal cache uses RwLock for concurrent access.

Examples

use munsellspace::iscc::IsccNbsClassifier;

let classifier = IsccNbsClassifier::new()?;

// Classify a Munsell color specification
if let Ok(Some(color_metadata)) = classifier.classify_munsell("5R", 5.0, 12.0) {
    println!("5R 5.0/12.0 is: {}", color_metadata.iscc_nbs_descriptor());
}

Fields

wedge_system: MechanicalWedgeSystem

Mechanical wedge system providing deterministic hue-based classification.

Divides the complete Munsell hue circle into 100 wedge containers, each containing the relevant color polygons for that hue range.

Implementations

impl IsccNbsClassifier

pub fn new() -> Result<Self, MunsellError>

Create a new ISCC-NBS classifier using embedded color data.

Initializes the classifier by loading embedded ISCC-NBS color definitions and distributing them into a mechanical wedge system for efficient hue-based classification.

Returns

Result containing the initialized classifier or an error if data loading fails

Errors

Returns MunsellError::ReferenceDataError if embedded color data cannot be loaded or parsed.

Examples

use munsellspace::IsccNbsClassifier;

let classifier = IsccNbsClassifier::new()?;
println!("Classifier initialized with embedded ISCC-NBS data");

pub fn from_csv(csv_path: &str) -> Result<Self, MunsellError>

Create a new ISCC-NBS classifier from external CSV file.

pub fn classify_munsell( &self, hue: &str, value: f64, chroma: f64, ) -> Result<Option<ColorMetadata>, MunsellError>

Classify a Munsell color using the ISCC-NBS system.

pub fn find_all_colors_at_point( &self, hue: &str, value: f64, chroma: f64, ) -> Result<Vec<u16>, MunsellError>

Find all ISCC-NBS colors that contain a given point. Returns just the color numbers.

pub fn classify( &self, hue: &str, value: f64, chroma: f64, ) -> Option<ColorMetadata>

Classify a Munsell color using the ISCC-NBS system (convenience method).

pub fn classify_with_details( &self, hue: &str, value: f64, chroma: f64, ) -> Option<(ColorMetadata, String)>

Classify a Munsell color with detailed error information.

pub fn get_polygon_in_wedge( &self, hue: &str, expected_descriptor: &str, ) -> Option<&IsccNbsColor>

Get a polygon by its expected descriptor and hue wedge

pub fn classify_munsell_color( &self, munsell: &MunsellColor, ) -> Result<Option<ColorMetadata>, MunsellError>

Classify a MunsellColor object using the ISCC-NBS system.

pub fn classify_srgb( &self, rgb: [u8; 3], ) -> Result<Option<ColorMetadata>, MunsellError>

👎Deprecated since 1.2.0: Use ColorClassifier::classify_srgb() for unified color naming. This method will be removed in v2.0.0.

Classify an sRGB color using the ISCC-NBS system.

Deprecated

Use ColorClassifier::classify_srgb() instead for unified access to standard, extended, and semantic color names.

pub fn classify_lab( &self, lab: [f64; 3], ) -> Result<Option<ColorMetadata>, MunsellError>

👎Deprecated since 1.2.0: Use ColorClassifier::classify_lab() for unified color naming. This method will be removed in v2.0.0.

Classify a Lab color using the ISCC-NBS system.

Deprecated

Use ColorClassifier::classify_lab() instead for unified access to standard, extended, and semantic color names.

pub fn classify_hex( &self, hex: &str, ) -> Result<Option<ColorMetadata>, MunsellError>

👎Deprecated since 1.2.0: Use ColorClassifier::classify_hex() for unified color naming. This method will be removed in v2.0.0.

Classify a hex color using the ISCC-NBS system.

Deprecated

Use ColorClassifier::classify_hex() instead for unified access to standard, extended, and semantic color names.