MODULE REFERENCE

normality

anomx.models.base.normality

Normality model base contract.

A NormalityModel learns what "normal" looks like. What it can do with that knowledge is expressed through capability mixins (anomx.base.capabilities.Predictive, Reconstructive, Representational, Distributional, BoundaryEstimating), and what data it accepts through its anomx.base.signature.ModelSignature:

`python class TemporalFusionTransformer(NormalityModel, Predictive, Representational): signature = ModelSignature( structures={DataStructure.TEMPORAL_SEQUENCE}, modalities={Modality.NUMERIC}, requirements={"regular_or_known_timestamps"}, ) `

Trainable implementations live in the PyTorch domain: torch / lightning backends are the expected default for learned models (install the torch extra), while lightweight statistical baselines remain plain Python. A model never emits anomaly scores itself — scorers do that.

Forecast

Forecast(values: pd.DataFrame, metadata: dict[str, Any] = <factory: dict>)

Forecast values with optional model metadata.

Signature parameters
ParameterTypeDefault
valuespd.DataFramerequired
metadatadict[str, Any]<factory: dict>

Members

valuesattribute
values: pd.DataFrame
metadataattribute
metadata: dict[str, Any] = field(default_factory=dict)
to_dataframemethod
to_dataframe() -> pd.DataFrame

Return forecast values as a DataFrame.

Returns pd.DataFrame

NormalityModel

NormalityModel

Bases: Model, ABC

Base class for trainable normality models.

Members

component_typeattribute
capabilitiesattribute
capabilities: ClassVar[ComponentCapabilities] = ComponentCapabilities()
preferred_viewattribute
preferred_view: ClassVar[str] = 'tabular'
fitmethod
fit(data: Any) -> None

Train the model using input data.

Signature parameters
ParameterTypeDefault
dataAnyrequired

Returns None

predictmethod
predict(data: Any) -> Any

Generate model outputs for input data.

Signature parameters
ParameterTypeDefault
dataAnyrequired

Returns Any

savemethod
save(path: str) -> None

Persist model state.

Signature parameters
ParameterTypeDefault
pathstrrequired

Returns None

loadmethod
load(path: str) -> NormalityModel

Load model state and return the model instance.

Signature parameters
ParameterTypeDefault
pathstrrequired

Returns NormalityModel

partial_fitmethod
partial_fit(batch: Any) -> None

Incrementally update the model with one streaming batch.

Signature parameters
ParameterTypeDefault
batchAnyrequired

Returns None

score_batchmethod
score_batch(batch: Any) -> Any

Run streaming inference on one batch.

Signature parameters
ParameterTypeDefault
batchAnyrequired

Returns Any