Class BaseNEncoder<T>

Namespace

AiDotNet.Preprocessing.Encoders

Assembly

AiDotNet.dll

Encodes categorical features using base-N representation.

public class BaseNEncoder<T> : TransformerBase<T, Matrix<T>, Matrix<T>>, IDataTransformer<T, Matrix<T>, Matrix<T>>

Type Parameters

T

The numeric type for calculations (e.g., float, double).

Inheritance

object

TransformerBase<T, Matrix<T>, Matrix<T>>

BaseNEncoder<T>

Implements

IDataTransformer<T, Matrix<T>, Matrix<T>>

Inherited Members

TransformerBase<T, Matrix<T>, Matrix<T>>.NumOps

TransformerBase<T, Matrix<T>, Matrix<T>>.Engine

TransformerBase<T, Matrix<T>, Matrix<T>>.IsFitted

TransformerBase<T, Matrix<T>, Matrix<T>>.ColumnIndices

TransformerBase<T, Matrix<T>, Matrix<T>>.SupportsInverseTransform

TransformerBase<T, Matrix<T>, Matrix<T>>.Fit(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.Transform(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.FitTransform(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.InverseTransform(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.GetFeatureNamesOut(string[])

TransformerBase<T, Matrix<T>, Matrix<T>>.FitCore(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.TransformCore(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.InverseTransformCore(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.ValidateInputData(Matrix<T>)

TransformerBase<T, Matrix<T>, Matrix<T>>.EnsureFitted()

TransformerBase<T, Matrix<T>, Matrix<T>>.GetColumnsToProcess(int)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

BaseNEncoder converts category indices to base-N representation, creating multiple columns with digits in the specified base. This is a generalization of binary encoding (base 2).

For example, with base=3 and 9 categories (0-8): - Category 0 → [0, 0] - Category 4 → [1, 1] (4 = 1*3 + 1) - Category 8 → [2, 2] (8 = 2*3 + 2)

For Beginners: BaseNEncoder is like counting in different number systems: - Base 2 (binary): Uses 0 and 1 → most compact - Base 3 (ternary): Uses 0, 1, 2 → slightly more columns - Higher bases = fewer columns but more possible values per column

Constructors

BaseNEncoder(int, BaseNHandleUnknown, int[]?)

Creates a new instance of BaseNEncoder<T>.

public BaseNEncoder(int base_ = 2, BaseNHandleUnknown handleUnknown = BaseNHandleUnknown.UseZeros, int[]? columnIndices = null)

Parameters

base_ int

The base to use for encoding. Defaults to 2 (binary).

handleUnknown BaseNHandleUnknown

How to handle unknown categories. Defaults to UseZeros.

columnIndices int[]

The column indices to encode, or null for all columns.

Properties

Base

Gets the base used for encoding.

public int Base { get; }

Property Value

int

HandleUnknown

Gets how unknown categories are handled.

public BaseNHandleUnknown HandleUnknown { get; }

Property Value

BaseNHandleUnknown

NOutputFeatures

Gets the number of output features.

public int NOutputFeatures { get; }

Property Value

int

SupportsInverseTransform

Gets whether this transformer supports inverse transformation.

public override bool SupportsInverseTransform { get; }

Property Value

bool

Methods

FitCore(Matrix<T>)

Fits the encoder by learning categories.

protected override void FitCore(Matrix<T> data)

Parameters

data Matrix<T>

GetFeatureNamesOut(string[]?)

Gets the output feature names after transformation.

public override string[] GetFeatureNamesOut(string[]? inputFeatureNames = null)

Parameters

inputFeatureNames string[]

Returns

string[]

InverseTransformCore(Matrix<T>)

Inverse transformation is not supported.

protected override Matrix<T> InverseTransformCore(Matrix<T> data)

Parameters

data Matrix<T>

Returns

Matrix<T>

TransformCore(Matrix<T>)

Transforms the data using base-N encoding.

protected override Matrix<T> TransformCore(Matrix<T> data)

Parameters

data Matrix<T>

Returns

Matrix<T>