Struct Normalizer 

pub struct Normalizer<F> { /* private fields */ }

A stateless row-wise normalizer.

Each sample (row) is independently scaled so that its chosen norm equals 1. Samples with a zero norm are left unchanged.

This transformer is stateless — no Fit step is needed. Call Transform::transform directly.

Examples

use ferrolearn_preprocess::normalizer::{Normalizer, NormType};
use ferrolearn_core::traits::Transform;
use ndarray::array;

let normalizer = Normalizer::<f64>::new(NormType::L2);
let x = array![[3.0, 4.0], [1.0, 0.0]];
let out = normalizer.transform(&x).unwrap();
// Row 0: [3/5, 4/5], Row 1: [1.0, 0.0]

Implementations

impl<F: Float + Send + Sync + 'static> Normalizer<F>

pub fn new(norm: NormType) -> Self

Create a new Normalizer with the specified norm type.

pub fn l2() -> Self

Create a new Normalizer using the default L2 norm.

pub fn l1() -> Self

Create a new Normalizer using the L1 norm.

pub fn max() -> Self

Create a new Normalizer using the Max norm.

pub fn norm(&self) -> NormType

Return the configured norm type.

Trait Implementations

impl<F: Clone> Clone for Normalizer<F>

fn clone(&self) -> Normalizer<F>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F: Debug> Debug for Normalizer<F>

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

Formats the value using the given formatter.

impl<F: Float + Send + Sync + 'static> Default for Normalizer<F>

fn default() -> Self

Returns the “default value” for a type.

impl FittedPipelineTransformer for Normalizer<f64>

fn transform_pipeline(&self, x: &Array2<f64>) -> Result<Array2<f64>, FerroError>

Transform data using the pipeline interface.

Errors

Propagates errors from Transform::transform.

impl PipelineTransformer for Normalizer<f64>

fn fit_pipeline( &self, _x: &Array2<f64>, _y: &Array1<f64>, ) -> Result<Box<dyn FittedPipelineTransformer>, FerroError>

Fit the normalizer using the pipeline interface.

Because Normalizer is stateless, this simply boxes self as a FittedPipelineTransformer.

Errors

This implementation never returns an error.

impl<F: Float + Send + Sync + 'static> Transform<ArrayBase<OwnedRepr<F>, Dim<[usize; 2]>>> for Normalizer<F>

fn transform(&self, x: &Array2<F>) -> Result<Array2<F>, FerroError>

Normalize each row of x to unit norm.

Rows with a zero norm value are left unchanged.

Errors

This implementation never returns an error for well-formed inputs, but returns Ok(...) to satisfy the trait contract.

type Output = ArrayBase<OwnedRepr<F>, Dim<[usize; 2]>>

The transformed output type.

type Error = FerroError

The error type returned by transform.