Skip to content

category_encoders/ordinal-mapping-unknown

Rule ordinal-mapping-unknown
Pack Category Encoders
Severity warning
Fix none, edit by hand
Library versions every version

With a mapping and no handle_unknown, a category the mapping does not name is coded -1 without a warning. Pass handle_unknown="error" or the value you want.

encoder = ce.OrdinalEncoder(cols=["size"], mapping=[{"col": "size", "mapping": {"small": 1, "medium": 2}}])
encoder = ce.OrdinalEncoder(
cols=["size"],
mapping=[{"col": "size", "mapping": {"small": 1, "medium": 2, "large": 3}}],
handle_unknown="error",
)

The rule reports OrdinalEncoder(mapping=...) without handle_unknown. A category that the mapping doesn't name is then coded -1, with no error and no warning.

xpd has no automatic fix, so make the change by hand.

{"a": 1, "b": 2} on the column a, b, c Result
without handle_unknown 1.0, 2.0, -1.0
with handle_unknown="error" ValueError: Unexpected categories found in column c at fit

A key with a typing error, or a category that appears later, reaches the model as -1, which is below every code that the mapping gives. Whether the mapping names every category can't be read from the code, so the rule is info. A call that states handle_unknown, with any value, is left alone.

xpd prints this message with the issue. A name that starts with $ stands for code from your file.

A category that the mapping does not name is coded -1 in silence, as c was when the mapping named only a and b. Pass handle_unknown="error" to raise on such a category, or state the handle_unknown you want.

Browse the other rules of the Category Encoders pack.