Series.clip_lower(threshold, axis=None, inplace=False)
[source]
Return copy of the input with values below a threshold truncated.
Parameters: |
threshold : numeric or array-like Minimum value allowed. All values below threshold will be set to this value.
axis : {0 or ‘index’, 1 or ‘columns’}, default 0 Align inplace : boolean, default False Whether to perform the operation in place on the data. New in version 0.21.0. |
---|---|
Returns: |
|
See also
Series.clip
Series.clip_upper
Series single threshold clipping:
>>> s = pd.Series([5, 6, 7, 8, 9]) >>> s.clip_lower(8) 0 8 1 8 2 8 3 8 4 9 dtype: int64
Series clipping element-wise using an array of thresholds. threshold
should be the same length as the Series.
>>> elemwise_thresholds = [4, 8, 7, 2, 5] >>> s.clip_lower(elemwise_thresholds) 0 5 1 8 2 7 3 8 4 9 dtype: int64
DataFrames can be compared to a scalar.
>>> df = pd.DataFrame({"A": [1, 3, 5], "B": [2, 4, 6]}) >>> df A B 0 1 2 1 3 4 2 5 6
>>> df.clip_lower(3) A B 0 3 3 1 3 4 2 5 6
Or to an array of values. By default, threshold
should be the same shape as the DataFrame.
>>> df.clip_lower(np.array([[3, 4], [2, 2], [6, 2]])) A B 0 3 4 1 3 4 2 6 6
Control how threshold
is broadcast with axis
. In this case threshold
should be the same length as the axis specified by axis
.
>>> df.clip_lower(np.array([3, 3, 5]), axis='index') A B 0 3 3 1 3 4 2 5 6
>>> df.clip_lower(np.array([4, 5]), axis='columns') A B 0 4 5 1 4 5 2 5 6
© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
http://pandas.pydata.org/pandas-docs/version/0.23.4/generated/pandas.Series.clip_lower.html