Struct RowId 

pub struct RowId(/* private fields */);

A unique ID for a row’s worth of data within a chunk.

There is no relationship whatsoever between a ChunkId and the RowIds within that chunk.

String format

Example: row_182342300C5F8C327a7b4a6e5a379ac4. The “row_” prefix is optional when parsing. See re_tuid docs for explanations of TUID namespaces.

Uniqueness

Duplicated RowIds within a single recording is considered undefined behavior.

While it is benign in most cases, care has to be taken when manually crafting RowIds. Ideally: don’t do so and stick to RowId::new instead to avoid bad surprises.

This makes it easy to build and maintain secondary indices around RowIds with few to no extraneous state tracking.

Query

Queries (both latest-at & range semantics) will defer to RowId order as a tie-breaker when looking at several rows worth of data that rest at the exact same timestamp.

In pseudo-code:

rr.set_time("frame", sequence=10)

rr.log("my_entity", point1, row_id=#1)
rr.log("my_entity", point2, row_id=#0)

rr.query("my_entity", at=("frame", 10))  # returns `point1`

Think carefully about your RowIds when logging a lot of data at the same timestamp.

Garbage collection

Garbage collection is handled at the chunk level by first ordering the chunks based on the minimum RowId present in each of them. Garbage collection therefore happens (roughly) in the logger’s wall-clock order.

This has very important implications when inserting data far into the past or into the future: think carefully about your RowIds in these cases.

Implementations

impl RowId

pub const ZERO: RowId

pub const MAX: RowId

pub fn new() -> RowId

Create a new unique RowId based on the current time.

pub fn from_tuid(tuid: Tuid) -> RowId

pub fn as_tuid(&self) -> Tuid

pub fn next(&self) -> RowId

Returns the next logical RowId.

Beware: wrong usage can easily lead to conflicts. Prefer RowId::new when unsure.

pub fn incremented_by(&self, n: u64) -> RowId

Returns the n-next logical RowId.

This is equivalent to calling RowId::next n times. Wraps the monotonically increasing back to zero on overflow.

Beware: wrong usage can easily lead to conflicts. Prefer RowId::new when unsure.

pub fn from_u128(id: u128) -> RowId

pub fn arrow_from_slice(slice: &[RowId]) -> FixedSizeBinaryArray

pub fn slice_from_arrow(array: &FixedSizeBinaryArray) -> &[RowId]

Panics if the array is of the wrong width

impl RowId

pub fn partial_descriptor() -> ComponentDescriptor

Methods from Deref<Target = Tuid>

pub const ARROW_EXTENSION_NAME: &'static str = "rerun.datatypes.TUID"

pub const ZERO: Tuid

pub const MAX: Tuid

pub fn as_u128(&self) -> u128

pub fn as_bytes(&self) -> [u8; 16]

Returns most significant byte first (big endian).

pub fn nanos_since_epoch(&self) -> u64

Approximate nanoseconds since unix epoch.

The upper 64 bits of the Tuid.

pub fn inc(&self) -> u64

The increment part of the Tuid.

The lower 64 bits of the Tuid.

pub fn next(&self) -> Tuid

Returns the next logical Tuid.

Wraps the monotonically increasing back to zero on overflow.

Beware: wrong usage can easily lead to conflicts. Prefer Tuid::new when unsure.

pub fn incremented_by(&self, n: u64) -> Tuid

Returns the n-next logical Tuid.

This is equivalent to calling Tuid::next n times. Wraps the monotonically increasing back to zero on overflow.

Beware: wrong usage can easily lead to conflicts. Prefer Tuid::new when unsure.

pub fn short_string(&self) -> String

A shortened string representation of the Tuid.

Trait Implementations

impl Clone for RowId

fn clone(&self) -> RowId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for RowId

fn name() -> ComponentType

The fully-qualified type of this component, e.g. rerun.components.Position2D.

impl Debug for RowId

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

Formats the value using the given formatter.

impl Deref for RowId

type Target = Tuid

The resulting type after dereferencing.

fn deref(&self) -> &<RowId as Deref>::Target

Dereferences the value.

impl DerefMut for RowId

fn deref_mut(&mut self) -> &mut <RowId as Deref>::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for RowId

fn deserialize<__D>( __deserializer: __D, ) -> Result<RowId, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RowId

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

Formats the value using the given formatter.

impl FromStr for RowId

type Err = InvalidRowIdError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<RowId, <RowId as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for RowId

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Loggable for RowId

fn arrow_datatype() -> DataType

The underlying arrow::datatypes::DataType, excluding datatype extensions.

fn to_arrow_opt<'a>( _values: impl IntoIterator<Item = Option<impl Into<Cow<'a, RowId>>>>, ) -> Result<Arc<dyn Array>, SerializationError>

where RowId: 'a,

Given an iterator of options of owned or reference values to the current Loggable, serializes them into an Arrow array.

fn to_arrow<'a>( values: impl IntoIterator<Item = impl Into<Cow<'a, RowId>>>, ) -> Result<Arc<dyn Array>, SerializationError>

Given an iterator of owned or reference values to the current Loggable, serializes them into an Arrow array.

fn from_arrow(array: &dyn Array) -> Result<Vec<RowId>, DeserializationError>

Given an Arrow array, deserializes it into a collection of Loggables.

fn arrow_empty() -> Arc<dyn Array>

fn from_arrow_opt( data: &dyn Array, ) -> Result<Vec<Option<Self>>, DeserializationError>

Given an Arrow array, deserializes it into a collection of optional Loggables.

fn verify_arrow_array(data: &dyn Array) -> Result<(), DeserializationError>

Verifies that the given Arrow array can be deserialized into a collection of Selfs.

impl Ord for RowId

fn cmp(&self, other: &RowId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for RowId

fn eq(&self, other: &RowId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for RowId

fn partial_cmp(&self, other: &RowId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for RowId

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SizeBytes for RowId

fn heap_size_bytes(&self) -> u64

Returns how many bytes self uses on the heap.

fn is_pod() -> bool

Is Self just plain old data?

fn total_size_bytes(&self) -> u64

Returns the total size of self in bytes, accounting for both stack and heap space.

fn stack_size_bytes(&self) -> u64

Returns the total size of self on the stack, in bytes.

impl Zeroable for RowId

fn zeroed() -> Self

Calls zeroed.

impl AnyBitPattern for RowId

impl Copy for RowId

impl Eq for RowId

impl NoUninit for RowId

impl StructuralPartialEq for RowId