Struct QueryCounters 

pub struct QueryCounters {
    pub nodes_visited: u64,
    pub approx_distances: u64,
    pub exact_distances: u64,
    pub seeks: u64,
    pub bytes_read: u64,
    pub sequential_runs: u64,
}

Physical counters accumulated by a single query as it executes.

These are the quantities the engine actually measures and the quantities the storage-aware claims are stated in terms of. A hops-only view records only nodes_visited; the storage-access terms (seeks, bytes_read, sequential_runs) are exactly what that view omits.

Fields

nodes_visited: u64

Nodes popped from the candidate queue (graph hops). Drives traversal cost.

approx_distances: u64

Approximate (PQ/ADC) distances computed.

exact_distances: u64

Exact (full SIMD) distances computed on fetched vectors.

seeks: u64

Physical positioning operations (seeks) issued to storage.

bytes_read: u64

Total bytes read from storage.

sequential_runs: u64

Number of coalesced sequential runs the reads collapsed into.

With perfect demand paging this equals seeks; with elevator scheduling and graph-aware layout it can be far smaller, which is the effect the scheduler is meant to produce.

Implementations

impl QueryCounters

pub const fn new() -> Self

A zeroed counter set.

pub fn visit_node(&mut self)

Record a node pop (one graph hop).

pub fn add_approx(&mut self, n: u64)

Record n approximate distance computations.

pub fn add_exact(&mut self, n: u64)

Record n exact distance computations.

pub fn add_read(&mut self, bytes: u64, seeks: u64, runs: u64)

Record a physical read of bytes that required seeks positioning operations and collapsed into runs sequential runs.

pub fn merge(&mut self, other: &QueryCounters)

Merge another counter set into this one (e.g. across parallel workers).

Trait Implementations

impl Clone for QueryCounters

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for QueryCounters

impl Debug for QueryCounters

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

Formats the value using the given formatter.

impl Default for QueryCounters

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for QueryCounters

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for QueryCounters

impl PartialEq for QueryCounters

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for QueryCounters

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for QueryCounters