MODULE REFERENCE

datasets

anomx.data.datasets

Core dataset abstractions.

ChannelMetadata

ChannelMetadata(name: str, unit: str | None = None, description: str | None = None, tags: tuple[str, ...] = ())

Metadata describing one logical time-series channel.

Signature parameters
ParameterTypeDefault
namestrrequired
unitstr | NoneNone
descriptionstr | NoneNone
tagstuple[str, ...]()

Members

nameattribute
unitattribute
unit: str | None = None
descriptionattribute
description: str | None = None
tagsattribute
tags: tuple[str, ...] = ()

TimeSeriesDataset

TimeSeriesDataset(data: pd.DataFrame, target_columns: tuple[str, ...], name: str | None = None, metadata: dict[str, Any] = <factory: dict>, channels: dict[str, ChannelMetadata] = <factory: dict>)

A typed container for one or more aligned time-series channels.

The container keeps the public library independent from the Anomx platform's storage layer while preserving the metadata needed for auditable pipelines.

Signature parameters
ParameterTypeDefault
datapd.DataFramerequired
target_columnstuple[str, ...]required
namestr | NoneNone
metadatadict[str, Any]<factory: dict>
channelsdict[str, ChannelMetadata]<factory: dict>

Members

dataattribute
target_columnsattribute
target_columns: tuple[str, ...]
nameattribute
name: str | None = None
metadataattribute
metadata: dict[str, Any] = field(default_factory=dict)
channelsattribute
channels: dict[str, ChannelMetadata] = field(default_factory=dict)
from_dataframeclassmethod
from_dataframe(frame: pd.DataFrame, *, target_columns: str | list[str] | tuple[str, ...], time_column: str | None = None, name: str | None = None, metadata: dict[str, Any] | None = None) -> TimeSeriesDataset

Create a dataset from a DataFrame.

Args

frame

Source frame.

target_columns

Column or columns modeled by detectors and forecasters.

time_column

Optional column to convert into the DatetimeIndex.

name

Optional human-readable dataset name.

metadata

Optional metadata carried through pipelines.

Signature parameters
ParameterTypeDefault
framepd.DataFramerequired
target_columnskeyword onlystr | list[str] | tuple[str, ...]required
time_columnkeyword onlystr | NoneNone
namekeyword onlystr | NoneNone
metadatakeyword onlydict[str, Any] | NoneNone

Returns TimeSeriesDataset

frequencyproperty
frequency: str | None

Infer the dataset frequency when pandas can determine it.

Returns str | None

targetproperty
target: pd.Series | pd.DataFrame

Return the modeled target column or columns.

Returns pd.Series | pd.DataFrame

to_dataframemethod
to_dataframe() -> pd.DataFrame

Return a copy of the underlying DataFrame.

Returns pd.DataFrame

train_test_splitmethod
train_test_split(test_size: float | int) -> tuple[TimeSeriesDataset, TimeSeriesDataset]

Split the dataset into chronological train and test portions.

Signature parameters
ParameterTypeDefault
test_sizefloat | intrequired

Returns tuple[TimeSeriesDataset, TimeSeriesDataset]

resamplemethod
resample(rule: str, *, method: str = 'mean') -> TimeSeriesDataset

Return a resampled dataset using a pandas aggregation method.

Signature parameters
ParameterTypeDefault
rulestrrequired
methodkeyword onlystr'mean'

Returns TimeSeriesDataset