Struct AtlasLabel 

pub struct AtlasLabel {
    pub e1: i8,
    pub e2: i8,
    pub e3: i8,
    pub d45: i8,
    pub e6: i8,
    pub e7: i8,
}

An Atlas label: 6-tuple identifying a resonance class.

Coordinate System

• e1, e2, e3: Binary coordinates (0 or 1)
• d45: Ternary coordinate (-1, 0, or +1) representing e₄ - e₅
• e6, e7: Binary coordinates (0 or 1)

Examples

use atlas_embeddings::foundations::resonance::AtlasLabel;

// Create label (0,0,0,0,0,0) - the "origin" vertex
let origin = AtlasLabel::new(0, 0, 0, 0, 0, 0);
assert!(origin.is_valid());

// Create label with ternary coordinate
let label = AtlasLabel::new(1, 0, 1, 1, 0, 1);
assert!(label.is_valid());
assert_eq!(label.d45(), 1);

// Invalid ternary value
let invalid = AtlasLabel::new(0, 0, 0, 2, 0, 0);
assert!(!invalid.is_valid());

Fields

e1: i8

First coordinate (binary: 0 or 1)

e2: i8

Second coordinate (binary: 0 or 1)

e3: i8

Third coordinate (binary: 0 or 1)

d45: i8

Difference d₄₅ = e₄ - e₅ (ternary: -1, 0, or +1)

e6: i8

Sixth coordinate (binary: 0 or 1)

e7: i8

Seventh coordinate (binary: 0 or 1)

Implementations

impl AtlasLabel

pub const fn new(e1: i8, e2: i8, e3: i8, d45: i8, e6: i8, e7: i8) -> Self

Create a new Atlas label.

Arguments

• e1, e2, e3, e6, e7 - Binary coordinates (should be 0 or 1)
• d45 - Ternary coordinate (should be -1, 0, or +1)

Note

This constructor does not validate inputs. Use is_valid to check validity.

pub const fn is_valid(&self) -> bool

Check if this label is valid.

Validity conditions:

• Binary coordinates in {0, 1}
• Ternary coordinate in {-1, 0, +1}

pub const fn d45(&self) -> i8

Get the ternary coordinate d₄₅ = e₄ - e₅.

pub const fn binary_weight(&self) -> usize

Count the number of 1’s in the binary coordinates.

This is used in determining adjacency and other properties.

Trait Implementations

impl Clone for AtlasLabel

fn clone(&self) -> AtlasLabel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AtlasLabel

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

Formats the value using the given formatter.

impl Hash for AtlasLabel

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AtlasLabel

fn eq(&self, other: &AtlasLabel) -> 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 AtlasLabel

impl Eq for AtlasLabel

impl StructuralPartialEq for AtlasLabel