pyarrow.compute.rank_normal#

pyarrow.compute.rank_normal(input,/,sort_keys='ascending',*,null_placement='at_end',options=None,memory_pool=None)#

Compute normal (gaussian) ranks of an array.

This function computes a normal (gaussian) rank of the input array.By default, null values are considered greater than any other value andare therefore sorted at the end of the input. For floating-point types,NaNs are considered greater than any other non-null value, but smallerthan null values.The results are finite real values. They are obtained as if firstcalling the “rank_quantile” function and then applying the normalpercent-point function (PPF) to the resulting quantile values.

The handling of nulls and NaNs can be changed in RankQuantileOptions.

Parameters:

inputArray-like or scalar-like

Argument to compute function.

sort_keyssequence of (name,order)tuples orstr, default “ascending”

Names of field/column keys to sort the input on,along with the order each field/column is sorted in.Accepted values fororder are “ascending”, “descending”.The field name can be a string column name or expression.Alternatively, one can simply pass “ascending” or “descending” as a stringif the input is array-like.

null_placementstr, default “at_end”

Where nulls in input should be sorted.Accepted values are “at_start”, “at_end”.

optionspyarrow.compute.RankQuantileOptions, optional

Alternative way of passing options.

memory_poolpyarrow.MemoryPool, optional

If not passed, will allocate memory from the default memory pool.