series

Generic synthetic series generator.

class pysatl_cpd.data.generator.series.GenericSeriesGenerator(*, seed=None)[source]

Bases: object

Generic series generator for synthetic time series data.

This generator creates synthetic series from scenario specifications or segment generators, supporting various distribution types including univariate and multivariate distributions.

Parameters:

seed (int | None) – Seed for reproducible generation. None uses system entropy.

__init__(*, seed=None)[source]
Parameters:

seed (int | None)

Return type:

None

generate_from_scenario(scenario, *, name=None)[source]

Generate a series from a scenario specification.

Parameters:
  • scenario (ScenarioSpec) – Scenario specification defining segments and distributions.

  • name (str | None) – Optional name for the generated series.

Returns:

Generated series with data, feature names, and segment info.

Return type:

GeneratedSeries

Raises:

ValueError – If scenario segments have mismatched feature names or the scenario contains no segments.

generate_from_segment_generators(segment_generators, *, name=None)[source]

Generate a series from segment generators.

Parameters:
Returns:

Generated series with data, feature names, and segment info.

Return type:

GeneratedSeries

Raises:

ValueError – If segment generators is empty or have mismatched feature names.