Struct ArchitecturePartition 

pub struct ArchitecturePartition<G, A> { /* private fields */ }

Complete backend-neutral realization of one rank’s architecture ownership.

G is family-owned local construction geometry. A is the family-owned primary and auxiliary wire schema carried by the partition realization.

Implementations

impl<G, A> ArchitecturePartition<G, A>

pub fn from_architecture<B, S, M, N>( architecture: &M, group_ranges: impl IntoIterator<Item = (N, Range<usize>)>, ownership: PartitionOwnership, local_geometry: G, boundary_schema: A, parameters: &ArchitectureParameterDescription, ) -> Result<Self, ArchitecturePartitionError>

where B: NeuralBackend, S: RuntimeState<B>, M: LayeredArchitecture<B, S>, M::Error: Display, N: Into<String>, A: ArchitectureBoundary,

Creates a partition from the topology declared by one concrete neutral architecture.

This constructor derives the graph and unit layout from architecture, preventing a backend realization from publishing a parallel topology that merely resembles, but is not the canonical topology of, the architecture it will execute. Pre-allocation selection should use Self::from_description with the architecture-authored declaration.

pub fn from_description<N>( parameters: &ArchitectureParameterDescription, group_ranges: impl IntoIterator<Item = (N, Range<usize>)>, ownership: PartitionOwnership, complete_state: &StateLayout, state_plan: &ArchitectureStatePartitionPlan, local_geometry: G, boundary_schema: A, ) -> Result<Self, ArchitecturePartitionError>

where N: Into<String>, A: ArchitectureBoundary,

Creates an authoritative partition from architecture-authored static declarations.

This path exists for pre-materialization selection: it validates and consumes the canonical graph/unit declaration, state plan, boundary schema, local geometry, and parameter topology without constructing a backend module merely to rediscover those facts. Concrete backends must not synthesize any of these inputs.

pub const fn graph(&self) -> &ExecutionGraph

Returns the canonical architecture execution graph.

pub const fn unit_layout(&self) -> &ExecutionUnitLayout

Returns the canonical complete execution-unit layout.

pub fn groups(&self) -> &[PartitionGroup]

Returns groups and group-local global unit ranges owned by this rank.

pub fn units(&self) -> impl Iterator<Item = ExecutionUnitAddress> + '_

Traverses rank-owned execution units in canonical architecture order.

pub fn owns_unit(&self, group: &str, global_unit: usize) -> bool

Returns whether this rank owns one group-local global unit.

pub const fn ownership(&self) -> &PartitionOwnership

Returns input, output, and static-module ownership.

pub const fn state(&self) -> Option<&PartitionState>

Returns rank-local state geometry when this partition owns mutable state.

pub fn prompt_cache_identity<B, M>( &self, architecture: &M, topology: PromptCacheTopology, ) -> Result<PromptCacheModelIdentity, ArchitecturePartitionError>

where B: NeuralBackend, M: ArchitectureParameters<B>, M::DefinitionError: Display,

Derives prompt-cache identity from this partition’s canonical state.

pub fn resolve_state_partition( &self, complete: &StateLayout, plan: &ArchitectureStatePartitionPlan, ) -> Result<Option<PartitionState>, ArchitectureStatePartitionError>

Resolves the architecture-authored state plan for this realized partition.

The current partition representation stores one contiguous global state interval. A valid plan may describe multiple semantic ranges, but the ranges selected by any one partition must be adjacent.

pub const fn local_geometry(&self) -> &G

Returns family-owned rank-local construction geometry.

pub const fn boundary_schema(&self) -> &A

Returns the family-owned primary and auxiliary boundary schema.

pub fn boundary_schema_mut(&mut self) -> &mut A

Mutably returns the family-owned primary and auxiliary boundary schema.

pub fn parameter_bindings(&self) -> &[OwnedParameterGroupSpec]

Returns neutral semantic parameter bindings owned by this rank.

pub fn parameter_bindings_for_owner<'a>( &'a self, owner: &'a ParameterGroupOwner, ) -> impl Iterator<Item = &'a ParameterGroupSpec> + 'a

Returns the exact neutral groups assigned to one architecture owner.

pub fn validate_architecture<B, S, M>( &self, architecture: &M, ) -> Result<(), ArchitecturePartitionError>

where B: NeuralBackend, S: RuntimeState<B>, M: LayeredArchitecture<B, S>, M::Error: Display,

Proves that this partition still describes the supplied concrete neutral architecture.

Loaders may use this when a partition crosses a backend boundary or is restored from a prepared plan. Both dependency edges and exact unit counts are compared; matching group names alone are insufficient.

Trait Implementations

impl<G: Clone, A: Clone> Clone for ArchitecturePartition<G, A>

fn clone(&self) -> ArchitecturePartition<G, A>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<G: Debug, A: Debug> Debug for ArchitecturePartition<G, A>

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

Formats the value using the given formatter.