Struct ml_rust_cuda::learning::instance::Instance

pub struct Instance { /* fields omitted */ }

Implementations

impl Instance

pub fn new(instances: Vec<f32>) -> Self

pub fn from_vector(feature_vec: Vector) -> Self

pub fn normalize(&mut self)

Mutates the feature vector of the instance such that all features are normalized to have a zero mean and unit standard deviation.

Examples

use ml_rust_cuda::{
  learning::Instance,
  math::f32_eq
};

let mut x = Instance::new(vec![9_f32, 5_f32, 8_f32, 3_f32, 4_f32, 0_f32]);
x.normalize();

println!("{}", x);

pub fn distance(lhs1: &Instance, lhs2: &Instance, p: f32) -> f32

Returns the Lp-distance between two instances (i.e. the p-norm of the difference between the two vectors representing those instances).

Arguments

• p - A positive 32-bit float.

Examples

use ml_rust_cuda::{
  learning::Instance,
  math::f32_eq
};

let x1 = Instance::new(vec![9_f32, 5_f32, 8_f32, 3_f32, 4_f32, 0_f32]);
let x2 = Instance::new(vec![3_f32, 8_f32, 1_f32, 2_f32, 3_f32, 1_f32]);

let dist_1 = Instance::distance(&x1, &x2, 1_f32);
let dist_2 = Instance::distance(&x1, &x2, 2_f32);
let dist_3 = Instance::distance(&x1, &x2, 3_f32);

assert!(f32_eq(dist_1, 19_f32));
assert!(f32_eq(dist_2, 97_f32.sqrt()));
assert!(f32_eq(dist_3, 589_f32.cbrt()));

Panics

Panics if p is less than or equal to 0, or if the number of attributes in both instances is not equal.

Trait Implementations

impl Clone for Instance

fn clone(&self) -> Instance

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Instance

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

Formats the value using the given formatter.

impl Display for Instance

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

See Vector.

impl PartialEq<Instance> for Instance

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

See Vector.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.