Enum PackError 

pub enum PackError {
    WeightColumnsMismatch {
        module: String,
        got: usize,
        expected: usize,
        in_features: usize,
    },
    GroupColumnsMismatch {
        module: String,
        which: &'static str,
        got: usize,
        expected: usize,
        in_features: usize,
    },
    BufferLengthMismatch {
        module: String,
        which: &'static str,
        got: usize,
        expected: usize,
    },
    InFeaturesNotAligned {
        module: String,
        in_features: usize,
    },
    CodeOutOfRange {
        module: String,
        row: usize,
        group: usize,
        value: u8,
    },
    AsymmetricBias {
        module: String,
        row: usize,
        group: usize,
        bias: f32,
        scale: f32,
    },
}

Errors raised while packing a single MLX-quantized linear module into BlockTQ2_0_g128 blocks.

These are the parity guards described in the converter design: any violation means the MLX tensor does not match the validated ternary assumptions, so we refuse to produce a silently-wrong GGUF file.

Variants

WeightColumnsMismatch

The packed-weight column count does not equal in_features / 16.

Fields

module: String

Diffusers module name.

got: usize

Observed weight column count.

expected: usize

Expected column count (in_features / 16).

in_features: usize

Logical input-feature dimension.

GroupColumnsMismatch

The scales/biases column count does not equal in_features / 128.

Fields

module: String

Diffusers module name.

which: &'static str

Which sub-tensor ("scales" or "biases").

got: usize

Observed column count.

expected: usize

Expected column count (in_features / 128).

in_features: usize

Logical input-feature dimension.

BufferLengthMismatch

A sub-tensor buffer had an unexpected element count for the stated shape.

Fields

module: String

Diffusers module name.

which: &'static str

Which sub-tensor ("weight", "scales", "biases").

got: usize

Observed element count.

expected: usize

Expected element count from out × cols.

InFeaturesNotAligned

in_features is not a positive multiple of 128 (the TQ2_0_g128 group size).

Fields

module: String

Diffusers module name.

in_features: usize

Logical input-feature dimension.

CodeOutOfRange

A 2-bit MLX code exceeded 2 (i.e. a reserved q=3 was found), which is inconsistent with the validated ternary assumption (q ∈ {0, 1, 2}).

Fields

module: String

Diffusers module name.

row: usize

Output-feature row index.

group: usize

128-element group index along the input dimension.

value: u8

Observed code value (always > 2 when this error is raised).

AsymmetricBias

The affine bias was not exactly -scale, breaking the symmetric-ternary assumption (w = scale·(q-1)).

Fields

module: String

Diffusers module name.

row: usize

Output-feature row index.

group: usize

128-element group index along the input dimension.

bias: f32

Decoded bias value (f32).

scale: f32

Decoded scale value (f32).

Trait Implementations

impl Debug for PackError

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

Formats the value using the given formatter.

impl Display for PackError

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

Formats the value using the given formatter.

impl Error for PackError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<PackError> for MlxImageImportError

fn from(source: PackError) -> Self

Converts to this type from the input type.