Struct CompileOptions 

pub struct CompileOptions {
    pub precision: Precision,
    pub policy: Option<PrecisionPolicy>,
    pub dce: bool,
    pub constant_folding: bool,
    pub verbose: bool,
    pub fusion_target: Option<FusionTarget>,
    pub fusion_opts: FusionOptions,
    pub arena_alignment: usize,
    pub assert_fusion_clean: bool,
    pub supported_ops: Option<&'static [OpKind]>,
    pub dim_binding: Option<DimBinding>,
    pub kernel_dispatch: KernelDispatchConfig,
}

All knobs the compile pipeline understands. Add new fields here rather than introducing new compile entry points.

Fields

precision: Precision

Target numeric precision for execution. Default: F32.

policy: Option<PrecisionPolicy>

Optional per-op precision policy (mixed precision rewrite).

dce: bool

Run dead-code elimination as part of compile. Default: true.

constant_folding: bool

Run constant folding. Default: true (cheap, only helps).

verbose: bool

Verbose pass logging. Equivalent to RLX_VERBOSE=1 or [rlx_ir::env::set("RLX_VERBOSE", "1")].

fusion_target: Option<FusionTarget>

Override fusion pipeline target (default: inferred from device).

fusion_opts: FusionOptions

Per-target fusion toggles (Metal env overrides, skip fusion, …).

arena_alignment: usize

Arena alignment for buffer planning. Default: 64.

assert_fusion_clean: bool

Panic at compile time if fusion diagnostics report missed patterns.

supported_ops: Option<&'static [OpKind]>

Backend op claim set for backend-aware fusion + post-fusion legalization. Set by [Backend::compile] implementations.

dim_binding: Option<DimBinding>

When set, specialize symbolic dims before backend lowering.

kernel_dispatch: KernelDispatchConfig

Native vs common IR lowering (KernelDispatchConfig, RLX_KERNEL_DISPATCH=common).

Implementations

impl CompileOptions

pub fn new() -> Self

pub fn precision(self, p: Precision) -> Self

pub fn policy(self, p: PrecisionPolicy) -> Self

pub fn no_policy(self) -> Self

pub fn with_dce(self, on: bool) -> Self

pub fn with_constant_folding(self, on: bool) -> Self

pub fn with_verbose(self, on: bool) -> Self

pub fn fusion_target(self, target: FusionTarget) -> Self

pub fn fusion_opts(self, opts: FusionOptions) -> Self

pub fn arena_alignment(self, bytes: usize) -> Self

pub fn supported_ops(self, ops: &'static [OpKind]) -> Self

pub fn assert_fusion_clean(self, on: bool) -> Self

pub fn dim_binding(self, binding: DimBinding) -> Self

pub fn kernel_dispatch(self, policy: KernelDispatchPolicy) -> Self

pub fn kernel_dispatch_config(self, config: KernelDispatchConfig) -> Self

pub fn force_common_kinds(self, kinds: &'static [OpKind]) -> Self

Force listed logical kernels to use common IR even when native is in supported_ops.

pub fn force_native_kinds(self, kinds: &'static [OpKind]) -> Self

Keep listed logical kernels native even under ForceCommon / missing from supported_ops.

Trait Implementations

impl Clone for CompileOptions

fn clone(&self) -> CompileOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompileOptions

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

Formats the value using the given formatter.

impl Default for CompileOptions

fn default() -> Self

Returns the “default value” for a type.