pola-rs/polars · error

`{}` operation not supported for dtype `{}`

Error message

`{}` operation not supported for dtype `{}`

What it means

The invalid_operation_panic! macro in Series is the generic guard used by numeric accessors (e.g. self.f64(), self.i32()): when code asks a Series for a chunked array of a dtype it does not have (or the operation has no impl for that dtype) it panics naming the operation and dtype. Indicates a dtype/operation mismatch, usually from assuming a column's physical dtype.

Source

Thrown at crates/polars-core/src/series/mod.rs:10

#![allow(unsafe_op_in_unsafe_fn)]
//! Type agnostic columnar data structure.
use crate::chunked_array::flags::StatisticsFlags;
pub use crate::prelude::ChunkCompareEq;
use crate::prelude::*;
use crate::{HEAD_DEFAULT_LENGTH, TAIL_DEFAULT_LENGTH};

macro_rules! invalid_operation_panic {
    ($op:ident, $s:expr) => {
        panic!(
            "`{}` operation not supported for dtype `{}`",
            stringify!($op),
            $s._dtype()
        )
    };
}

pub mod amortized_iter;
mod any_value;
pub mod arithmetic;
pub mod arrow_export;
pub mod builder;

mod comparison;
mod from;
pub mod implementations;
pub(crate) mod iterator;
pub mod ops;

View on GitHub (pinned to 68506541d2)

Solutions

1. The operation is not supported for this dtype; cast the series to a supported dtype first.
2. Check the operation's documentation for supported dtypes and convert accordingly.

When it happens

Trigger: This panic/expect fires when execution reaches an unguarded state described by: "`{}` operation not supported for dtype `{}`". Typical triggers: unsupported dtype or feature-gated code path reached at runtime, invalid user input or environment variable value, calling API methods in the wrong order or on mismatched types, or data (lengths, offsets, ranges) violating the function's preconditions.

Common situations: Encountered when input data or configuration does not meet the preconditions of the throwing code path ("`{}` operation not supported for dtype `{}`"). Common cases: missing Cargo feature flags, mismatched dtypes/lengths between arrays or series, out-of-range temporal values, malformed environment variables, or operations on unsupported/complex nested types.

AI-assisted analysis of pola-rs/polars@68506541d2 (2026-08-19). Data as JSON: /api/errors/30593beaa95d4f8b. Report an issue: GitHub.