Struct polars_core::series::Series

source ·
pub struct Series(pub Arc<dyn SeriesTrait>);
Expand description

§Series

The columnar data type for a DataFrame.

Most of the available functions are defined in the SeriesTrait trait.

The Series struct consists of typed ChunkedArray’s. To quickly cast a Series to a ChunkedArray you can call the method with the name of the type:

let s: Series = [1, 2, 3].iter().collect();
// Quickly obtain the ChunkedArray wrapped by the Series.
let chunked_array = s.i32().unwrap();

§Arithmetic

You can do standard arithmetic on series.

let s = Series::new("a", [1 , 2, 3]);
let out_add = &s + &s;
let out_sub = &s - &s;
let out_div = &s / &s;
let out_mul = &s * &s;

Or with series and numbers.

let s: Series = (1..3).collect();
let out_add_one = &s + 1;
let out_multiply = &s * 10;

// Could not overload left hand side operator.
let out_divide = 1.div(&s);
let out_add = 1.add(&s);
let out_subtract = 1.sub(&s);
let out_multiply = 1.mul(&s);

§Comparison

You can obtain boolean mask by comparing series.

let s = Series::new("dollars", &[1, 2, 3]);
let mask = s.equal(1).unwrap();
let valid = [true, false, false].iter();
assert!(mask
    .into_iter()
    .map(|opt_bool| opt_bool.unwrap()) // option, because series can be null
    .zip(valid)
    .all(|(a, b)| a == *b))

See all the comparison operators in the CmpOps trait

§Iterators

The Series variants contain differently typed ChunkedArray’s. These structs can be turned into iterators, making it possible to use any function/ closure you want on a Series.

These iterators return an Option<T> because the values of a series may be null.

use polars_core::prelude::*;
let pi = 3.14;
let s = Series::new("angle", [2f32 * pi, pi, 1.5 * pi].as_ref());
let s_cos: Series = s.f32()
                    .expect("series was not an f32 dtype")
                    .into_iter()
                    .map(|opt_angle| opt_angle.map(|angle| angle.cos()))
                    .collect();

§Creation

Series can be create from different data structures. Below we’ll show a few ways we can create a Series object.

// Series can be created from Vec's, slices and arrays
Series::new("boolean series", &[true, false, true]);
Series::new("int series", &[1, 2, 3]);
// And can be nullable
Series::new("got nulls", &[Some(1), None, Some(2)]);

// Series can also be collected from iterators
let from_iter: Series = (0..10)
    .into_iter()
    .collect();

Tuple Fields§

§0: Arc<dyn SeriesTrait>

Implementations§

source§

impl Series

source

pub fn fill_null(&self, strategy: FillNullStrategy) -> PolarsResult<Series>

Replace None values with one of the following strategies:

  • Forward fill (replace None with the previous value)
  • Backward fill (replace None with the next value)
  • Mean fill (replace None with the mean of the whole array)
  • Min fill (replace None with the minimum of the whole array)
  • Max fill (replace None with the maximum of the whole array)
  • Zero fill (replace None with the value zero)
  • One fill (replace None with the value one)
  • MinBound fill (replace with the minimum of that data type)
  • MaxBound fill (replace with the maximum of that data type)

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

§Example
fn example() -> PolarsResult<()> {
    let s = Series::new("some_missing", &[Some(1), None, Some(2)]);

    let filled = s.fill_null(FillNullStrategy::Forward(None))?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(1), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::Backward(None))?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(2), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::Min)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(1), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::Max)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(2), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::Mean)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(1), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::Zero)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(0), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::One)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(1), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::MinBound)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(-2147483648), Some(2)]);

    let filled = s.fill_null(FillNullStrategy::MaxBound)?;
    assert_eq!(Vec::from(filled.i32()?), &[Some(1), Some(2147483647), Some(2)]);

    Ok(())
}
example();
source§

impl Series

source

pub fn sample_n( &self, n: usize, with_replacement: bool, shuffle: bool, seed: Option<u64> ) -> PolarsResult<Self>

Available on crate feature random only.
source

pub fn sample_frac( &self, frac: f64, with_replacement: bool, shuffle: bool, seed: Option<u64> ) -> PolarsResult<Self>

Available on crate feature random only.

Sample a fraction between 0.0-1.0 of this ChunkedArray.

source

pub fn shuffle(&self, seed: Option<u64>) -> Self

Available on crate feature random only.
source§

impl Series

source

pub fn fmt_list(&self) -> String

source§

impl Series

source

pub fn from_any_values( name: &str, values: &[AnyValue<'_>], strict: bool ) -> PolarsResult<Self>

Construct a new Series from a slice of AnyValues.

The data type of the resulting Series is determined by the values and the strict parameter:

  • If strict is true, the data type is equal to the data type of the first non-null value. If any other non-null values do not match this data type, an error is raised.
  • If strict is false, the data type is the supertype of the values. An error is returned if no supertype can be determined. WARNING: A full pass over the values is required to determine the supertype.
  • If no values were passed, the resulting data type is Null.
source

pub fn from_any_values_and_dtype( name: &str, values: &[AnyValue<'_>], dtype: &DataType, strict: bool ) -> PolarsResult<Self>

Construct a new Series with the given dtype from a slice of AnyValues.

If strict is true, an error is returned if the values do not match the given data type. If strict is false, values that do not match the given data type are cast. If casting is not possible, the values are set to null instead.

source§

impl Series

source

pub fn try_add(&self, rhs: &Series) -> PolarsResult<Series>

source§

impl Series

source

pub fn wrapping_trunc_div_scalar<T: Num + NumCast>(&self, rhs: T) -> Self

source§

impl Series

source

pub unsafe fn from_chunks_and_dtype_unchecked( name: &str, chunks: Vec<ArrayRef>, dtype: &DataType ) -> Self

Takes chunks and a polars datatype and constructs the Series This is faster than creating from chunks and an arrow datatype because there is no casting involved

§Safety

The caller must ensure that the given dtype’s physical type matches all the ArrayRef dtypes.

source

pub unsafe fn _try_from_arrow_unchecked( name: &str, chunks: Vec<ArrayRef>, dtype: &ArrowDataType ) -> PolarsResult<Self>

§Safety

The caller must ensure that the given dtype matches all the ArrayRef dtypes.

source

pub unsafe fn _try_from_arrow_unchecked_with_md( name: &str, chunks: Vec<ArrayRef>, dtype: &ArrowDataType, md: Option<&Metadata> ) -> PolarsResult<Self>

Create a new Series without checking if the inner dtype of the chunks is correct

§Safety

The caller must ensure that the given dtype matches all the ArrayRef dtypes.

source§

impl Series

source

pub fn new_null(name: &str, len: usize) -> Series

source§

impl Series

source

pub fn array_ref(&self, chunk_idx: usize) -> &ArrayRef

Returns a reference to the Arrow ArrayRef

source

pub fn to_arrow(&self, chunk_idx: usize, pl_flavor: bool) -> ArrayRef

Convert a chunk in the Series to the correct Arrow type. This conversion is needed because polars doesn’t use a 1 on 1 mapping for logical/ categoricals, etc.

source§

impl Series

source

pub fn iter(&self) -> SeriesIter<'_>

iterate over Series as AnyValue.

§Panics

This will panic if the array is not rechunked first.

source

pub fn phys_iter(&self) -> SeriesPhysIter<'_>

source§

impl Series

source

pub fn i8(&self) -> PolarsResult<&Int8Chunked>

Unpack to ChunkedArray of dtype [DataType::Int8]

source

pub fn i16(&self) -> PolarsResult<&Int16Chunked>

Unpack to ChunkedArray of dtype [DataType::Int16]

source

pub fn i32(&self) -> PolarsResult<&Int32Chunked>

Unpack to ChunkedArray

let s = Series::new("foo", [1i32 ,2, 3]);
let s_squared: Series = s.i32()
    .unwrap()
    .into_iter()
    .map(|opt_v| {
        match opt_v {
            Some(v) => Some(v * v),
            None => None, // null value
        }
}).collect();

Unpack to ChunkedArray of dtype [DataType::Int32]

source

pub fn i64(&self) -> PolarsResult<&Int64Chunked>

Unpack to ChunkedArray of dtype [DataType::Int64]

source

pub fn f32(&self) -> PolarsResult<&Float32Chunked>

Unpack to ChunkedArray of dtype [DataType::Float32]

source

pub fn f64(&self) -> PolarsResult<&Float64Chunked>

Unpack to ChunkedArray of dtype [DataType::Float64]

source

pub fn u8(&self) -> PolarsResult<&UInt8Chunked>

Unpack to ChunkedArray of dtype [DataType::UInt8]

source

pub fn u16(&self) -> PolarsResult<&UInt16Chunked>

Unpack to ChunkedArray of dtype [DataType::UInt16]

source

pub fn u32(&self) -> PolarsResult<&UInt32Chunked>

Unpack to ChunkedArray of dtype [DataType::UInt32]

source

pub fn u64(&self) -> PolarsResult<&UInt64Chunked>

Unpack to ChunkedArray of dtype [DataType::UInt64]

source

pub fn bool(&self) -> PolarsResult<&BooleanChunked>

Unpack to ChunkedArray of dtype [DataType::Boolean]

source

pub fn str(&self) -> PolarsResult<&StringChunked>

Unpack to ChunkedArray of dtype [DataType::String]

source

pub fn binary(&self) -> PolarsResult<&BinaryChunked>

Unpack to ChunkedArray of dtype [DataType::Binary]

source

pub fn binary_offset(&self) -> PolarsResult<&BinaryOffsetChunked>

Unpack to ChunkedArray of dtype [DataType::Binary]

source

pub fn decimal(&self) -> PolarsResult<&DecimalChunked>

Available on crate feature dtype-decimal only.

Unpack to ChunkedArray of dtype [DataType::Decimal]

source

pub fn list(&self) -> PolarsResult<&ListChunked>

Unpack to ChunkedArray of dtype list

source

pub fn categorical(&self) -> PolarsResult<&CategoricalChunked>

Available on crate feature dtype-categorical only.

Unpack to ChunkedArray of dtype [DataType::Categorical]

source

pub fn null(&self) -> PolarsResult<&NullChunked>

Unpack to ChunkedArray of dtype [DataType::Null]

source§

impl Series

source

pub fn extend_constant( &self, value: AnyValue<'_>, n: usize ) -> PolarsResult<Self>

Extend with a constant value.

source§

impl Series

source

pub fn full_null(name: &str, size: usize, dtype: &DataType) -> Self

source§

impl Series

source

pub fn implode(&self) -> PolarsResult<ListChunked>

Convert the values of this Series to a ListChunked with a length of 1, so a Series of [1, 2, 3] becomes [[1, 2, 3]].

source

pub fn reshape(&self, dimensions: &[i64]) -> PolarsResult<Series>

source§

impl Series

source

pub fn new_empty(name: &str, dtype: &DataType) -> Series

Create a new empty Series.

source

pub fn clear(&self) -> Series

source

pub unsafe fn chunks_mut(&mut self) -> &mut Vec<ArrayRef>

§Safety

The caller must ensure the length and the data types of ArrayRef does not change. And that the null_count is updated (e.g. with a compute_len())

source

pub fn is_sorted_flag(&self) -> IsSorted

source

pub fn set_sorted_flag(&mut self, sorted: IsSorted)

source

pub fn get_flags(&self) -> Settings

source

pub fn into_frame(self) -> DataFrame

source

pub fn rename(&mut self, name: &str) -> &mut Series

Rename series.

source

pub fn with_name(self, name: &str) -> Series

Return this Series with a new name.

source

pub fn from_arrow(name: &str, array: ArrayRef) -> PolarsResult<Series>

source

pub fn shrink_to_fit(&mut self)

Shrink the capacity of this array to fit its length.

source

pub fn append(&mut self, other: &Series) -> PolarsResult<&mut Self>

Append in place. This is done by adding the chunks of other to this Series.

See ChunkedArray::append and ChunkedArray::extend.

source

pub fn compute_len(&mut self)

Redo a length and null_count compute

source

pub fn extend(&mut self, other: &Series) -> PolarsResult<&mut Self>

Extend the memory backed by this array with the values from other.

See ChunkedArray::extend and ChunkedArray::append.

source

pub fn sort(&self, sort_options: SortOptions) -> PolarsResult<Self>

Sort the series with specific options.

§Example
let s = Series::new("foo", [2, 1, 3]);
let sorted = s.sort(SortOptions::default())?;
assert_eq!(sorted, Series::new("foo", [1, 2, 3]));
}

See SortOptions for more options.

source

pub fn as_single_ptr(&mut self) -> PolarsResult<usize>

Only implemented for numeric types

source

pub fn cast(&self, dtype: &DataType) -> PolarsResult<Self>

Cast [Series] to another [DataType].

source

pub unsafe fn cast_unchecked(&self, dtype: &DataType) -> PolarsResult<Self>

Cast from physical to logical types without any checks on the validity of the cast.

§Safety

This can lead to invalid memory access in downstream code.

source

pub fn to_float(&self) -> PolarsResult<Series>

Cast numerical types to f64, and keep floats as is.

source

pub fn sum<T>(&self) -> PolarsResult<T>
where T: NumCast,

Compute the sum of all values in this Series. Returns Some(0) if the array is empty, and None if the array only contains null values.

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

source

pub fn min<T>(&self) -> PolarsResult<Option<T>>
where T: NumCast,

Returns the minimum value in the array, according to the natural order. Returns an option because the array is nullable.

source

pub fn max<T>(&self) -> PolarsResult<Option<T>>
where T: NumCast,

Returns the maximum value in the array, according to the natural order. Returns an option because the array is nullable.

source

pub fn explode(&self) -> PolarsResult<Series>

Explode a list Series. This expands every item to a new row..

source

pub fn is_nan(&self) -> PolarsResult<BooleanChunked>

Check if float value is NaN (note this is different than missing/ null)

source

pub fn is_not_nan(&self) -> PolarsResult<BooleanChunked>

Check if float value is NaN (note this is different than missing/ null)

source

pub fn is_finite(&self) -> PolarsResult<BooleanChunked>

Check if numeric value is finite

source

pub fn is_infinite(&self) -> PolarsResult<BooleanChunked>

Check if float value is infinite

source

pub fn zip_with( &self, mask: &BooleanChunked, other: &Series ) -> PolarsResult<Series>

Available on crate feature zip_with only.

Create a new ChunkedArray with values from self where the mask evaluates true and values from other where the mask evaluates false. This function automatically broadcasts unit length inputs.

source

pub fn to_physical_repr(&self) -> Cow<'_, Series>

Cast a datelike Series to their physical representation. Primitives remain unchanged

  • Date -> Int32
  • Datetime-> Int64
  • Time -> Int64
  • Categorical -> UInt32
  • List(inner) -> List(physical of inner)
source

pub unsafe fn take_unchecked_from_slice(&self, idx: &[IdxSize]) -> Series

Take by index if ChunkedArray contains a single chunk.

§Safety

This doesn’t check any bounds. Null validity is checked.

source

pub unsafe fn take_unchecked_threaded( &self, idx: &IdxCa, rechunk: bool ) -> Series

Take by index if ChunkedArray contains a single chunk.

§Safety

This doesn’t check any bounds. Null validity is checked.

source

pub unsafe fn take_slice_unchecked_threaded( &self, idx: &[IdxSize], rechunk: bool ) -> Series

Take by index if ChunkedArray contains a single chunk.

§Safety

This doesn’t check any bounds. Null validity is checked.

source

pub fn take_threaded(&self, idx: &IdxCa, rechunk: bool) -> PolarsResult<Series>

Take by index. This operation is clone.

§Notes

Out of bounds access doesn’t Error but will return a Null value

source

pub fn gather_every(&self, n: usize, offset: usize) -> Series

Traverse and collect every nth element in a new array.

source

pub fn filter_threaded( &self, filter: &BooleanChunked, rechunk: bool ) -> PolarsResult<Series>

Filter by boolean mask. This operation clones data.

source

pub fn dot(&self, other: &Series) -> PolarsResult<f64>

Available on crate feature dot_product only.
source

pub fn sum_as_series(&self) -> PolarsResult<Series>

Get the sum of the Series as a new Series of length 1. Returns a Series with a single zeroed entry if self is an empty numeric series.

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

source

pub fn product(&self) -> PolarsResult<Series>

Get the product of an array.

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

source

pub fn strict_cast(&self, dtype: &DataType) -> PolarsResult<Series>

Cast throws an error if conversion had overflows

source

pub fn str_value(&self, index: usize) -> PolarsResult<Cow<'_, str>>

source

pub fn head(&self, length: Option<usize>) -> Series

Get the head of the Series.

source

pub fn tail(&self, length: Option<usize>) -> Series

Get the tail of the Series.

source

pub fn mean_as_series(&self) -> Series

source

pub fn unique_stable(&self) -> PolarsResult<Series>

Compute the unique elements, but maintain order. This requires more work than a naive Series::unique.

source

pub fn idx(&self) -> PolarsResult<&IdxCa>

source

pub fn estimated_size(&self) -> usize

Returns an estimation of the total (heap) allocated size of the Series in bytes.

§Implementation

This estimation is the sum of the size of its buffers, validity, including nested arrays. Multiple arrays may share buffers and bitmaps. Therefore, the size of 2 arrays is not the sum of the sizes computed from this function. In particular, [StructArray]’s size is an upper bound.

When an array is sliced, its allocated size remains constant because the buffer unchanged. However, this function will yield a smaller number. This is because this function returns the visible size of the buffer, not its total capacity.

FFI buffers are included in this estimation.

source

pub fn as_list(&self) -> ListChunked

Packs every element into a list.

source§

impl Series

source

pub fn equals(&self, other: &Series) -> bool

Check if series are equal. Note that None == None evaluates to false

source

pub fn equals_missing(&self, other: &Series) -> bool

Check if all values in series are equal where None == None evaluates to true. Two Datetime series are not equal if their timezones are different, regardless if they represent the same UTC time or not.

source

pub fn get_data_ptr(&self) -> usize

Get a pointer to the underlying data of this Series. Can be useful for fast comparisons.

Methods from Deref<Target = dyn SeriesTrait>§

source

pub fn unpack<N>(&self) -> PolarsResult<&ChunkedArray<N>>
where N: 'static + PolarsDataType,

Trait Implementations§

source§

impl Add<&Series> for &DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the + operator.
source§

fn add(self, rhs: &Series) -> Self::Output

Performs the + operation. Read more
source§

impl Add<&Series> for DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the + operator.
source§

fn add(self, rhs: &Series) -> Self::Output

Performs the + operation. Read more
source§

impl<T> Add<T> for &Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the + operator.
source§

fn add(self, rhs: T) -> Self::Output

Performs the + operation. Read more
source§

impl<T> Add<T> for Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the + operator.
source§

fn add(self, rhs: T) -> Self::Output

Performs the + operation. Read more
source§

impl Add for &Series

§

type Output = Series

The resulting type after applying the + operator.
source§

fn add(self, rhs: Self) -> Self::Output

Performs the + operation. Read more
source§

impl Add for Series

§

type Output = Series

The resulting type after applying the + operator.
source§

fn add(self, rhs: Self) -> Self::Output

Performs the + operation. Read more
source§

impl AsMut<Series> for UnstableSeries<'_>

source§

fn as_mut(&mut self) -> &mut Series

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

impl AsRef<Series> for UnstableSeries<'_>

We don’t implement Deref so that the caller is aware of converting to Series

source§

fn as_ref(&self) -> &Series

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

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

source§

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

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

impl<'a> ChunkApply<'a, Series> for ListChunked

source§

fn apply_values<F>(&'a self, f: F) -> Self
where F: Fn(Series) -> Series + Copy,

Apply a closure F elementwise.

§

type FuncRet = Series

source§

fn apply<F>(&'a self, f: F) -> Self
where F: Fn(Option<Series>) -> Option<Series> + Copy,

Apply a closure elementwise including null values.
source§

fn apply_to_slice<F, T>(&'a self, f: F, slice: &mut [T])
where F: Fn(Option<Series>, &T) -> T,

Apply a closure elementwise and write results to a mutable slice.
source§

impl ChunkCompare<&Series> for Series

source§

fn equal(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking for equality.

source§

fn equal_missing(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking for equality.

source§

fn not_equal(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking for inequality.

source§

fn not_equal_missing(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking for inequality.

source§

fn gt(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking if self > rhs.

source§

fn gt_eq(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking if self >= rhs.

source§

fn lt(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking if self < rhs.

source§

fn lt_eq(&self, rhs: &Series) -> PolarsResult<BooleanChunked>

Create a boolean mask by checking if self <= rhs.

§

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

source§

impl ChunkCompare<&str> for Series

§

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

source§

fn equal(&self, rhs: &str) -> PolarsResult<BooleanChunked>

Check for equality.
source§

fn equal_missing(&self, rhs: &str) -> Self::Item

Check for equality where None == None.
source§

fn not_equal(&self, rhs: &str) -> PolarsResult<BooleanChunked>

Check for inequality.
source§

fn not_equal_missing(&self, rhs: &str) -> Self::Item

Check for inequality where None == None.
source§

fn gt(&self, rhs: &str) -> PolarsResult<BooleanChunked>

Greater than comparison.
source§

fn gt_eq(&self, rhs: &str) -> Self::Item

Greater than or equal comparison.
source§

fn lt(&self, rhs: &str) -> Self::Item

Less than comparison.
source§

fn lt_eq(&self, rhs: &str) -> Self::Item

Less than or equal comparison
source§

impl<Rhs> ChunkCompare<Rhs> for Series
where Rhs: NumericNative,

§

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

source§

fn equal(&self, rhs: Rhs) -> PolarsResult<BooleanChunked>

Check for equality.
source§

fn equal_missing(&self, rhs: Rhs) -> Self::Item

Check for equality where None == None.
source§

fn not_equal(&self, rhs: Rhs) -> PolarsResult<BooleanChunked>

Check for inequality.
source§

fn not_equal_missing(&self, rhs: Rhs) -> Self::Item

Check for inequality where None == None.
source§

fn gt(&self, rhs: Rhs) -> PolarsResult<BooleanChunked>

Greater than comparison.
source§

fn gt_eq(&self, rhs: Rhs) -> PolarsResult<BooleanChunked>

Greater than or equal comparison.
source§

fn lt(&self, rhs: Rhs) -> PolarsResult<BooleanChunked>

Less than comparison.
source§

fn lt_eq(&self, rhs: Rhs) -> PolarsResult<BooleanChunked>

Less than or equal comparison
source§

impl ChunkFull<&Series> for ListChunked

source§

fn full(name: &str, value: &Series, length: usize) -> ListChunked

Create a ChunkedArray with a single value.
source§

impl ChunkQuantile<Series> for ListChunked

source§

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

Returns the mean value in the array. Returns None if the array is empty or only contains null values.
source§

fn quantile( &self, _quantile: f64, _interpol: QuantileInterpolOptions ) -> PolarsResult<Option<T>>

Aggregate a given quantile of the ChunkedArray. Returns None if the array is empty or only contains null values.
source§

impl<T: PolarsObject> ChunkQuantile<Series> for ObjectChunked<T>

Available on crate feature object only.
source§

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

Returns the mean value in the array. Returns None if the array is empty or only contains null values.
source§

fn quantile( &self, _quantile: f64, _interpol: QuantileInterpolOptions ) -> PolarsResult<Option<T>>

Aggregate a given quantile of the ChunkedArray. Returns None if the array is empty or only contains null values.
source§

impl Clone for Series

source§

fn clone(&self) -> Series

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Series

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl Default for Series

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl Deref for Series

§

type Target = dyn SeriesTrait

The resulting type after dereferencing.
source§

fn deref(&self) -> &Self::Target

Dereferences the value.
source§

impl Display for Series

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl Div<&Series> for &DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the / operator.
source§

fn div(self, rhs: &Series) -> Self::Output

Performs the / operation. Read more
source§

impl Div<&Series> for DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the / operator.
source§

fn div(self, rhs: &Series) -> Self::Output

Performs the / operation. Read more
source§

impl<T> Div<T> for &Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the / operator.
source§

fn div(self, rhs: T) -> Self::Output

Performs the / operation. Read more
source§

impl<T> Div<T> for Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the / operator.
source§

fn div(self, rhs: T) -> Self::Output

Performs the / operation. Read more
source§

impl Div for &Series

source§

fn div(self, rhs: Self) -> Self::Output

let s: Series = [1, 2, 3].iter().collect();
let out = &s / &s;
§

type Output = Series

The resulting type after applying the / operator.
source§

impl Div for Series

§

type Output = Series

The resulting type after applying the / operator.
source§

fn div(self, rhs: Self) -> Self::Output

Performs the / operation. Read more
source§

impl<T> From<ChunkedArray<T>> for Series

source§

fn from(ca: ChunkedArray<T>) -> Self

Converts to this type from the input type.
source§

impl<'a> FromIterator<&'a bool> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a bool>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a f32> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a f32>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a f64> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a f64>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a i32> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a i32>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a i64> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a i64>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a str> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a str>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a u32> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a u32>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl<'a> FromIterator<&'a u64> for Series

source§

fn from_iter<I: IntoIterator<Item = &'a u64>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<bool>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<bool>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<f32>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<f32>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<f64>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<f64>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<i32>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<i32>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<i64>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<i64>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<u32>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<u32>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Option<u64>> for Series

source§

fn from_iter<I: IntoIterator<Item = Option<u64>>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Series> for DataFrame

source§

fn from_iter<T: IntoIterator<Item = Series>>(iter: T) -> Self

§Panics

Panics if Series have different lengths.

source§

impl FromIterator<String> for Series

source§

fn from_iter<I: IntoIterator<Item = String>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<bool> for Series

source§

fn from_iter<I: IntoIterator<Item = bool>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<f32> for Series

source§

fn from_iter<I: IntoIterator<Item = f32>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<f64> for Series

source§

fn from_iter<I: IntoIterator<Item = f64>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<i32> for Series

source§

fn from_iter<I: IntoIterator<Item = i32>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<i64> for Series

source§

fn from_iter<I: IntoIterator<Item = i64>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<u32> for Series

source§

fn from_iter<I: IntoIterator<Item = u32>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<u64> for Series

source§

fn from_iter<I: IntoIterator<Item = u64>>(iter: I) -> Self

Creates a value from an iterator. Read more
source§

impl IntoSeries for Series

source§

impl Mul<&Series> for &DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the * operator.
source§

fn mul(self, rhs: &Series) -> Self::Output

Performs the * operation. Read more
source§

impl Mul<&Series> for DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the * operator.
source§

fn mul(self, rhs: &Series) -> Self::Output

Performs the * operation. Read more
source§

impl<T> Mul<T> for &Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the * operator.
source§

fn mul(self, rhs: T) -> Self::Output

Performs the * operation. Read more
source§

impl<T> Mul<T> for Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the * operator.
source§

fn mul(self, rhs: T) -> Self::Output

Performs the * operation. Read more
source§

impl Mul for &Series

source§

fn mul(self, rhs: Self) -> Self::Output

let s: Series = [1, 2, 3].iter().collect();
let out = &s * &s;
§

type Output = Series

The resulting type after applying the * operator.
source§

impl Mul for Series

§

type Output = Series

The resulting type after applying the * operator.
source§

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation. Read more
source§

impl NamedFrom<&Series, str> for Series

source§

fn new(name: &str, s: &Series) -> Self

Initialize by name and values.
source§

impl NamedFrom<Range<i32>, Int32Type> for Series

source§

fn new(name: &str, range: Range<i32>) -> Self

Initialize by name and values.
source§

impl NamedFrom<Range<i64>, Int64Type> for Series

source§

fn new(name: &str, range: Range<i64>) -> Self

Initialize by name and values.
source§

impl NamedFrom<Range<u32>, UInt32Type> for Series

source§

fn new(name: &str, range: Range<u32>) -> Self

Initialize by name and values.
source§

impl NamedFrom<Range<u64>, UInt64Type> for Series

source§

fn new(name: &str, range: Range<u64>) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[&'a [u8]]>> NamedFrom<T, [&'a [u8]]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[&'a str]>> NamedFrom<T, [&'a str]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[AnyValue<'a>]>> NamedFrom<T, [AnyValue<'a>]> for Series

source§

fn new(name: &str, values: T) -> Self

Construct a new Series from a collection of AnyValue.

§Panics

Panics if the values do not all share the same data type (with the exception of DataType::Null, which is always allowed).

source§

impl<'a, T: AsRef<[Cow<'a, [u8]>]>> NamedFrom<T, [Cow<'a, [u8]>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[Cow<'a, str>]>> NamedFrom<T, [Cow<'a, str>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[Option<&'a [u8]>]>> NamedFrom<T, [Option<&'a [u8]>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[Option<&'a str>]>> NamedFrom<T, [Option<&'a str>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[Option<Cow<'a, [u8]>>]>> NamedFrom<T, [Option<Cow<'a, [u8]>>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<'a, T: AsRef<[Option<Cow<'a, str>>]>> NamedFrom<T, [Option<Cow<'a, str>>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<Series>]>> NamedFrom<T, [Option<Series>]> for Series

source§

fn new(name: &str, s: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<String>]>> NamedFrom<T, [Option<String>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<Vec<u8>>]>> NamedFrom<T, [Option<Vec<u8>>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<bool>]>> NamedFrom<T, [Option<bool>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<f32>]>> NamedFrom<T, [Option<f32>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<f64>]>> NamedFrom<T, [Option<f64>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<i32>]>> NamedFrom<T, [Option<i32>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<i64>]>> NamedFrom<T, [Option<i64>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<u32>]>> NamedFrom<T, [Option<u32>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Option<u64>]>> NamedFrom<T, [Option<u64>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[String]>> NamedFrom<T, [String]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Vec<u8>]>> NamedFrom<T, [Vec<u8>]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[bool]>> NamedFrom<T, [bool]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[f32]>> NamedFrom<T, [f32]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[f64]>> NamedFrom<T, [f64]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[i32]>> NamedFrom<T, [i32]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[i64]>> NamedFrom<T, [i64]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[u32]>> NamedFrom<T, [u32]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[u64]>> NamedFrom<T, [u64]> for Series

source§

fn new(name: &str, v: T) -> Self

Initialize by name and values.
source§

impl<T: AsRef<[Series]>> NamedFrom<T, ListType> for Series

source§

fn new(name: &str, s: T) -> Self

Initialize by name and values.
source§

impl<T: IntoSeries> NamedFrom<T, T> for Series

For any ChunkedArray and Series

source§

fn new(name: &str, t: T) -> Self

Initialize by name and values.
source§

impl NamedFromOwned<Vec<f32>> for Series

source§

fn from_vec(name: &str, v: Vec<f32>) -> Self

Initialize by name and values.
source§

impl NamedFromOwned<Vec<f64>> for Series

source§

fn from_vec(name: &str, v: Vec<f64>) -> Self

Initialize by name and values.
source§

impl NamedFromOwned<Vec<i32>> for Series

source§

fn from_vec(name: &str, v: Vec<i32>) -> Self

Initialize by name and values.
source§

impl NamedFromOwned<Vec<i64>> for Series

source§

fn from_vec(name: &str, v: Vec<i64>) -> Self

Initialize by name and values.
source§

impl NamedFromOwned<Vec<u32>> for Series

source§

fn from_vec(name: &str, v: Vec<u32>) -> Self

Initialize by name and values.
source§

impl NamedFromOwned<Vec<u64>> for Series

source§

fn from_vec(name: &str, v: Vec<u64>) -> Self

Initialize by name and values.
source§

impl NumOpsDispatchChecked for Series

Available on crate feature checked_arithmetic only.
source§

fn checked_div(&self, rhs: &Series) -> PolarsResult<Series>

Checked integer division. Computes self / rhs, returning None if rhs == 0 or the division results in overflow.
source§

fn checked_div_num<T: ToPrimitive>(&self, rhs: T) -> PolarsResult<Series>

source§

impl PartialEq for Series

source§

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Rem<&Series> for &DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the % operator.
source§

fn rem(self, rhs: &Series) -> Self::Output

Performs the % operation. Read more
source§

impl Rem<&Series> for DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the % operator.
source§

fn rem(self, rhs: &Series) -> Self::Output

Performs the % operation. Read more
source§

impl<T> Rem<T> for &Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the % operator.
source§

fn rem(self, rhs: T) -> Self::Output

Performs the % operation. Read more
source§

impl<T> Rem<T> for Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the % operator.
source§

fn rem(self, rhs: T) -> Self::Output

Performs the % operation. Read more
source§

impl Rem for &Series

source§

fn rem(self, rhs: Self) -> Self::Output

let s: Series = [1, 2, 3].iter().collect();
let out = &s / &s;
§

type Output = Series

The resulting type after applying the % operator.
source§

impl Sub<&Series> for &DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the - operator.
source§

fn sub(self, rhs: &Series) -> Self::Output

Performs the - operation. Read more
source§

impl Sub<&Series> for DataFrame

Available on crate feature dataframe_arithmetic only.
§

type Output = Result<DataFrame, PolarsError>

The resulting type after applying the - operator.
source§

fn sub(self, rhs: &Series) -> Self::Output

Performs the - operation. Read more
source§

impl<T> Sub<T> for &Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the - operator.
source§

fn sub(self, rhs: T) -> Self::Output

Performs the - operation. Read more
source§

impl<T> Sub<T> for Series
where T: Num + NumCast,

§

type Output = Series

The resulting type after applying the - operator.
source§

fn sub(self, rhs: T) -> Self::Output

Performs the - operation. Read more
source§

impl Sub for &Series

§

type Output = Series

The resulting type after applying the - operator.
source§

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation. Read more
source§

impl Sub for Series

§

type Output = Series

The resulting type after applying the - operator.
source§

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation. Read more
source§

impl TryFrom<(&Field, Box<dyn Array>)> for Series

§

type Error = PolarsError

The type returned in the event of a conversion error.
source§

fn try_from(field_arr: (&ArrowField, ArrayRef)) -> PolarsResult<Self>

Performs the conversion.
source§

impl TryFrom<(&Field, Vec<Box<dyn Array>>)> for Series

§

type Error = PolarsError

The type returned in the event of a conversion error.
source§

fn try_from(field_arr: (&ArrowField, Vec<ArrayRef>)) -> PolarsResult<Self>

Performs the conversion.
source§

impl TryFrom<(&str, Box<dyn Array>)> for Series

§

type Error = PolarsError

The type returned in the event of a conversion error.
source§

fn try_from(name_arr: (&str, ArrayRef)) -> PolarsResult<Self>

Performs the conversion.
source§

impl TryFrom<(&str, Vec<Box<dyn Array>>)> for Series

§

type Error = PolarsError

The type returned in the event of a conversion error.
source§

fn try_from(name_arr: (&str, Vec<ArrayRef>)) -> PolarsResult<Self>

Performs the conversion.

Auto Trait Implementations§

§

impl Freeze for Series

§

impl !RefUnwindSafe for Series

§

impl Send for Series

§

impl Sync for Series

§

impl Unpin for Series

§

impl !UnwindSafe for Series

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> DynClone for T
where T: Clone,

source§

fn __clone_box(&self, _: Private) -> *mut ()

source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<A, T, E> FromFallibleIterator<A, E> for T
where T: FromIterator<A>, E: Error,

source§

fn from_fallible_iter<F>(iter: F) -> Result<T, E>
where F: FallibleIterator<E, Item = A>,

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T, Rhs, Output> NumOps<Rhs, Output> for T
where T: Sub<Rhs, Output = Output> + Mul<Rhs, Output = Output> + Div<Rhs, Output = Output> + Add<Rhs, Output = Output> + Rem<Rhs, Output = Output>,