Skip to main content

Sampled

Struct Sampled 

Source
pub struct Sampled { /* private fields */ }
Expand description

Encode every candidate on a sample, then encode only the winner on the whole chunk.

The bet is that a chunk of 122,880 values and a sample of 8,192 drawn from it agree about which encoding suits them, which is a bet about the data and is what the ablation settles. Where it is wrong the cost is size and never correctness, because the winner still has to apply to the whole chunk and is still encoded over all of it.

The sample is windows of consecutive values rather than values picked one at a time, because three of the candidates are about what a value has in common with the value before it. A sample of scattered singletons would show FRONT and RLE nothing to find and would rule them out on every column, which is the wrong answer arrived at quickly.

There are two guards on whether to sample at all and both of them are there because a measurement said so. A chunk with fewer values than the sample is not sampled, because encoding every candidate on something the size of the chunk and then encoding the winner on the chunk is more work than the exhaustive chooser for the same answer. A chunk holding less than a page of bytes is not sampled either, because the cost of the search scales with the bytes in the chunk and not with how many values they are spread over, so on a narrow column there is nothing to save and a sample that misses the structure gives up real size for it.

Implementations§

Source§

impl Sampled

Source

pub fn new() -> Self

The default sample, which is eight windows of 1,024 values.

Source

pub fn over(window: usize, regions: usize) -> Self

A sample of a size somebody else picked, which is what the ablation sweeps.

Source

pub fn size(self) -> usize

How many values the sample holds, which is one of the two things that decide whether sampling is worth doing.

Trait Implementations§

Source§

impl Chooser for Sampled

Source§

fn name(&self) -> &'static str

The name that goes in a report.
Source§

fn narrow_strings( &self, values: &[&[u8]], offered: &[Kind], depth: u8, ) -> Vec<Kind>

Which of offered to encode in full, for a chunk of strings at depth. Read more
Source§

fn narrow_integers( &self, values: &[i64], offered: &[Kind], depth: u8, ) -> Vec<Kind>

Which of offered to encode in full, for a chunk of integers at depth.
Source§

impl Clone for Sampled

Source§

fn clone(&self) -> Sampled

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for Sampled

Source§

impl Debug for Sampled

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for Sampled

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.