Struct LmbMultiChannelingSetup 

pub struct LmbMultiChannelingSetup {
    pub lmb_basis_ids: TiVec<SamplingChannelId, LmbIndex>,
    pub graph: Graph,
    pub all_bases: TiVec<LmbIndex, LoopMomentumBasis>,
    /* private fields */
}

Helper struct for the LMB multi-channeling setup

Fields

lmb_basis_ids: TiVec<SamplingChannelId, LmbIndex>

graph: Graph

Canonical group-master graph used to resolve group-level channel overrides.

all_bases: TiVec<LmbIndex, LoopMomentumBasis>

Implementations

impl LmbMultiChannelingSetup

pub fn sampling_bridge<T: FloatLike>(&self) -> Result<&SamplingChannelBridge<T>>

Borrow the bridge compiled in the current successful warmup epoch, or replay that precision’s cached numerical failure into the stability loop. Explicit constructors remain fresh and never populate this runtime cache.

pub fn sampling_channel_catalogue( &self, resolved: &ResolvedSamplingChannelSelection, parameterization_settings: &ParameterizationSettings, ) -> Result<SamplingChannelCatalogue>

Expand a graph-resolved selection into the canonical catalogue used by inspection and map construction. Resolve with the actual graph name before invoking this method (the setup may be shared by a graph group).

pub fn inspect_sampling_channels( &self, resolved: &ResolvedSamplingChannelSelection, parameterization_settings: &ParameterizationSettings, ) -> Result<SamplingChannelInspection>

Resolve the canonical catalogue and return its read-only inspection view. This is useful to CLI/Python diagnostics and intentionally does not compile maps, prepare kinematics, or enumerate a second channel domain.

pub fn sampling_channel_coverage_report( &self, resolved: &ResolvedSamplingChannelSelection, parameterization_settings: &ParameterizationSettings, ) -> Result<SamplingCoverageReport>

Report the conservative full-domain and elementary soft coverage of the canonical catalogue. This is an inspection operation only: it does not discover physical E-surfaces or construct a second channel enumeration.

pub fn sampling_channel_catalogue_with_surfaces( &self, resolved: &ResolvedSamplingChannelSelection, parameterization_settings: &ParameterizationSettings, surface_edges: &[Vec<usize>], ) -> Result<SamplingChannelCatalogue>

Resolve the same selection while supplying E-surface candidates already enumerated in the master graph frame. Surface existence and geometry are still prepared per cut/orientation before compilation.

pub fn compile_sampling_channels<T: FloatLike>( &self, catalogue: &SamplingChannelCatalogue, programs: &[(Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>)], context: &SamplingChannelCompileContext<T>, ) -> Result<Vec<CompiledSamplingChannel<T>>>

Compile the selected catalogue against prepared master-graph kinematics. The context binds each surface’s native equation and frame; any cut/side centers, radii and t* are prepared from its declared prior blocks inside the compiled map. This rejects missing or stale physical prerequisites before a mapped sample reaches the graph evaluator.

pub fn compile_sampling_channels_with_external<T: FloatLike>( &self, catalogue: &SamplingChannelCatalogue, programs: &[(Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>)], context: &SamplingChannelCompileContext<T>, external_momenta: &[[T; 4]], ) -> Result<Vec<CompiledSamplingChannel<T>>>

Compile channels after preparing the external data needed by every selected-LMB-to-parent affine routing. This is the required entry point when a channel catalogue contains more than the parent LMB; callers must pass external data from the same solved cut/orientation context as the map geometry.

pub fn compile_sampling_channel_bridge<T: FloatLike>( &self, catalogue: &SamplingChannelCatalogue, programs: &[(Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>)], context: &SamplingChannelCompileContext<T>, ) -> Result<SamplingChannelBridge<T>>

Compile the selected channels and bind them to the raw-frame bridge. The process sampler supplies the prepared frame and external data.

pub fn compile_sampling_channel_bridge_with_external<T: FloatLike>( &self, catalogue: &SamplingChannelCatalogue, programs: &[(Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>, Option<SamplingExpressionEvaluator>)], context: &SamplingChannelCompileContext<T>, external_momenta: &[[T; 4]], ) -> Result<SamplingChannelBridge<T>>

External-data variant of Self::compile_sampling_channel_bridge.

pub fn canonical_sampling_catalogue( &self, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<SamplingChannelCatalogue>

Build the one canonical catalogue used by all channel-count and LMB lookup helpers during the runtime migration. The old generated basis list is only input data for this catalogue; it is never enumerated as a second channel universe.

pub fn sampling_channel_ids( &self, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<Vec<SamplingChannelId>>

Return the stable IDs from the one canonical catalogue.

pub fn sampling_channel_label( &self, channel_id: SamplingChannelId, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<String>

pub fn sampling_channel_is_lmb( &self, channel_id: SamplingChannelId, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<bool>

pub fn sampling_channel_lmb_id( &self, channel_id: SamplingChannelId, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<Option<LmbIndex>>

Return the generated LMB behind a canonical channel when that channel is an LMB entry. Graph-aware channels intentionally have no LMB index; callers that only expose LMB metadata can skip those entries without creating a second channel enumeration.

pub fn sampling_channel_lmb_basis_id( &self, channel_id: SamplingChannelId, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<LmbIndex>

Resolve a canonical sampling channel to its generated LMB basis.

This strict accessor is intentionally named in terms of the canonical sampling catalogue. It is only valid for channels whose map is an LMB; graph-aware channels must be evaluated through the sampling bridge.

pub fn sampling_channel_edge_ids( &self, channel_id: SamplingChannelId, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<SmallVec<[usize; 4]>>

pub fn selected_lmb_basis_id( &self, graph_name: &str, parameterization_settings: &ParameterizationSettings, ) -> Result<LmbIndex>

pub fn lmb_frame_map<T: FloatLike>( &self, channel_lmb: &LoopMomentumBasis, external_momenta: &[[T; 4]], ) -> Result<SamplingMapAffine<T>>

Build the exact affine routing from one generated LMB into this setup’s parent loop frame. The integer edge signatures provide the linear block matrix; the supplied external momenta provide its translation. Keeping this operation on the graph-aware setup ensures that a compiled channel never mistakes selected-LMB coordinates for parent-frame coordinates.

Trait Implementations

impl Clone for LmbMultiChannelingSetup

fn clone(&self) -> LmbMultiChannelingSetup

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<__Context> Decode<__Context> for LmbMultiChannelingSetup

where __Context: GammaLoopContext,

fn decode<D: Decoder<Context = __Context>>( decoder: &mut D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Encode for LmbMultiChannelingSetup

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.