mod region_assignment¶
- module region_assignment¶
Joint population assignment across fixed-probe attraction regions. Deterministic diversity-constrained assignment across attraction regions.
Region identity is supplied by the fixed-probe transition graph. Candidate utility contains only target-blind search evidence and physical admissibility; known reference or global-minimum morphology is not an input.
Functions
- fn diversity_constrained_assignment(candidates: &[RegionCandidate], slots: usize, max_family_size: usize) -> Result<Vec<u32>, RegionAssignmentError>¶
Assign a fixed population with attraction-region coverage before duplicates.
Enums
- enum RegionAssignmentError¶
Invalid candidate evidence or assignment parameters.
- NonFiniteUtility¶
A utility component contains NaN or infinity.
- NoAdmissibleSource¶
At least one admissible source is required for a nonempty assignment.
- ZeroFamilyCap¶
A positive family cap is required.
- InsufficientCapacity¶
The requested slots exceed the capacity allowed by the family cap.
Structs and Unions
- struct RegionCandidate¶
One source chain or observed frontier eligible for population assignment.
Implementations
- impl RegionCandidate¶
Functions
- fn is_admissible(self) -> bool¶
Whether geometry and system constraints permit adoption.
- fn new(source: u32, region: usize, utility: RegionUtility) -> Result<Self, RegionAssignmentError>¶
Construct an admissible candidate.
- fn region(self) -> usize¶
Fixed-probe attraction-region identifier.
- fn score(self) -> f64¶
Scalar target-blind assignment utility.
- fn source(self) -> u32¶
Source replica identifier.
- fn with_admissible(mut self, admissible: bool) -> Self¶
Mark whether the candidate satisfies physical constraints.
- struct RegionUtility¶
Target-blind terms used to rank a region frontier.
- transition_uncertainty: f64¶
Posterior uncertainty in fixed-probe outgoing dynamics.
- inverse_occupancy: f64¶
Inverse current chain occupancy of the attraction region.
- outgoing_frontier: f64¶
Evidence that an observed edge leaves the current attraction region.
- geometry_compatibility: f64¶
Compatibility with geometry, frozen atoms, cell, and molecular mode.
- access_cost: f64¶
Charged-work or transport cost needed to access the frontier.
Implementations
- impl RegionUtility¶
Functions
- fn score(self) -> f64¶
Additive target-blind utility used for deterministic ordering.