Skip to content

LabelEncoder

The LabelEncoder encodes one or more given columns into labels.

Parent type: InvertibleTableTransformer

Parameters:

Name Type Description Default
selector union<List<String>, String?> The list of columns used to fit the transformer. If None, all non-numeric columns are used. null
partialOrder List<Any?> The partial order of the labels. The labels are encoded in the order of the given list. Additional values are assigned labels in the order they are encountered during fitting. []

Examples:

pipeline example {
   val table = Table({"a": ["z", "y"], "b": [3, 4]});
   val encoder = LabelEncoder(selector = "a").fit(table);
   val transformedTable = encoder.transform(table);
   // Table({"a": [1, 0], "b": [3, 4]})
   val originalTable = encoder.inverseTransform(transformedTable);
   // Table({"a": ["z", "y"], "b": [3, 4]})
}
Stub code in LabelEncoder.sdsstub

class LabelEncoder(
    selector: union<List<String>, String, Nothing?> = null,
    @PythonName("partial_order") partialOrder: List<Any?> = []
) sub InvertibleTableTransformer {
    /**
     * The partial order of the labels.
     */
    @PythonName("partial_order") attr partialOrder: List<Any>

    /**
     * Learn a transformation for a set of columns in a table.
     *
     * This transformer is not modified.
     *
     * @param table The table used to fit the transformer.
     *
     * @result fittedTransformer The fitted transformer.
     */
    @Pure
    fun fit(
        table: Table
    ) -> fittedTransformer: LabelEncoder

    /**
     * Learn a transformation for a set of columns in a table and apply the learned transformation to the same table.
     *
     * **Note:** Neither this transformer nor the given table are modified.
     *
     * @param table The table used to fit the transformer. The transformer is then applied to this table.
     *
     * @result fittedTransformer The fitted transformer.
     * @result transformedTable The transformed table.
     */
    @Pure
    @PythonName("fit_and_transform")
    fun fitAndTransform(
        table: Table
    ) -> (fittedTransformer: LabelEncoder, transformedTable: Table)
}

isFitted

Whether the transformer is fitted.

Type: Boolean

partialOrder

The partial order of the labels.

Type: List<Any>

fit

Learn a transformation for a set of columns in a table.

This transformer is not modified.

Parameters:

Name Type Description Default
table Table The table used to fit the transformer. -

Results:

Name Type Description
fittedTransformer LabelEncoder The fitted transformer.
Stub code in LabelEncoder.sdsstub

@Pure
fun fit(
    table: Table
) -> fittedTransformer: LabelEncoder

fitAndTransform

Learn a transformation for a set of columns in a table and apply the learned transformation to the same table.

Note: Neither this transformer nor the given table are modified.

Parameters:

Name Type Description Default
table Table The table used to fit the transformer. The transformer is then applied to this table. -

Results:

Name Type Description
fittedTransformer LabelEncoder The fitted transformer.
transformedTable Table The transformed table.
Stub code in LabelEncoder.sdsstub

@Pure
@PythonName("fit_and_transform")
fun fitAndTransform(
    table: Table
) -> (fittedTransformer: LabelEncoder, transformedTable: Table)

inverseTransform

Undo the learned transformation as well as possible.

Column order and types may differ from the original table. Likewise, some values might not be restored.

Note: The given table is not modified.

Parameters:

Name Type Description Default
transformedTable Table The table to be transformed back to the original version. -

Results:

Name Type Description
originalTable Table The original table.
Stub code in InvertibleTableTransformer.sdsstub

@Pure
@PythonName("inverse_transform")
fun inverseTransform(
    @PythonName("transformed_table") transformedTable: Table
) -> originalTable: Table

transform

Apply the learned transformation to a table.

Note: The given table is not modified.

Parameters:

Name Type Description Default
table Table The table to which the learned transformation is applied. -

Results:

Name Type Description
transformedTable Table The transformed table.
Stub code in TableTransformer.sdsstub

@Pure
fun transform(
    table: Table
) -> transformedTable: Table