Struct ScalarField2D 

pub struct ScalarField2D {
    pub rows: usize,
    pub cols: usize,
    pub data: Vec<f32>,
    pub min: f32,
    pub max: f32,
    pub nan_value: Option<f32>,
    pub generation: u64,
    pub value_generation: u64,
}

A 2D scalar field aligned to a GeoGrid.

Values are stored row-major. Each cell stores a single f32 value. The field tracks two generation counters:

• generation – bumped when the grid topology changes (rows, cols).
• value_generation – bumped when only values change (same topology).

Renderers use these to choose between a full mesh rebuild and a texture-only upload.

Fields

rows: usize

Number of rows.

cols: usize

Number of columns.

data: Vec<f32>

Row-major scalar values. Length must equal rows * cols.

min: f32

Minimum value in the field (user-provided or computed).

max: f32

Maximum value in the field (user-provided or computed).

nan_value: Option<f32>

Optional sentinel value treated as missing data / NaN.

generation: u64

Structural generation counter. Bump when rows/cols change.

value_generation: u64

Value-only generation counter. Bump when values change but topology is unchanged.

Implementations

impl ScalarField2D

pub fn from_data(rows: usize, cols: usize, data: Vec<f32>) -> Self

Create a field from raw data with automatic min/max computation.

nan_value samples are excluded from the min/max scan.

pub fn from_data_with_range( rows: usize, cols: usize, data: Vec<f32>, min: f32, max: f32, ) -> Self

Create a field with an explicit min/max range.

pub fn sample(&self, row: usize, col: usize) -> Option<f32>

Sample the raw value at (row, col).

Returns None if out of bounds or if the value matches nan_value.

pub fn normalized(&self, row: usize, col: usize) -> Option<f32>

Sample the value at (row, col) normalized to [0.0, 1.0] using the field min / max range.

Returns None if the sample is missing or if min == max.

pub fn update_values(&mut self, new_data: Vec<f32>)

Replace values in place, bump value_generation, and recompute min/max.

Panics if new_data.len() != rows * cols.

Trait Implementations

impl Clone for ScalarField2D

fn clone(&self) -> ScalarField2D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScalarField2D

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

Formats the value using the given formatter.