Struct polars::datatypes::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, pl_flavor: bool, 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: &str, 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) -> &str

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_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 fn _with_fast_unique(self, toggle: bool) -> CategoricalChunked

Available on crate feature dtype-categorical only.

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_as_series(&self) -> Series

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

fn max_as_series(&self) -> Series

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

fn sum_as_series(&self) -> Scalar

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

fn prod_as_series(&self) -> Series

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

impl ChunkCompare<&CategoricalChunked> for CategoricalChunked

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

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

Check for equality.

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

Check for equality where None == None.

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

Check for inequality.

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

Check for inequality where None == None.

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

Greater than comparison.

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

Greater than or equal comparison.

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

Less than comparison.

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

Less than or equal comparison

impl ChunkCompare<&ChunkedArray<StringType>> for CategoricalChunked

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

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

Check for equality.

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

Check for equality where None == None.

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

Check for inequality.

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

Check for inequality where None == None.

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

Greater than comparison.

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

Greater than or equal comparison.

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

Less than comparison.

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

Less than or equal comparison

impl ChunkCompare<&str> for CategoricalChunked

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

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

Check for equality.

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

Check for equality where None == None.

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

Check for inequality.

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

Check for inequality where None == None.

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

Greater than comparison.

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

Greater than or equal comparison.

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

Less than comparison.

fn lt_eq(&self, rhs: &str) -> <CategoricalChunked as ChunkCompare<&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(&self, dtype: &DataType) -> Result<Series, PolarsError>