maxframe.dataframe.Series.clip#

Series.clip(lower=None, upper=None, *, axis=None, inplace=False)#

在输入阈值处裁剪值。

将超出边界的值赋为边界值。阈值可以是单个值或类似数组的形式，在后一种情况下，裁剪操作将沿指定轴逐元素进行。

参数:

lower (float or array-like, default None) -- 最小阈值。所有低于此阈值的值将被设为此值。如果为 None，则不执行下限裁剪。
upper (float or array-like, default None) -- 最大阈值。所有高于此阈值的值将被设为此值。如果为 None，则不执行上限裁剪。
axis (int or str axis name, optional) -- 沿给定轴对齐对象的下限和上限。
inplace (bool, default False) -- 是否在数据上原地执行操作。
*args -- 附加关键字无效果，但为了与 numpy 兼容可能会被接受。
**kwargs -- 附加关键字无效果，但为了与 numpy 兼容可能会被接受。

返回:

与调用对象类型相同，裁剪边界之外的值被替换；如果 inplace=True，则返回 None。

返回类型:

Series or DataFrame or None

参见

Series.clip: 在序列中按输入阈值裁剪值。
DataFrame.clip: 在数据框中按输入阈值裁剪值。
numpy.clip: 裁剪（限制）数组中的值。

示例

>>> import maxframe.dataframe as md
>>> data = {'col_0': [9, -3, 0, -1, 5], 'col_1': [-2, -7, 6, 8, -5]}
>>> df = md.DataFrame(data)
>>> df.execute()
   col_0  col_1
0      9     -2
1     -3     -7
2      0      6
3     -1      8
4      5     -5

使用下限和上限阈值按列进行裁剪：

>>> df.clip(lower=-4, upper=7).execute()
   col_0  col_1
    7     -2
   -3     -4
    0      6
   -1      7
    5     -4

使用每列元素特定的下限和上限阈值进行裁剪：

>>> t = md.Series([2, -4, -1, 6, 3])
>>> t.execute()
0    2
1   -4
2   -1
3    6
4    3
dtype: int64

>>> df.clip(lower=t, upper=t).execute()
   col_0  col_1
    2      2
   -3     -4
    0     -1
   -1      6
    5      3