Struct CategoricalChunked

pub struct CategoricalChunked { /* private fields */ }

Implementations

impl CategoricalChunked

pub fn sort_with(&self, options: SortOptions) -> CategoricalChunked

Available on crate feature dtype-categorical only.

pub fn sort(&self, descending: bool) -> CategoricalChunked

Available on crate feature dtype-categorical only.

Returned a sorted ChunkedArray.

pub fn arg_sort(&self, options: SortOptions) -> ChunkedArray<UInt32Type>

Available on crate feature dtype-categorical only.

Retrieve the indexes needed to sort this array.

impl CategoricalChunked

pub unsafe fn from_global_indices_unchecked( cats: ChunkedArray<UInt32Type>, ordering: CategoricalOrdering, ) -> CategoricalChunked

Available on crate feature dtype-categorical only.

Create a CategoricalChunked from a categorical indices. The indices will probe the global string cache.

Safety

This does not do any bound checks

pub fn from_string_to_enum( values: &ChunkedArray<StringType>, categories: &BinaryViewArrayGeneric<str>, ordering: CategoricalOrdering, ) -> Result<CategoricalChunked, PolarsError>

Available on crate feature dtype-categorical only.

Create a CategoricalChunked from a fixed list of categories and a List of strings. This will error if a string is not in the fixed list of categories

impl CategoricalChunked

pub fn to_arrow( &self, compat_level: CompatLevel, as_i64: bool, ) -> Box<dyn Array>

Available on crate feature dtype-categorical only.

impl CategoricalChunked

pub fn append(&mut self, other: &CategoricalChunked) -> Result<(), PolarsError>

Available on crate feature dtype-categorical only.

impl CategoricalChunked

pub fn full_null( name: PlSmallStr, is_enum: bool, length: usize, ordering: CategoricalOrdering, ) -> CategoricalChunked

Available on crate feature dtype-categorical only.

impl CategoricalChunked

pub fn unique(&self) -> Result<CategoricalChunked, PolarsError>

Available on crate feature dtype-categorical only.

pub fn n_unique(&self) -> Result<usize, PolarsError>

Available on crate feature dtype-categorical only.

pub fn value_counts(&self) -> Result<DataFrame, PolarsError>

Available on crate feature dtype-categorical only.

impl CategoricalChunked

pub fn is_empty(&self) -> bool

Available on crate feature dtype-categorical only.

pub fn len(&self) -> usize

Available on crate feature dtype-categorical only.

pub fn null_count(&self) -> usize

Available on crate feature dtype-categorical only.

pub fn name(&self) -> &PlSmallStr

Available on crate feature dtype-categorical only.

pub fn physical(&self) -> &ChunkedArray<UInt32Type>

Available on crate feature dtype-categorical only.

Get a reference to the physical array (the categories).

pub fn is_enum(&self) -> bool

Available on crate feature dtype-categorical only.

pub fn to_local(&self) -> CategoricalChunked

Available on crate feature dtype-categorical only.

Convert a categorical column to its local representation.

pub fn to_global(&self) -> Result<CategoricalChunked, PolarsError>

Available on crate feature dtype-categorical only.

pub fn to_enum( &self, categories: &BinaryViewArrayGeneric<str>, hash: u128, ) -> CategoricalChunked

Available on crate feature dtype-categorical only.

pub fn uses_lexical_ordering(&self) -> bool

Available on crate feature dtype-categorical only.

Return whether or not the CategoricalChunked uses the lexical order of the string values when sorting.

pub unsafe fn from_cats_and_dtype_unchecked( idx: ChunkedArray<UInt32Type>, dtype: DataType, ) -> CategoricalChunked

Available on crate feature dtype-categorical only.

Create a CategoricalChunked from a physical array and dtype.

Safety

It’s not checked that the indices are in-bounds or that the dtype is correct.

pub unsafe fn from_cats_and_rev_map_unchecked( idx: ChunkedArray<UInt32Type>, rev_map: Arc<RevMapping>, is_enum: bool, ordering: CategoricalOrdering, ) -> CategoricalChunked

Available on crate feature dtype-categorical only.

Create a CategoricalChunked from an array of idx and an existing RevMapping: rev_map.

Safety

Invariant in v < rev_map.len() for v in idx must hold.

pub fn _can_fast_unique(&self) -> bool

Available on crate feature dtype-categorical only.

True if all categories are represented in this array. When this is the case, the unique values of the array are the categories.

pub unsafe fn _with_fast_unique(self, toggle: bool) -> CategoricalChunked

Available on crate feature dtype-categorical only.

Set FAST_UNIQUE metadata

Safety

This invariant must hold unique(categories) == unique(self)

pub fn get_rev_map(&self) -> &Arc<RevMapping>

Available on crate feature dtype-categorical only.

Get a reference to the mapping of categorical types to the string values.

pub fn iter_str(&self) -> CatIter<'_>

Available on crate feature dtype-categorical only.

Create an Iterator that iterates over the &str values of the CategoricalChunked.

Trait Implementations

impl ChunkAggSeries for CategoricalChunked

Available on crate feature dtype-categorical only.

fn min_reduce(&self) -> Scalar

Get the min of the ChunkedArray as a new Series of length 1.

fn max_reduce(&self) -> Scalar

Get the max of the ChunkedArray as a new Series of length 1.

fn sum_reduce(&self) -> Scalar

Get the sum of the ChunkedArray as a new Series of length 1.

fn prod_reduce(&self) -> Scalar

Get the product of the ChunkedArray as a new Series of length 1.

impl ChunkCompareEq<&CategoricalChunked> for CategoricalChunked

type Item = Result<ChunkedArray<BooleanType>, PolarsError>

fn equal( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareEq<&CategoricalChunked>>::Item

Check for equality.

fn equal_missing( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareEq<&CategoricalChunked>>::Item

Check for equality where None == None.

fn not_equal( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareEq<&CategoricalChunked>>::Item

Check for inequality.

fn not_equal_missing( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareEq<&CategoricalChunked>>::Item

Check for inequality where None == None.

impl ChunkCompareEq<&ChunkedArray<StringType>> for CategoricalChunked

type Item = Result<ChunkedArray<BooleanType>, PolarsError>

fn equal( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareEq<&ChunkedArray<StringType>>>::Item

Check for equality.

fn equal_missing( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareEq<&ChunkedArray<StringType>>>::Item

Check for equality where None == None.

fn not_equal( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareEq<&ChunkedArray<StringType>>>::Item

Check for inequality.

fn not_equal_missing( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareEq<&ChunkedArray<StringType>>>::Item

Check for inequality where None == None.

impl ChunkCompareEq<&str> for CategoricalChunked

type Item = Result<ChunkedArray<BooleanType>, PolarsError>

fn equal(&self, rhs: &str) -> <CategoricalChunked as ChunkCompareEq<&str>>::Item

Check for equality.

fn equal_missing( &self, rhs: &str, ) -> <CategoricalChunked as ChunkCompareEq<&str>>::Item

Check for equality where None == None.

fn not_equal( &self, rhs: &str, ) -> <CategoricalChunked as ChunkCompareEq<&str>>::Item

Check for inequality.

fn not_equal_missing( &self, rhs: &str, ) -> <CategoricalChunked as ChunkCompareEq<&str>>::Item

Check for inequality where None == None.

impl ChunkCompareIneq<&CategoricalChunked> for CategoricalChunked

type Item = Result<ChunkedArray<BooleanType>, PolarsError>

fn gt( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareIneq<&CategoricalChunked>>::Item

Greater than comparison.

fn gt_eq( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareIneq<&CategoricalChunked>>::Item

Greater than or equal comparison.

fn lt( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareIneq<&CategoricalChunked>>::Item

Less than comparison.

fn lt_eq( &self, rhs: &CategoricalChunked, ) -> <CategoricalChunked as ChunkCompareIneq<&CategoricalChunked>>::Item

Less than or equal comparison

impl ChunkCompareIneq<&ChunkedArray<StringType>> for CategoricalChunked

type Item = Result<ChunkedArray<BooleanType>, PolarsError>

fn gt( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareIneq<&ChunkedArray<StringType>>>::Item

Greater than comparison.

fn gt_eq( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareIneq<&ChunkedArray<StringType>>>::Item

Greater than or equal comparison.

fn lt( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareIneq<&ChunkedArray<StringType>>>::Item

Less than comparison.

fn lt_eq( &self, rhs: &ChunkedArray<StringType>, ) -> <CategoricalChunked as ChunkCompareIneq<&ChunkedArray<StringType>>>::Item

Less than or equal comparison

impl ChunkCompareIneq<&str> for CategoricalChunked

type Item = Result<ChunkedArray<BooleanType>, PolarsError>

fn gt(&self, rhs: &str) -> <CategoricalChunked as ChunkCompareIneq<&str>>::Item

Greater than comparison.

fn gt_eq( &self, rhs: &str, ) -> <CategoricalChunked as ChunkCompareIneq<&str>>::Item

Greater than or equal comparison.

fn lt(&self, rhs: &str) -> <CategoricalChunked as ChunkCompareIneq<&str>>::Item

Less than comparison.

fn lt_eq( &self, rhs: &str, ) -> <CategoricalChunked as ChunkCompareIneq<&str>>::Item

Less than or equal comparison

impl Clone for CategoricalChunked

fn clone(&self) -> CategoricalChunked

Returns a copy of the value.

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

Performs copy-assignment from source.

impl IntoSeries for CategoricalChunked

fn into_series(self) -> Series

fn is_series() -> bool

impl LogicalType for CategoricalChunked

fn dtype(&self) -> &DataType

Get data type of ChunkedArray.

fn get_any_value(&self, i: usize) -> Result<AnyValue<'_>, PolarsError>

Gets AnyValue from LogicalType

unsafe fn get_any_value_unchecked(&self, i: usize) -> AnyValue<'_>

Safety

fn cast_with_options( &self, dtype: &DataType, options: CastOptions, ) -> Result<Series, PolarsError>

fn cast(&self, dtype: &DataType) -> Result<Series, PolarsError>

impl Serialize for CategoricalChunked

Available on crate feature dtype-categorical only.

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.