Struct AmountSampler 

pub struct AmountSampler { /* private fields */ }

Sampler for realistic transaction amounts.

Implementations

impl AmountSampler

pub fn new(seed: u64) -> Self

Create a new sampler with default configuration.

pub fn with_config(seed: u64, config: AmountDistributionConfig) -> Self

Create a sampler with custom configuration.

pub fn with_benford(seed: u64, config: AmountDistributionConfig) -> Self

Create a sampler with Benford’s Law compliance enabled.

pub fn with_fraud_config( seed: u64, config: AmountDistributionConfig, threshold_config: ThresholdConfig, benford_enabled: bool, ) -> Self

Create a sampler with full fraud configuration.

pub fn set_benford_enabled(&mut self, enabled: bool)

Enable or disable Benford’s Law compliance.

pub fn is_benford_enabled(&self) -> bool

Check if Benford’s Law compliance is enabled.

pub fn sample(&mut self) -> Decimal

Sample a single amount.

If Benford’s Law compliance is enabled, uses the Benford sampler. Otherwise uses log-normal distribution with round-number bias.

pub fn sample_lognormal(&mut self) -> Decimal

Sample using the log-normal distribution (original behavior).

pub fn sample_fraud(&mut self, pattern: FraudAmountPattern) -> Decimal

Sample a fraud amount with the specified pattern.

Returns a normal amount if fraud generator is not configured.

pub fn sample_summing_to( &mut self, count: usize, total: Decimal, ) -> Vec<Decimal>

Sample multiple amounts that sum to a target total.

Useful for generating line items that must balance. The sum of returned amounts is guaranteed to equal total exactly. Every returned amount is guaranteed to be > 0 when total > 0 and count * 0.01 <= total.

pub fn sample_in_range(&mut self, min: Decimal, max: Decimal) -> Decimal

Sample an amount within a specific range.

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

Reset the sampler with a new seed.

pub fn set_lognormal_sigma(&mut self, sigma: f64)

SP3.5b — Update the log-normal sigma parameter.

Also rebuilds the internal LogNormal distribution so that subsequent sample_lognormal() calls reflect the new sigma. No-op if sigma is not positive (guard against calibrator edge-cases).

pub fn set_round_number_probability(&mut self, p: f64)

SP3.5b — Update the round-number probability parameter.

Clamped to [0, 1] for safety.

pub fn lognormal_sigma(&self) -> f64

Return the current log-normal sigma (for testing).

pub fn round_number_probability(&self) -> f64

Return the current round-number probability (for testing).