Skip to content

rencal.simulation.intermittent_bucketer

rencal.simulation.intermittent_bucketer provides the default single-category bucketer for intermittency sampling.

IntermittentBucketer extends Bucketer with a single category (no extra categorical filtering), while preserving month-based bucket seasonality for random historical draw selection.

import datetime as dt
from rencal.simulation.intermittent_bucketer import IntermittentBucketer
bucketer = IntermittentBucketer(
historical_start_date=dt.datetime(1990, 1, 1),
historical_end_date=dt.datetime(2025, 12, 31),
)
class IntermittentBucketer(
historical_start_date,
historical_end_date,
draw_period=7,
bucket_definition=MONTHLY_BUCKET_DEFINITION,
): IntermittentBucketer

Constructs a one-category bucketer with monthly bucket partition defaults.

  • historical_start_date datetime.datetime

    First historical day available for sampling.

  • historical_end_date datetime.datetime

    Last historical day available for sampling.

  • draw_period int

    Number of consecutive days represented by one draw.

  • bucket_definition list[ShortDate]

    Bucket boundaries used for seasonality-aware sampling.

Returns IntermittentBucketer

assign_category(date) -> int

Returns category 0 for every date.

Returns int

tabulate_date_info(date) -> list[int]

Returns lookup payload with the computed bucket index.

Returns list[int]