| Server IP : 209.209.40.120 / Your IP : 216.73.217.112 Web Server : Microsoft-IIS/10.0 System : Windows NT NEWWWW 10.0 build 17763 (Windows Server 2019) i586 User : NEWWWW$ ( 0) PHP Version : 8.3.30 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/Python312/Lib/site-packages/pandas/core/ops/__pycache__/ |
Upload File : |
�
- �gH � � � U d Z ddlmZ dLd�ZdZdZedz Zedz Zedz Zed z Z ed
z Z
ed z Z ed z Z ed
z Z
edz Zedz Zedz Zedz Zedz Zedz ZdZdZdddeed�ddd eed�d d d eed d!�d"d#d$e ed�d%d&d'e
ed d!�d(d)d*e ed d!�d+d,d-e
ed d!�d.d/d0e ed d!�d1d2d eed�d3d4d eed�d5d6d eed�d7d8d eed�d9d:d eed�d;d<d eed�d=�Zd>ed?< d@Z eej5 � � ZeD ]S Z ee dA Z e ��ee j= � ee < e ee dA< dBee dC � dDe� �ee dE< dFee dC � dGe� �ee dE< �U dHZ dIZ dJZ!dKZ"y )Mz
Templating for ops docstrings
� )� annotationsc � � | j dd� } t | }|d }|�J �| j d� r d|� d|� �}n| dk( r | � d|� d �}n|� d|� d
�}|d k( rXt }|d r |t j |d |d
�� z
}|j |d | ||d �� }|d }|r||z }|S |}|S |dk( rI| dv r"t }t j | |d �� }|S t }|j |d | ||d �� }|S t d� �)at
Make the appropriate substitutions for the given operation and class-typ
into either _flex_doc_SERIES or _flex_doc_FRAME to return the docstring
to attach to a generated method.
Parameters
----------
op_name : str {'__add__', '__sub__', ... '__eq__', '__ne__', ...}
typ : str {series, 'dataframe']}
Returns
-------
doc : str
�__� �op�rzother � �divmod�(z, other)z other�series�reverse�
see_also_desc)r
r �desc�series_returns)r �op_name�equivr �series_examples� dataframe)�eq�ne�le�lt�ge�gt)r r )r r r r
zInvalid typ argument.) �replace�_op_descriptions�
startswith�_flex_doc_SERIES�_see_also_reverse_SERIES�format�_flex_comp_doc_FRAME�_flex_doc_FRAME�AssertionError) r �typ�op_desc�
op_desc_opr �base_doc�doc_no_examples� ser_example�docs �<C:\Python312\Lib\site-packages\pandas/core/ops/docstrings.py�
make_flex_docr, s� � � �o�o�d�B�'�G� �w�'�G��� �J� � !�!� !����#� ��� �A�c�U�+�� �H� ��)�1�S�E��*���%�q�� �F�+��
�h��#�� �9� � �0�7�7� � �*�'�/�:R� 8� �
�H� #�/�/��� ���"�#3�4� *�
�� � /�0� � �!�K�/�C�( �J�% "�C�$ �J�#
� � � �:� :�+�H�&�-�-� � �V�_� .� �C� �J� '�H��/�/� �V�_� �� � �*� "� �C� �J� � 4�5�5� a
Examples
--------
>>> a = pd.Series([1, 1, 1, np.nan], index=['a', 'b', 'c', 'd'])
>>> a
a 1.0
b 1.0
c 1.0
d NaN
dtype: float64
>>> b = pd.Series([1, np.nan, 1, np.nan], index=['a', 'b', 'd', 'e'])
>>> b
a 1.0
b NaN
d 1.0
e NaN
dtype: float64a(
Examples
--------
>>> a = pd.Series([1, 1, 1, np.nan, 1], index=['a', 'b', 'c', 'd', 'e'])
>>> a
a 1.0
b 1.0
c 1.0
d NaN
e 1.0
dtype: float64
>>> b = pd.Series([0, 1, 2, np.nan, 1], index=['a', 'b', 'c', 'd', 'f'])
>>> b
a 0.0
b 1.0
c 2.0
d NaN
f 1.0
dtype: float64zX
>>> a.add(b, fill_value=0)
a 2.0
b 1.0
c 1.0
d 1.0
e NaN
dtype: float64
z]
>>> a.subtract(b, fill_value=0)
a 0.0
b 1.0
c 1.0
d -1.0
e NaN
dtype: float64
z]
>>> a.multiply(b, fill_value=0)
a 1.0
b 0.0
c 0.0
d 0.0
e NaN
dtype: float64
z[
>>> a.divide(b, fill_value=0)
a 1.0
b inf
c inf
d 0.0
e NaN
dtype: float64
z]
>>> a.floordiv(b, fill_value=0)
a 1.0
b inf
c inf
d 0.0
e NaN
dtype: float64
z�
>>> a.divmod(b, fill_value=0)
(a 1.0
b inf
c inf
d 0.0
e NaN
dtype: float64,
a 0.0
b NaN
c NaN
d 0.0
e NaN
dtype: float64)
zX
>>> a.mod(b, fill_value=0)
a 0.0
b NaN
c NaN
d 0.0
e NaN
dtype: float64
zX
>>> a.pow(b, fill_value=0)
a 1.0
b 1.0
c 1.0
d 0.0
e NaN
dtype: float64
z^
>>> a.ne(b, fill_value=0)
a False
b True
c True
d True
e True
dtype: bool
z^
>>> a.eq(b, fill_value=0)
a True
b False
c False
d False
e False
dtype: bool
zi
>>> a.lt(b, fill_value=0)
a False
b False
c True
d False
e False
f True
dtype: bool
zi
>>> a.le(b, fill_value=0)
a False
b True
c True
d False
e False
f True
dtype: bool
zi
>>> a.gt(b, fill_value=0)
a True
b False
c False
d False
e True
f False
dtype: bool
zi
>>> a.ge(b, fill_value=0)
a True
b True
c False
d False
e True
f False
dtype: bool
z'Series
The result of the operation.z22-Tuple of Series
The result of the operation.�+�Addition�radd)r r r
r r �-� Subtraction�rsub�*�Multiplication�rmulN)r r r
r r � df_examples�%�Modulo�rmodz**zExponential power�rpow�/zFloating division�rtruedivz//zInteger division� rfloordivr
zInteger division and modulo�rdivmodz==zEqual toz!=z Not equal to�<z Less thanz<=zLess than or equal to�>z Greater thanz>=zGreater than or equal to)�add�sub�mul�mod�pow�truediv�floordivr
r r r r r r z dict[str, dict[str, str | None]]r z�see
`Python documentation
<https://docs.python.org/3/reference/datamodel.html#emulating-numeric-types>`_
for more detailsr
zReverse of the r z operator, r z
Element-wise z, a
Return {desc} of series and other, element-wise (binary operator `{op_name}`).
Equivalent to ``{equiv}``, but with support to substitute a fill_value for
missing data in either one of the inputs.
Parameters
----------
other : Series or scalar value
level : int or name
Broadcast across a level, matching Index values on the
passed MultiIndex level.
fill_value : None or float value, default None (NaN)
Fill existing missing (NaN) values, and any new element needed for
successful Series alignment, with this value before computation.
If data in both corresponding Series locations is missing
the result of filling (at that location) will be missing.
axis : {{0 or 'index'}}
Unused. Parameter needed for compatibility with DataFrame.
Returns
-------
{series_returns}
z7
See Also
--------
Series.{reverse} : {see_also_desc}.
a�
Get {desc} of dataframe and other, element-wise (binary operator `{op_name}`).
Equivalent to ``{equiv}``, but with support to substitute a fill_value
for missing data in one of the inputs. With reverse version, `{reverse}`.
Among flexible wrappers (`add`, `sub`, `mul`, `div`, `floordiv`, `mod`, `pow`) to
arithmetic operators: `+`, `-`, `*`, `/`, `//`, `%`, `**`.
Parameters
----------
other : scalar, sequence, Series, dict or DataFrame
Any single or multiple element data structure, or list-like object.
axis : {{0 or 'index', 1 or 'columns'}}
Whether to compare by the index (0 or 'index') or columns.
(1 or 'columns'). For Series input, axis to match Series index on.
level : int or label
Broadcast across a level, matching Index values on the
passed MultiIndex level.
fill_value : float or None, default None
Fill existing missing (NaN) values, and any new element needed for
successful DataFrame alignment, with this value before computation.
If data in both corresponding DataFrame locations is missing
the result will be missing.
Returns
-------
DataFrame
Result of the arithmetic operation.
See Also
--------
DataFrame.add : Add DataFrames.
DataFrame.sub : Subtract DataFrames.
DataFrame.mul : Multiply DataFrames.
DataFrame.div : Divide DataFrames (float division).
DataFrame.truediv : Divide DataFrames (float division).
DataFrame.floordiv : Divide DataFrames (integer division).
DataFrame.mod : Calculate modulo (remainder after division).
DataFrame.pow : Calculate exponential power.
Notes
-----
Mismatched indices will be unioned together.
Examples
--------
>>> df = pd.DataFrame({{'angles': [0, 3, 4],
... 'degrees': [360, 180, 360]}},
... index=['circle', 'triangle', 'rectangle'])
>>> df
angles degrees
circle 0 360
triangle 3 180
rectangle 4 360
Add a scalar with operator version which return the same
results.
>>> df + 1
angles degrees
circle 1 361
triangle 4 181
rectangle 5 361
>>> df.add(1)
angles degrees
circle 1 361
triangle 4 181
rectangle 5 361
Divide by constant with reverse version.
>>> df.div(10)
angles degrees
circle 0.0 36.0
triangle 0.3 18.0
rectangle 0.4 36.0
>>> df.rdiv(10)
angles degrees
circle inf 0.027778
triangle 3.333333 0.055556
rectangle 2.500000 0.027778
Subtract a list and Series by axis with operator version.
>>> df - [1, 2]
angles degrees
circle -1 358
triangle 2 178
rectangle 3 358
>>> df.sub([1, 2], axis='columns')
angles degrees
circle -1 358
triangle 2 178
rectangle 3 358
>>> df.sub(pd.Series([1, 1, 1], index=['circle', 'triangle', 'rectangle']),
... axis='index')
angles degrees
circle -1 359
triangle 2 179
rectangle 3 359
Multiply a dictionary by axis.
>>> df.mul({{'angles': 0, 'degrees': 2}})
angles degrees
circle 0 720
triangle 0 360
rectangle 0 720
>>> df.mul({{'circle': 0, 'triangle': 2, 'rectangle': 3}}, axis='index')
angles degrees
circle 0 0
triangle 6 360
rectangle 12 1080
Multiply a DataFrame of different shape with operator version.
>>> other = pd.DataFrame({{'angles': [0, 3, 4]}},
... index=['circle', 'triangle', 'rectangle'])
>>> other
angles
circle 0
triangle 3
rectangle 4
>>> df * other
angles degrees
circle 0 NaN
triangle 9 NaN
rectangle 16 NaN
>>> df.mul(other, fill_value=0)
angles degrees
circle 0 0.0
triangle 9 0.0
rectangle 16 0.0
Divide by a MultiIndex by level.
>>> df_multindex = pd.DataFrame({{'angles': [0, 3, 4, 4, 5, 6],
... 'degrees': [360, 180, 360, 360, 540, 720]}},
... index=[['A', 'A', 'A', 'B', 'B', 'B'],
... ['circle', 'triangle', 'rectangle',
... 'square', 'pentagon', 'hexagon']])
>>> df_multindex
angles degrees
A circle 0 360
triangle 3 180
rectangle 4 360
B square 4 360
pentagon 5 540
hexagon 6 720
>>> df.div(df_multindex, level=1, fill_value=0)
angles degrees
A circle NaN 1.0
triangle 1.0 1.0
rectangle 1.0 1.0
B square 0.0 0.0
pentagon 0.0 0.0
hexagon 0.0 0.0
a<
Get {desc} of dataframe and other, element-wise (binary operator `{op_name}`).
Among flexible wrappers (`eq`, `ne`, `le`, `lt`, `ge`, `gt`) to comparison
operators.
Equivalent to `==`, `!=`, `<=`, `<`, `>=`, `>` with support to choose axis
(rows or columns) and level for comparison.
Parameters
----------
other : scalar, sequence, Series, or DataFrame
Any single or multiple element data structure, or list-like object.
axis : {{0 or 'index', 1 or 'columns'}}, default 'columns'
Whether to compare by the index (0 or 'index') or columns
(1 or 'columns').
level : int or label
Broadcast across a level, matching Index values on the passed
MultiIndex level.
Returns
-------
DataFrame of bool
Result of the comparison.
See Also
--------
DataFrame.eq : Compare DataFrames for equality elementwise.
DataFrame.ne : Compare DataFrames for inequality elementwise.
DataFrame.le : Compare DataFrames for less than inequality
or equality elementwise.
DataFrame.lt : Compare DataFrames for strictly less than
inequality elementwise.
DataFrame.ge : Compare DataFrames for greater than inequality
or equality elementwise.
DataFrame.gt : Compare DataFrames for strictly greater than
inequality elementwise.
Notes
-----
Mismatched indices will be unioned together.
`NaN` values are considered different (i.e. `NaN` != `NaN`).
Examples
--------
>>> df = pd.DataFrame({{'cost': [250, 150, 100],
... 'revenue': [100, 250, 300]}},
... index=['A', 'B', 'C'])
>>> df
cost revenue
A 250 100
B 150 250
C 100 300
Comparison with a scalar, using either the operator or method:
>>> df == 100
cost revenue
A False True
B False False
C True False
>>> df.eq(100)
cost revenue
A False True
B False False
C True False
When `other` is a :class:`Series`, the columns of a DataFrame are aligned
with the index of `other` and broadcast:
>>> df != pd.Series([100, 250], index=["cost", "revenue"])
cost revenue
A True True
B True False
C False True
Use the method to control the broadcast axis:
>>> df.ne(pd.Series([100, 300], index=["A", "D"]), axis='index')
cost revenue
A True False
B True True
C True True
D True True
When comparing to an arbitrary sequence, the number of columns must
match the number elements in `other`:
>>> df == [250, 100]
cost revenue
A True True
B False False
C False False
Use the method to control the axis:
>>> df.eq([250, 250, 100], axis='index')
cost revenue
A True False
B False True
C True False
Compare to a DataFrame of different shape.
>>> other = pd.DataFrame({{'revenue': [300, 250, 100, 150]}},
... index=['A', 'B', 'C', 'D'])
>>> other
revenue
A 300
B 250
C 100
D 150
>>> df.gt(other)
cost revenue
A False False
B False False
C False True
D False False
Compare to a MultiIndex by level.
>>> df_multindex = pd.DataFrame({{'cost': [250, 150, 100, 150, 300, 220],
... 'revenue': [100, 250, 300, 200, 175, 225]}},
... index=[['Q1', 'Q1', 'Q1', 'Q2', 'Q2', 'Q2'],
... ['A', 'B', 'C', 'A', 'B', 'C']])
>>> df_multindex
cost revenue
Q1 A 250 100
B 150 250
C 100 300
Q2 A 150 200
B 300 175
C 220 225
>>> df.le(df_multindex, level=1)
cost revenue
Q1 A True True
B True True
C True True
Q2 A False True
B True False
C True False
)r �strr$ rI �returnrI )#�__doc__�
__future__r r, � _common_examples_algebra_SERIES�"_common_examples_comparison_SERIES�_add_example_SERIES�_sub_example_SERIES�_mul_example_SERIES�_div_example_SERIES�_floordiv_example_SERIES�_divmod_example_SERIES�_mod_example_SERIES�_pow_example_SERIES�_ne_example_SERIES�_eq_example_SERIES�_lt_example_SERIES�_le_example_SERIES�_gt_example_SERIES�_ge_example_SERIES�_returns_series�_returns_tupler �__annotations__� _py_num_ref�list�keys� _op_names�key�
reverse_op�copyr r r" r! � r- r+ �<module>rh s� ��� #�=�@#� �$&� "�* $�� � � $�� � � $�� � � $�� � � $�� � � $��� �( $�� � � $�� � � $�� � � $�� � � '� �
� � '� �
� � '� �
� � '� �
� � A��J��
���.�)� � � ��.�)� � � ��.�)��
� ���.�)� � �#��.�)��
� �#� �.�)��
� �"� �3�)��
� �-� �1�(��
� ���-�)� � � ��-�)� � ���-�)� � �'��-�)� � � ��-�)� � �*��-�)� �Gj6� �2� j�X� �
�!�&�&�(� )� � �
K�C�!�#�&�y�1�J�� �'7��'<�'A�'A�'C���$�25���$�Y�/� � .�s� 3�F� ;� <�K� �}� U� �� � �
�
� ,�S� 1�&� 9�:�"�[�M� J� ��$� �
�
K�� �2 � � f��PP� r-