tuple

type CompactSketch[S Summary] struct {
	// contains filtered or unexported fields
}

type Decoder[S Summary] struct {
	// contains filtered or unexported fields
}

type Encoder[S Summary] struct {
	// contains filtered or unexported fields
}

type Intersection[S Summary] struct {
	// contains filtered or unexported fields
}

type IntersectionOptionFunc func(*intersectionOptions)

type JaccardSimilarityResult struct {
	LowerBound float64
	Estimate   float64
	UpperBound float64
}

type Policy[S Summary] interface {
	// Apply is called when a matching summary is found.
	// internalSummary: the summary already in
	// incomingSummary: the matching summary from the incoming sketch
	Apply(internalSummary S, incomingEntry S)
}

type Sketch[S Summary] interface {
	// IsEmpty reports whether this sketch represents an empty set.
	// Note: this is not the same as having no retained hashes.
	IsEmpty() bool

	// Estimate returns the estimated distinct count of the input stream.
	Estimate() float64

	// LowerBoundFromSubset returns the approximate lower error bound for
	// the given number of standard deviations over a subset of retained hashes.
	// numStdDevs specifies the confidence level (1, 2, or 3) corresponding to
	// approximately 67%, 95%, or 99% confidence intervals.
	// numSubsetEntries specifies number of items from {0, 1, ..., get_num_retained()}
	// over which to estimate the bound.
	LowerBoundFromSubset(numStdDevs uint8, numSubsetEntries uint32) (float64, error)

	// LowerBound returns the approximate lower error bound for the given
	// number of standard deviations. numStdDevs should be 1, 2, or 3 for
	// approximately 67%, 95%, or 99% confidence intervals.
	LowerBound(numStdDevs uint8) (float64, error)

	// UpperBoundFromSubset returns the approximate upper error bound for
	// the given number of standard deviations over a subset of retained hashes.
	// numStdDevs specifies the confidence level (1, 2, or 3) corresponding to
	// approximately 67%, 95%, or 99% confidence intervals.
	// numSubsetEntries specifies number of items from {0, 1, ..., get_num_retained()}
	// over which to estimate the bound.
	UpperBoundFromSubset(numStdDevs uint8, numSubsetEntries uint32) (float64, error)

	// UpperBound returns the approximate upper error bound for the given
	// number of standard deviations. numStdDevs should be 1, 2, or 3 for
	// approximately 67%, 95%, or 99% confidence intervals.
	UpperBound(numStdDevs uint8) (float64, error)

	// IsEstimationMode reports whether the sketch is in estimation mode,
	// as opposed to exact mode.
	IsEstimationMode() bool

	// Theta returns theta as a fraction from 0 to 1, representing the
	// effective sampling rate.
	Theta() float64

	// Theta64 returns theta as a positive integer between 0 and math.MaxUint64.
	Theta64() uint64

	// NumRetained returns the number of hashes retained in the sketch.
	NumRetained() uint32

	// SeedHash returns the hash of the seed used to hash the input.
	SeedHash() (uint16, error)

	// IsOrdered reports whether retained hashes are sorted by hash value.
	IsOrdered() bool

	// String returns a human-readable summary of this sketch.
	// If printItems is true, the output includes all retained hashes.
	String(shouldPrintItems bool) string

	// All returns an iterator over all hash-summary pairs in the sketch.
	All() iter.Seq2[uint64, S]
}

type Summary interface {
	// Reset clears the content of the summary, restoring it to its initial state.
	Reset()
	// Clone creates and returns a deep copy of the current Summary instance.
	Clone() Summary
}

type SummaryReader[S Summary] func(r io.Reader) (S, error)

type SummaryWriter[S Summary] func(w io.Writer, s S) error

type Union[S Summary] struct {
	// contains filtered or unexported fields
}

type UnionOptionFunc func(*unionOptions)

type UpdatableSummary[V any] interface {
	Summary

	// Update incorporates a new value into the summary, modifying its internal state based on the given input value.
	Update(value V)
}

type UpdateSketch[S UpdatableSummary[V], V any] struct {
	// contains filtered or unexported fields
}

type UpdateSketchOptionFunc func(*updateSketchOptions)