Struct TemporalSampler 

pub struct TemporalSampler { /* private fields */ }

Sampler for temporal patterns in transaction generation.

Implementations

impl TemporalSampler

pub fn new(seed: u64) -> Self

Create a new temporal sampler.

pub fn with_config( seed: u64, seasonality_config: SeasonalityConfig, working_hours_config: WorkingHoursConfig, holidays: Vec<NaiveDate>, ) -> Self

Create a temporal sampler with custom configuration.

pub fn with_full_config( seed: u64, seasonality_config: SeasonalityConfig, working_hours_config: WorkingHoursConfig, holidays: Vec<NaiveDate>, industry_seasonality: Option<IndustrySeasonality>, holiday_calendar: Option<HolidayCalendar>, ) -> Self

Create a temporal sampler with full enhanced configuration.

pub fn with_industry_seasonality(self, seasonality: IndustrySeasonality) -> Self

Set industry-specific seasonality.

pub fn with_holiday_calendar(self, calendar: HolidayCalendar) -> Self

Set regional holiday calendar.

pub fn set_industry_seasonality(&mut self, seasonality: IndustrySeasonality)

Set industry seasonality (mutable reference version).

pub fn set_holiday_calendar(&mut self, calendar: HolidayCalendar)

Set holiday calendar (mutable reference version).

pub fn industry_seasonality(&self) -> Option<&IndustrySeasonality>

Get the industry seasonality if set.

pub fn holiday_calendar(&self) -> Option<&HolidayCalendar>

Get the holiday calendar if set.

pub fn generate_us_holidays(year: i32) -> Vec<NaiveDate>

Generate US federal holidays for a given year.

pub fn is_weekend(&self, date: NaiveDate) -> bool

Check if a date is a weekend.

pub fn get_day_of_week_multiplier(&self, date: NaiveDate) -> f64

Get the day-of-week activity multiplier.

Returns a multiplier based on the day of the week:

• Monday: Higher activity (catch-up from weekend)
• Tuesday: Slightly elevated
• Wednesday/Thursday: Normal
• Friday: Reduced (early departures, winding down)
• Saturday/Sunday: Uses weekend_activity setting

pub fn is_holiday(&self, date: NaiveDate) -> bool

Check if a date is a holiday.

pub fn is_month_end(&self, date: NaiveDate) -> bool

Check if a date is month-end (last N days of month).

pub fn is_quarter_end(&self, date: NaiveDate) -> bool

Check if a date is quarter-end.

pub fn is_year_end(&self, date: NaiveDate) -> bool

Check if a date is year-end.

pub fn last_day_of_month(date: NaiveDate) -> NaiveDate

Get the last day of the month for a given date.

pub fn get_date_multiplier(&self, date: NaiveDate) -> f64

Get the activity multiplier for a specific date.

Combines:

• Base seasonality (month-end, quarter-end, year-end spikes)
• Day-of-week patterns (Monday catch-up, Friday slowdown)
• Weekend activity reduction
• Holiday activity reduction (from calendar or legacy list)
• Industry-specific seasonality (if configured)

pub fn get_base_date_multiplier(&self, date: NaiveDate) -> f64

Get the base multiplier without industry seasonality.

pub fn get_industry_multiplier(&self, date: NaiveDate) -> f64

Get only the industry seasonality multiplier for a date.

pub fn sample_date(&mut self, start: NaiveDate, end: NaiveDate) -> NaiveDate

Sample a posting date within a range based on seasonality.

pub fn sample_time(&mut self, is_human: bool) -> NaiveTime

Sample a posting time based on working hours.

pub fn expected_count_for_date( &self, date: NaiveDate, daily_average: f64, ) -> u64

Calculate expected transaction count for a date given daily average.

pub fn reset(&mut self, seed: u64)

Reset the sampler with a new seed.