Struct TilePipelineRegressionSample

Source

pub struct TilePipelineRegressionSample {Show 47 fields
    pub sample_index: usize,
    pub sample_image: String,
    pub fps: f64,
    pub zoom_level: u8,
    pub zoom_pct: u8,
    pub pitch_deg: f64,
    pub yaw_deg: f64,
    pub distance_m: f64,
    pub center_lat: f64,
    pub center_lon: f64,
    pub viewport_width_km: f64,
    pub mercator_world_width_km: f64,
    pub full_world_x: bool,
    pub layer_name: String,
    pub desired_tiles: usize,
    pub raw_candidate_tiles: usize,
    pub loaded_tiles: usize,
    pub visible_tiles: usize,
    pub exact_visible_tiles: usize,
    pub fallback_visible_tiles: usize,
    pub missing_visible_tiles: usize,
    pub overzoomed_visible_tiles: usize,
    pub requested_tiles: usize,
    pub exact_cache_hits: usize,
    pub cache_misses: usize,
    pub cancelled_stale_pending: usize,
    pub budget_hit: bool,
    pub dropped_by_budget: usize,
    pub cache_total_entries: usize,
    pub cache_loaded_entries: usize,
    pub cache_expired_entries: usize,
    pub cache_reloading_entries: usize,
    pub cache_pending_entries: usize,
    pub cache_failed_entries: usize,
    pub cache_renderable_entries: usize,
    pub queued_requests: usize,
    pub in_flight_requests: usize,
    pub max_concurrent_requests: usize,
    pub known_requests: usize,
    pub cancelled_in_flight_requests: usize,
    pub counter_frames: u64,
    pub counter_requested_tiles: u64,
    pub counter_exact_cache_hits: u64,
    pub counter_fallback_hits: u64,
    pub counter_cache_misses: u64,
    pub counter_cancelled_stale_pending: u64,
    pub counter_cancelled_evicted_pending: u64,
}

Expand description

One machine-comparable tile-pipeline telemetry sample.

Fields§

§sample_index: usize

Sequential sample identifier.

§sample_image: String

Optional image or frame label associated with the sample.

§fps: f64

Frames-per-second recorded for the sample.

§zoom_level: u8

Integer zoom level used for tile selection.

§zoom_pct: u8

Fractional zoom remainder expressed as a percentage in [0, 100].

§pitch_deg: f64

Camera pitch in degrees.

§yaw_deg: f64

Camera yaw / bearing in degrees.

§distance_m: f64

Camera distance from the target in meters.

§center_lat: f64

Camera target latitude in degrees.

§center_lon: f64

Camera target longitude in degrees.

§viewport_width_km: f64

Width of the current viewport footprint in Mercator kilometers.

§mercator_world_width_km: f64

Total Web Mercator world width in kilometers.

§full_world_x: bool

Whether the viewport spans the full wrapped world width.

§layer_name: String

Name of the tile layer that produced the sample.

§desired_tiles: usize

Number of desired source tiles considered for the current view.

§raw_candidate_tiles: usize

Number of raw selection candidates before budget capping.

§loaded_tiles: usize

Number of visible tiles with imagery currently loaded.

§visible_tiles: usize

Number of visible tiles emitted for the frame.

§exact_visible_tiles: usize

Number of exact visible tiles.

§fallback_visible_tiles: usize

Number of visible tiles rendered via fallback imagery.

§missing_visible_tiles: usize

Number of visible tiles still missing imagery.

§overzoomed_visible_tiles: usize

Number of visible overzoomed tiles.

§requested_tiles: usize

Number of requests issued in the current frame.

§exact_cache_hits: usize

Number of exact cache hits in the current frame.

§cache_misses: usize

Number of cache misses in the current frame.

§cancelled_stale_pending: usize

Number of stale pending requests cancelled in the current frame.

§budget_hit: bool

Whether the visible-tile budget was hit this frame.

§dropped_by_budget: usize

Number of candidate tiles dropped by the visible budget.

§cache_total_entries: usize

Total number of cache entries.

§cache_loaded_entries: usize

Number of loaded cache entries.

§cache_expired_entries: usize

Number of expired cache entries.

§cache_reloading_entries: usize

Number of reloading cache entries.

§cache_pending_entries: usize

Number of pending cache entries.

§cache_failed_entries: usize

Number of failed cache entries.

§cache_renderable_entries: usize

Number of renderable cache entries.

§queued_requests: usize

Number of queued source requests.

§in_flight_requests: usize

Number of in-flight source requests.

§max_concurrent_requests: usize

Maximum allowed concurrent source requests.

§known_requests: usize

Number of transport-known requests.

§cancelled_in_flight_requests: usize

Number of forced cancellations for already in-flight requests.

§counter_frames: u64

Cumulative frame count.

§counter_requested_tiles: u64

Cumulative requested tile count.

§counter_exact_cache_hits: u64

Cumulative exact cache hits.

§counter_fallback_hits: u64

Cumulative fallback hits.

§counter_cache_misses: u64

Cumulative cache misses.

§counter_cancelled_stale_pending: u64

Cumulative stale cancellations.

§counter_cancelled_evicted_pending: u64

Cumulative evicted-pending cancellations.

Implementations§

Source §

impl TilePipelineRegressionSample

Source

pub fn capture_from_map_state( state: &MapState, sample_index: usize, sample_image: impl Into<String>, fps: f64, ) -> Option<Self>

Capture a regression sample from the first visible tile layer in state.

Returns None when no visible tile layer is active or the map has not yet produced tile-pipeline diagnostics.

Source

pub fn parse_csv( input: &str, ) -> Result<Vec<Self>, TilePipelineRegressionParseError>

Parse a sequence of samples from CSV text.

This accepts both the reduced harness schema emitted by to_csv and the checked-in docs/debug/rustial_debug_values.csv fixture. When the fixture is parsed, selected_tiles is mapped into desired_tiles.

Source