pymixef.errors module

Stable, machine-readable exceptions used throughout pymixef.

Public exceptions carry a code, remediation, and structured details. The human-readable message may improve over time; callers should branch on code or the exception type rather than parsing message text.

exception pymixef.errors.CompatibilityError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: PyMixEFError

Two scientific objects cannot safely be compared or translated.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'COMPATIBILITY-001'
exception pymixef.errors.CovarianceError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: ValidationError

A covariance declaration or matrix is invalid.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'COV-INVALID-001'
exception pymixef.errors.DataError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: ValidationError

Input data cannot be adapted without changing its meaning.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'DATA-INVALID-001'
exception pymixef.errors.EngineCompatibilityError(message, *, suggested_engines=(), **kwargs)[source]

Bases: UnsupportedCapabilityError

The selected estimator cannot represent the compiled model.

Parameters:

  • message (str)

  • suggested_engines (list[str] | tuple[str, ...])

  • kwargs (Any)

Return type:

None

to_dict()[source]

Return a JSON-compatible diagnostic record.

Return type:

dict[str, Any]

exception pymixef.errors.FormulaError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: ValidationError

A formula is syntactically invalid, unsafe, or semantically ambiguous.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'FORMULA-SYNTAX-001'
exception pymixef.errors.IRValidationError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: ValidationError

A model IR violates the versioned schema’s semantic invariants.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'IR-VALIDATION-001'
exception pymixef.errors.IRVersionError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: PyMixEFError

A serialized model IR uses an unsupported or unsafe schema version.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'IR-VERSION-001'
exception pymixef.errors.PluginError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: PyMixEFError

A plugin registration or discovery operation failed.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'PLUGIN-ERROR-001'
exception pymixef.errors.PyMixEFError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: Exception

Base class for all expected PyMixEF failures.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'PYMIXEF-ERROR-001'
to_dict()[source]

Return a JSON-compatible diagnostic record.

Return type:

dict[str, Any]

exception pymixef.errors.TransformError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: ValidationError

A parameter transform received a value outside its domain.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'TRANSFORM-DOMAIN-001'
exception pymixef.errors.UnsupportedCapabilityError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: PyMixEFError

No selected engine can execute a requested scientific capability.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'ENGINE-UNSUPPORTED-001'
pymixef.errors.UnsupportedEngineError

alias of EngineCompatibilityError

exception pymixef.errors.ValidationError(message, *, code=None, remediation=None, details=None, source_location=None)[source]

Bases: PyMixEFError

A model failed deterministic semantic validation.

Parameters:

  • message (str)

  • code (str | None)

  • remediation (str | None)

  • details (Mapping[str, Any] | None)

  • source_location (str | None)

Return type:

None

default_code = 'MODEL-VALIDATION-001'