U bl@sddlmZddlZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZddlmZmZddlZddlmZd d d ZdS) ) annotationsN)lib)maybe_downcast_numeric) ensure_objectis_datetime_or_timedelta_dtype is_decimalis_integer_dtype is_numberis_numeric_dtype is_scalarneeds_i8_conversion)ABCIndex ABCSeries) NumericArrayraisec Cs|dkrtd|dkr tdd}d}d}t|trBd}|j}nt|trjd}t|jrb|j}q|j}nvt|tt frt j |dd}nXt |rt |rt|St|r|Sd}t j |gdd}nt|d d d krtd n|}d }t|tr|j}|j|}t|d d }t|rnjt|r2|t j}nRt|}|dk} ztj|t| d\}} Wn&ttfk r|dkr~YnX|d k rht|jrhd } |dkrt jd} nh|dkrt|rt |dkrt jd} n8|dkrt jd} t t j j!} | "| } | | d } | d k rh| D]<}t |}|j#|jj#kr*t$||}|j|kr*qhq*|d k rt j%|j&|jd}|||<ddl'm(}m)}t*|jr|n|}|||+}|r|j,||j"|j-dS|rt.j/||j-dS|r|dS|Sd S)a Convert argument to a numeric type. The default return dtype is `float64` or `int64` depending on the data supplied. Use the `downcast` parameter to obtain other dtypes. Please note that precision loss may occur if really large numbers are passed in. Due to the internal limitations of `ndarray`, if numbers smaller than `-9223372036854775808` (np.iinfo(np.int64).min) or larger than `18446744073709551615` (np.iinfo(np.uint64).max) are passed in, it is very likely they will be converted to float so that they can stored in an `ndarray`. These warnings apply similarly to `Series` since it internally leverages `ndarray`. Parameters ---------- arg : scalar, list, tuple, 1-d array, or Series Argument to be converted. errors : {'ignore', 'raise', 'coerce'}, default 'raise' - If 'raise', then invalid parsing will raise an exception. - If 'coerce', then invalid parsing will be set as NaN. - If 'ignore', then invalid parsing will return the input. downcast : str, default None Can be 'integer', 'signed', 'unsigned', or 'float'. If not None, and if the data has been successfully cast to a numerical dtype (or if the data was numeric to begin with), downcast that resulting data to the smallest numerical dtype possible according to the following rules: - 'integer' or 'signed': smallest signed int dtype (min.: np.int8) - 'unsigned': smallest unsigned int dtype (min.: np.uint8) - 'float': smallest float dtype (min.: np.float32) As this behaviour is separate from the core conversion to numeric values, any errors raised during the downcasting will be surfaced regardless of the value of the 'errors' input. In addition, downcasting will only occur if the size of the resulting data's dtype is strictly larger than the dtype it is to be cast to, so if none of the dtypes checked satisfy that specification, no downcasting will be performed on the data. Returns ------- ret Numeric if parsing succeeded. Return type depends on input. Series if Series, otherwise ndarray. See Also -------- DataFrame.astype : Cast argument to a specified dtype. to_datetime : Convert argument to datetime. to_timedelta : Convert argument to timedelta. numpy.ndarray.astype : Cast a numpy array to a specified type. DataFrame.convert_dtypes : Convert dtypes. Examples -------- Take separate series and convert to numeric, coercing when told to >>> s = pd.Series(['1.0', '2', -3]) >>> pd.to_numeric(s) 0 1.0 1 2.0 2 -3.0 dtype: float64 >>> pd.to_numeric(s, downcast='float') 0 1.0 1 2.0 2 -3.0 dtype: float32 >>> pd.to_numeric(s, downcast='signed') 0 1 1 2 2 -3 dtype: int8 >>> s = pd.Series(['apple', '1.0', '2', -3]) >>> pd.to_numeric(s, errors='ignore') 0 apple 1 1.0 2 2 3 -3 dtype: object >>> pd.to_numeric(s, errors='coerce') 0 NaN 1 1.0 2 2.0 3 -3.0 dtype: float64 Downcasting of nullable integer and floating dtypes is supported: >>> s = pd.Series([1, 2, 3], dtype="Int64") >>> pd.to_numeric(s, downcast="integer") 0 1 1 2 2 3 dtype: Int8 >>> s = pd.Series([1.0, 2.1, 3.0], dtype="Float64") >>> pd.to_numeric(s, downcast="float") 0 1.0 1 2.1 2 3.0 dtype: Float32 )Nintegersignedunsignedfloatz#invalid downcasting method provided)ignorerZcoercezinvalid error value specifiedFTO)dtypendimz/arg must be a list, tuple, 1-d array, or SeriesNr)rr)coerce_numericr)rrZIntegerrrZUnsignedIntegerrZFloat) FloatingArray IntegerArray)indexname)r)0 ValueError isinstancervaluesr r rZasi8listtuplenparrayr rrr getattr TypeErrorrZ_mask_datar rviewZint64rrZmaybe_convert_numericset typecodeslenminZfloat32charritemsizerzerosshapeZpandas.core.arraysrrrcopyZ _constructorrpdZIndex)argerrorsZdowncastZ is_seriesZis_indexZ is_scalarsr!maskZ values_dtyper_r+Z float_32_charZ float_32_indtypecoderdatarrklassr;=/tmp/pip-unpacked-wheel-ck39h295/pandas/core/tools/numeric.py to_numericsl            $            r=)rN) __future__rZnumpyr$Z pandas._libsrZpandas.core.dtypes.castrZpandas.core.dtypes.commonrrrrr r r r Zpandas.core.dtypes.genericr rZpandasr3Zpandas.core.arrays.numericrr=r;r;r;r<s   (