sampler

Documentation

Index

• Variables
• func Seed(seed int64)
• type Uniform
  • func NewBestUniform(expectedSampleSize int) Uniform
  • func NewUniform() Uniform
• type Weighted
  • func NewDeterministicWeighted() Weighted
  • func NewWeighted() Weighted
• type WeightedWithoutReplacement
  • func NewBestWeightedWithoutReplacement(expectedSampleSize int) WeightedWithoutReplacement
  • func NewDeterministicWeightedWithoutReplacement() WeightedWithoutReplacement
  • func NewWeightedWithoutReplacement() WeightedWithoutReplacement

Variables

var ErrOutOfRange = errors.New("out of range")

Functions

func Seed

func Seed(seed int64)

Types

type Uniform

type Uniform interface {
	Initialize(sampleRange uint64)
	// Sample returns length numbers in the range [0,sampleRange). If there
	// aren't enough numbers in the range, an error is returned. If length is
	// negative the implementation may panic.
	Sample(length int) ([]uint64, error)

	Seed(int64)
	ClearSeed()

	Reset()
	Next() (uint64, error)
}

Uniform samples values without replacement in the provided range

func NewBestUniform

func NewBestUniform(expectedSampleSize int) Uniform

NewBestUniform returns a new sampler

func NewUniform

func NewUniform() Uniform

NewUniform returns a new sampler

type Weighted

type Weighted interface {
	Initialize(weights []uint64) error
	Sample(sampleValue uint64) (int, error)
}

Weighted defines how to sample a specified valued based on a provided weighted distribution

func NewDeterministicWeighted

func NewDeterministicWeighted() Weighted

func NewWeighted

func NewWeighted() Weighted

NewWeighted returns a new sampler

type WeightedWithoutReplacement

type WeightedWithoutReplacement interface {
	Initialize(weights []uint64) error
	Sample(count int) ([]int, error)

	Seed(int64)
	ClearSeed()
}

WeightedWithoutReplacement defines how to sample weight without replacement. Note that the behavior is to sample the weight without replacement, not the indices. So duplicate indices can be returned.

func NewBestWeightedWithoutReplacement

func NewBestWeightedWithoutReplacement(
	expectedSampleSize int,
) WeightedWithoutReplacement

NewBestWeightedWithoutReplacement returns a new sampler

func NewDeterministicWeightedWithoutReplacement

func NewDeterministicWeightedWithoutReplacement() WeightedWithoutReplacement

NewWeightedWithoutReplacement returns a new sampler

func NewWeightedWithoutReplacement

func NewWeightedWithoutReplacement() WeightedWithoutReplacement

NewWeightedWithoutReplacement returns a new sampler