feature_types

Feature types module.

Classes:

Name	Description
NumericalFeature	Numerical feature.
CategoricalFeature	Categorical feature.
MultivariateNumericalFeature	MultivariateNumericalFeature feature.
UnivariateTimeSeriesFeature	UnivariateTimeSerie feature.
MultivariateTimeSeriesFeature	MultivariateTimeSeries feature.

Functions:

Name	Description
feature_type_from_model	Convert json features into the corresponding Feature.

NumericalFeature

Numerical feature.

It represents quantifiable values that can be measured and ordered. Its values may be continuous (e.g., real numbers) or discrete (e.g., integers). For instance, "age" or "price" could be set as numerical features.

Parameters:

Name	Type	Description	Default
name	Literal['NUMERICAL']		'NUMERICAL'

Methods:

Name	Description
to_model	Convert to NumericalFeatureType instance.

Attributes:

Name	Type	Description
name	Literal['NUMERICAL']

name: Literal['NUMERICAL'] = 'NUMERICAL'

to_model() -> NumericalFeatureType

Convert to NumericalFeatureType instance.

Source code in src/xpdeep/dataset/feature/feature_types.py

def to_model(self) -> NumericalFeatureType:  # noqa: PLR6301
    """Convert to NumericalFeatureType instance."""
    return NumericalFeatureType(name="NUMERICAL")

CategoricalFeature

Categorical feature.

It represents data (bool, int or str only) that can be divided into distinct groups or categories.

It may be nominal or ordinal. For instance, "Education level" or "gender" could be set as categorical features.

Parameters:

Name	Type	Description	Default
categories	list[str] | list[int] | None	When building an AnalyzedSchema: If the preprocessor is one of label_encoder, onehot_encoder, then categories are automatically inferred from the preprocessor when fitted, and you should not provide any categories. Else, categories must be provided. When building a FittedSchema, categories must be provided. The categories' order must match the preprocessor's processing order. When using the dataset analyze and fit methods, no categories should be provided.	None
name	Literal['CATEGORICAL']		'CATEGORICAL'

Methods:

Name	Description
to_model	Convert to CategoricalFeatureType instance.
__attrs_post_init__	Return a fake category to be overwritten by the fitted preprocessor inferred categories.

Attributes:

Name	Type	Description
name	Literal['CATEGORICAL']
categories	list[str] | list[int] | None

name: Literal['CATEGORICAL'] = 'CATEGORICAL'

categories: list[str] | list[int] | None = None

to_model() -> CategoricalFeatureType

Convert to CategoricalFeatureType instance.

Source code in src/xpdeep/dataset/feature/feature_types.py

def to_model(self) -> CategoricalFeatureType:
    """Convert to CategoricalFeatureType instance."""
    return CategoricalFeatureType(
        name="CATEGORICAL",
        categories=[] if self.categories is None or len(self.categories) == 0 else self.categories,
    )

__attrs_post_init__() -> None

Return a fake category to be overwritten by the fitted preprocessor inferred categories.

Source code in src/xpdeep/dataset/feature/feature_types.py

def __attrs_post_init__(self) -> None:
    """Return a fake category to be overwritten by the fitted preprocessor inferred categories."""
    if self.categories is None:
        self.categories = ["fake_categories"]

MultivariateNumericalFeature

MultivariateNumericalFeature feature.

It represents numerical data points divided into several channels. Oppositely as time serie features, there is no time relationship between points here.

Parameters:

Name	Type	Description	Default
channel_names	List[str]	List of channel names used for visualization.	required
name	Literal['MULTIVARIATE_NUMERICAL']		'MULTIVARIATE_NUMERICAL'

Methods:

Name	Description
to_model	Convert to MultivariateNumericalFeatureType instance.

Attributes:

Name	Type	Description
channel_names	list[str]
name	Literal['MULTIVARIATE_NUMERICAL']

channel_names: list[str]

name: Literal['MULTIVARIATE_NUMERICAL'] = 'MULTIVARIATE_NUMERICAL'

to_model() -> MultivariateNumericalFeatureType

Convert to MultivariateNumericalFeatureType instance.

Source code in src/xpdeep/dataset/feature/feature_types.py

def to_model(self) -> MultivariateNumericalFeatureType:
    """Convert to MultivariateNumericalFeatureType instance."""
    return MultivariateNumericalFeatureType(name="MULTIVARIATE_NUMERICAL", channel_names=self.channel_names)

UnivariateTimeSeriesFeature

UnivariateTimeSerie feature.

It represents a time serie with a single channel, synchronized (no dynamic time warping required) or not.

The DTW will be applied automatically if this feature is required.

Parameters:

Name	Type	Description	Default
asynchronous	int	Whether the time serie is asynchronous (dynamic time warping will be automatically applied server side) or not.	False.
mirrored_channel	str | None	Used in XpViz. Indeed, if the same channel is used for both input (as a lookback, under a first feature object) and target (as a horizon to predict, under a second feature object), this parameter may be specified to visualize on the same curve both features, (the lookback and its corresponding horizon).	None
name	Literal['UNIVARIATE_TIME_SERIES']		'UNIVARIATE_TIME_SERIES'

Methods:

Name	Description
to_model	Convert to UnivariateTimeseriesFeatureType instance.

Attributes:

Name	Type	Description
name	Literal['UNIVARIATE_TIME_SERIES']
asynchronous	bool
mirrored_channel	str | None

name: Literal['UNIVARIATE_TIME_SERIES'] = 'UNIVARIATE_TIME_SERIES'

asynchronous: bool = field(default=False, kw_only=True)

mirrored_channel: str | None = field(default=None, kw_only=True)

to_model() -> UnivariateTimeseriesFeatureType

Convert to UnivariateTimeseriesFeatureType instance.

Source code in src/xpdeep/dataset/feature/feature_types.py

def to_model(self) -> UnivariateTimeseriesFeatureType:
    """Convert to UnivariateTimeseriesFeatureType instance."""
    return UnivariateTimeseriesFeatureType(
        name="UNIVARIATE_TIMESERIES",
        asynchronous=self.asynchronous,
        mirrored_channel=self.mirrored_channel,
    )

MultivariateTimeSeriesFeature

MultivariateTimeSeries feature.

This class represents a multivariate time series (multiple channels), synchronized (no dynamic time warping required) or not.

The DTW will be applied automatically if this feature is required.

Parameters:

Name	Type	Description	Default
asynchronous	int	Whether the time serie is asynchronous (dynamic time warping will be automatically applied server side) or not.	False.
channel_names	List[str]	List of channel names used for visualization.	required
name	Literal['MULTIVARIATE_TIME_SERIES']		'MULTIVARIATE_TIME_SERIES'

Methods:

Name	Description
to_model	Convert to MultivariateTimeseriesFeatureType instance.

Attributes:

Name	Type	Description
channel_names	list[str]
name	Literal['MULTIVARIATE_TIME_SERIES']
asynchronous	bool

channel_names: list[str]

name: Literal['MULTIVARIATE_TIME_SERIES'] = 'MULTIVARIATE_TIME_SERIES'

asynchronous: bool = field(default=False, kw_only=True)

to_model() -> MultivariateTimeseriesFeatureType

Convert to MultivariateTimeseriesFeatureType instance.

Source code in src/xpdeep/dataset/feature/feature_types.py

def to_model(self) -> MultivariateTimeseriesFeatureType:
    """Convert to MultivariateTimeseriesFeatureType instance."""
    return MultivariateTimeseriesFeatureType(
        name="MULTIVARIATE_TIMESERIES", asynchronous=self.asynchronous, channel_names=self.channel_names
    )

feature_type_from_model(json_response: dict[str, object]) -> NumericalFeature | CategoricalFeature | MultivariateNumericalFeature | UnivariateTimeSeriesFeature | MultivariateTimeSeriesFeature

Convert json features into the corresponding Feature.

Source code in src/xpdeep/dataset/feature/feature_types.py

def feature_type_from_model(
    json_response: dict[str, object],
) -> (
    NumericalFeature
    | CategoricalFeature
    | MultivariateNumericalFeature
    | UnivariateTimeSeriesFeature
    | MultivariateTimeSeriesFeature
):
    """Convert json features into the corresponding Feature."""
    match json_response["name"]:
        case "NUMERICAL":
            return NumericalFeature()
        case "CATEGORICAL":
            return CategoricalFeature(categories=json_response["categories"])  # type: ignore[arg-type]
        case "MULTIVARIATE_NUMERICAL":
            return MultivariateNumericalFeature(channel_names=json_response["channel_names"])  # type: ignore[arg-type]
        case "UNIVARIATE_TIMESERIES":
            return UnivariateTimeSeriesFeature(
                asynchronous=json_response["asynchronous"],  # type: ignore[arg-type]
                mirrored_channel=json_response["mirrored_channel"],  # type: ignore[arg-type]
            )
        case "MULTIVARIATE_TIMESERIES":
            return MultivariateTimeSeriesFeature(
                asynchronous=json_response["asynchronous"],  # type: ignore[arg-type]
                channel_names=json_response["channel_names"],  # type: ignore[arg-type]
            )
        case _:
            msg = f"Feature type `{json_response['expose_data_type']}` not recognized"
            raise ApiError(msg)