Trait SeriesTrait

pub trait SeriesTrait:
    Send
    + Sync
    + PrivateSeries
    + PrivateSeriesNumeric {
    // Required methods
    fn rename(&mut self, name: PlSmallStr);
    fn chunk_lengths(
        &self,
    ) -> Map<Iter<'_, Box<dyn Array>>, fn(_: &Box<dyn Array>) -> usize> ;
    fn name(&self) -> &PlSmallStr;
    fn chunks(&self) -> &Vec<Box<dyn Array>>;
    unsafe fn chunks_mut(&mut self) -> &mut Vec<Box<dyn Array>>;
    fn slice(&self, _offset: i64, _length: usize) -> Series;
    fn split_at(&self, _offset: i64) -> (Series, Series);
    fn filter(
        &self,
        _filter: &ChunkedArray<BooleanType>,
    ) -> Result<Series, PolarsError>;
    fn take(
        &self,
        _indices: &ChunkedArray<UInt32Type>,
    ) -> Result<Series, PolarsError>;
    unsafe fn take_unchecked(&self, _idx: &ChunkedArray<UInt32Type>) -> Series;
    fn take_slice(&self, _indices: &[u32]) -> Result<Series, PolarsError>;
    unsafe fn take_slice_unchecked(&self, _idx: &[u32]) -> Series;
    fn len(&self) -> usize;
    fn rechunk(&self) -> Series;
    fn new_from_index(&self, _index: usize, _length: usize) -> Series;
    fn cast(
        &self,
        _dtype: &DataType,
        options: CastOptions,
    ) -> Result<Series, PolarsError>;
    fn get(&self, _index: usize) -> Result<AnyValue<'_>, PolarsError>;
    fn null_count(&self) -> usize;
    fn has_nulls(&self) -> bool;
    fn is_null(&self) -> ChunkedArray<BooleanType>;
    fn is_not_null(&self) -> ChunkedArray<BooleanType>;
    fn reverse(&self) -> Series;
    fn shift(&self, _periods: i64) -> Series;
    fn clone_inner(&self) -> Arc<dyn SeriesTrait>;
    fn as_any(&self) -> &(dyn Any + 'static);

    // Provided methods
    fn get_metadata(&self) -> Option<RwLockReadGuard<'_, dyn MetadataTrait>> { ... }
    fn boxed_metadata<'a>(&'a self) -> Option<Box<dyn MetadataTrait + 'a>> { ... }
    fn field(&self) -> Cow<'_, Field> { ... }
    fn dtype(&self) -> &DataType { ... }
    fn n_chunks(&self) -> usize { ... }
    fn shrink_to_fit(&mut self) { ... }
    fn limit(&self, num_elements: usize) -> Series { ... }
    fn is_empty(&self) -> bool { ... }
    fn rechunk_validity(&self) -> Option<Bitmap> { ... }
    fn drop_nulls(&self) -> Series { ... }
    fn _sum_as_f64(&self) -> f64 { ... }
    fn mean(&self) -> Option<f64> { ... }
    fn std(&self, _ddof: u8) -> Option<f64> { ... }
    fn var(&self, _ddof: u8) -> Option<f64> { ... }
    fn median(&self) -> Option<f64> { ... }
    unsafe fn get_unchecked(&self, _index: usize) -> AnyValue<'_> { ... }
    fn sort_with(&self, _options: SortOptions) -> Result<Series, PolarsError> { ... }
    fn arg_sort(&self, options: SortOptions) -> ChunkedArray<UInt32Type> { ... }
    fn unique(&self) -> Result<Series, PolarsError> { ... }
    fn n_unique(&self) -> Result<usize, PolarsError> { ... }
    fn arg_unique(&self) -> Result<ChunkedArray<UInt32Type>, PolarsError> { ... }
    fn as_single_ptr(&mut self) -> Result<usize, PolarsError> { ... }
    fn sum_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn max_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn min_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn median_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn var_reduce(&self, _ddof: u8) -> Result<Scalar, PolarsError> { ... }
    fn std_reduce(&self, _ddof: u8) -> Result<Scalar, PolarsError> { ... }
    fn quantile_reduce(
        &self,
        _quantile: f64,
        _method: QuantileMethod,
    ) -> Result<Scalar, PolarsError> { ... }
    fn and_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn or_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn xor_reduce(&self) -> Result<Scalar, PolarsError> { ... }
    fn first(&self) -> Scalar { ... }
    fn last(&self) -> Scalar { ... }
    fn approx_n_unique(&self) -> Result<u32, PolarsError> { ... }
    fn get_object(
        &self,
        _index: usize,
    ) -> Option<&(dyn PolarsObjectSafe + 'static)> { ... }
    unsafe fn get_object_chunked_unchecked(
        &self,
        _chunk: usize,
        _index: usize,
    ) -> Option<&(dyn PolarsObjectSafe + 'static)> { ... }
    fn as_any_mut(&mut self) -> &mut (dyn Any + 'static) { ... }
    fn checked_div(&self, _rhs: &Series) -> Result<Series, PolarsError> { ... }
    fn rolling_map(
        &self,
        _f: &dyn Fn(&Series) -> Series,
        _options: RollingOptionsFixedWindow,
    ) -> Result<Series, PolarsError> { ... }
}

Required Methods

fn rename(&mut self, name: PlSmallStr)

Rename the Series.

fn chunk_lengths( &self, ) -> Map<Iter<'_, Box<dyn Array>>, fn(_: &Box<dyn Array>) -> usize>

Get the lengths of the underlying chunks

fn name(&self) -> &PlSmallStr

Name of series.

fn chunks(&self) -> &Vec<Box<dyn Array>>

Underlying chunks.

unsafe fn chunks_mut(&mut self) -> &mut Vec<Box<dyn Array>>

Underlying chunks.

Safety

The caller must ensure the length and the data types of ArrayRef does not change.

fn slice(&self, _offset: i64, _length: usize) -> Series

Get a zero copy view of the data.

When offset is negative the offset is counted from the end of the array

fn split_at(&self, _offset: i64) -> (Series, Series)

Get a zero copy view of the data.

When offset is negative the offset is counted from the end of the array

fn filter( &self, _filter: &ChunkedArray<BooleanType>, ) -> Result<Series, PolarsError>

Filter by boolean mask. This operation clones data.

fn take( &self, _indices: &ChunkedArray<UInt32Type>, ) -> Result<Series, PolarsError>

Take from self at the indexes given by idx.

Null values in idx because null values in the output array.

This operation is clone.

unsafe fn take_unchecked(&self, _idx: &ChunkedArray<UInt32Type>) -> Series

Take from self at the indexes given by idx.

Null values in idx because null values in the output array.

Safety

This doesn’t check any bounds.

fn take_slice(&self, _indices: &[u32]) -> Result<Series, PolarsError>

Take from self at the indexes given by idx.

This operation is clone.

unsafe fn take_slice_unchecked(&self, _idx: &[u32]) -> Series

Take from self at the indexes given by idx.

Safety

This doesn’t check any bounds.

fn len(&self) -> usize

Get length of series.

fn rechunk(&self) -> Series

Aggregate all chunks to a contiguous array of memory.

fn new_from_index(&self, _index: usize, _length: usize) -> Series

Create a new Series filled with values from the given index.

Example

use polars_core::prelude::*;
let s = Series::new("a".into(), [0i32, 1, 8]);
let s2 = s.new_from_index(2, 4);
assert_eq!(Vec::from(s2.i32().unwrap()), &[Some(8), Some(8), Some(8), Some(8)])

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

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

Get a single value by index. Don’t use this operation for loops as a runtime cast is needed for every iteration.

fn null_count(&self) -> usize

Count the null values.

fn has_nulls(&self) -> bool

Return if any the chunks in this ChunkedArray have nulls.

fn is_null(&self) -> ChunkedArray<BooleanType>

Get a mask of the null values.

fn is_not_null(&self) -> ChunkedArray<BooleanType>

Get a mask of the non-null values.

fn reverse(&self) -> Series

return a Series in reversed order

fn shift(&self, _periods: i64) -> Series

Shift the values by a given period and fill the parts that will be empty due to this operation with Nones.

NOTE: If you want to fill the Nones with a value use the shift operation on ChunkedArray<T>.

Example

fn example() -> PolarsResult<()> {
    let s = Series::new("series".into(), &[1, 2, 3]);

    let shifted = s.shift(1);
    assert_eq!(Vec::from(shifted.i32()?), &[None, Some(1), Some(2)]);

    let shifted = s.shift(-1);
    assert_eq!(Vec::from(shifted.i32()?), &[Some(2), Some(3), None]);

    let shifted = s.shift(2);
    assert_eq!(Vec::from(shifted.i32()?), &[None, None, Some(1)]);

    Ok(())
}
example();

fn clone_inner(&self) -> Arc<dyn SeriesTrait>

Clone inner ChunkedArray and wrap in a new Arc

fn as_any(&self) -> &(dyn Any + 'static)

Get a hold to self as Any trait reference.

Provided Methods

fn get_metadata(&self) -> Option<RwLockReadGuard<'_, dyn MetadataTrait>>

fn boxed_metadata<'a>(&'a self) -> Option<Box<dyn MetadataTrait + 'a>>

fn field(&self) -> Cow<'_, Field>

Get field (used in schema)

fn dtype(&self) -> &DataType

Get datatype of series.

fn n_chunks(&self) -> usize

Number of chunks in this Series

fn shrink_to_fit(&mut self)

Shrink the capacity of this array to fit its length.

fn limit(&self, num_elements: usize) -> Series

Take num_elements from the top as a zero copy view.

fn is_empty(&self) -> bool

Check if Series is empty.

fn rechunk_validity(&self) -> Option<Bitmap>

fn drop_nulls(&self) -> Series

Drop all null values and return a new Series.

fn _sum_as_f64(&self) -> f64

Returns the sum of the array as an f64.

fn mean(&self) -> Option<f64>

Returns the mean value in the array Returns an option because the array is nullable.

fn std(&self, _ddof: u8) -> Option<f64>

Returns the std value in the array Returns an option because the array is nullable.

fn var(&self, _ddof: u8) -> Option<f64>

Returns the var value in the array Returns an option because the array is nullable.

fn median(&self) -> Option<f64>

Returns the median value in the array Returns an option because the array is nullable.

unsafe fn get_unchecked(&self, _index: usize) -> AnyValue<'_>

Get a single value by index. Don’t use this operation for loops as a runtime cast is needed for every iteration.

This may refer to physical types

Safety

Does not do any bounds checking

fn sort_with(&self, _options: SortOptions) -> Result<Series, PolarsError>

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

Retrieve the indexes needed for a sort.

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

Get unique values in the Series.

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

Get unique values in the Series.

A null value also counts as a unique value.

fn arg_unique(&self) -> Result<ChunkedArray<UInt32Type>, PolarsError>

Get first indexes of unique values.

fn as_single_ptr(&mut self) -> Result<usize, PolarsError>

Rechunk and return a pointer to the start of the Series. Only implemented for numeric types

fn sum_reduce(&self) -> Result<Scalar, PolarsError>

Get the sum of the Series as a new Scalar.

If the DataType is one of {Int8, UInt8, Int16, UInt16} the Series is first cast to Int64 to prevent overflow issues.

fn max_reduce(&self) -> Result<Scalar, PolarsError>

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

fn min_reduce(&self) -> Result<Scalar, PolarsError>

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

fn median_reduce(&self) -> Result<Scalar, PolarsError>

Get the median of the Series as a new Series of length 1.

fn var_reduce(&self, _ddof: u8) -> Result<Scalar, PolarsError>

Get the variance of the Series as a new Series of length 1.

fn std_reduce(&self, _ddof: u8) -> Result<Scalar, PolarsError>

Get the standard deviation of the Series as a new Series of length 1.

fn quantile_reduce( &self, _quantile: f64, _method: QuantileMethod, ) -> Result<Scalar, PolarsError>

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

fn and_reduce(&self) -> Result<Scalar, PolarsError>

Get the bitwise AND of the Series as a new Series of length 1,

fn or_reduce(&self) -> Result<Scalar, PolarsError>

Get the bitwise OR of the Series as a new Series of length 1,

fn xor_reduce(&self) -> Result<Scalar, PolarsError>

Get the bitwise XOR of the Series as a new Series of length 1,

fn first(&self) -> Scalar

Get the first element of the Series as a Scalar

If the Series is empty, a Scalar with a AnyValue::Null is returned.

fn last(&self) -> Scalar

Get the last element of the Series as a Scalar

If the Series is empty, a Scalar with a AnyValue::Null is returned.

fn approx_n_unique(&self) -> Result<u32, PolarsError>

Available on crate feature approx_unique only.

fn get_object(&self, _index: usize) -> Option<&(dyn PolarsObjectSafe + 'static)>

Available on crate feature object only.

Get the value at this index as a downcastable Any trait ref.

unsafe fn get_object_chunked_unchecked( &self, _chunk: usize, _index: usize, ) -> Option<&(dyn PolarsObjectSafe + 'static)>

Available on crate feature object only.

Get the value at this index as a downcastable Any trait ref.

Safety

This function doesn’t do any bound checks.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Get a hold to self as Any trait reference. Only implemented for ObjectType

fn checked_div(&self, _rhs: &Series) -> Result<Series, PolarsError>

Available on crate feature checked_arithmetic only.

fn rolling_map( &self, _f: &dyn Fn(&Series) -> Series, _options: RollingOptionsFixedWindow, ) -> Result<Series, PolarsError>

Available on crate feature rolling_window only.

Apply a custom function over a rolling/ moving window of the array. This has quite some dynamic dispatch, so prefer rolling_min, max, mean, sum over this.

Implementations

impl dyn SeriesTrait + '_

pub fn unpack<N>(&self) -> Result<&ChunkedArray<N>, PolarsError>

where N: 'static + PolarsDataType,

Trait Implementations

impl<T> AsMut<ChunkedArray<T>> for dyn SeriesTrait + '_

where T: 'static + PolarsDataType,

fn as_mut(&mut self) -> &mut ChunkedArray<T>

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T> AsRef<ChunkedArray<T>> for dyn SeriesTrait + '_

where T: 'static + PolarsDataType,

fn as_ref(&self) -> &ChunkedArray<T>

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a> AsRef<dyn SeriesTrait + 'a> for Series

fn as_ref(&self) -> &(dyn SeriesTrait + 'a)

Converts this type into a shared reference of the (usually inferred) input type.

Implementors