U
|
¬ý°dü ã @ sà U d Z ddlmZ ddlmZ ddlmZmZ ddlm Z ddl
|
m Z ddl m Z ddlZddlZdd lmZ dd
|
lmZmZmZmZmZmZmZmZmZm Z m Z m Z dd l m Z ddl!Z"dd l#m$Z$m%Z% dd l&m'Z' ddl(m)Z) ddl*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0 ddl1m2Z2 ddl3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z> ddl?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZK ddlLmMZM ddlNmOZOmPZP ddlQmRZRmSZSmTZT ddlUmVZV ddlWmXZX ddlYmZ m[Z\ ddl]m^Z^ ddl_m`Z`maZambZbmcZc ddldmeZe ddlfmgZg dd lhmiZi dd ljmkZkmlZl dd lmmnZn erNdd lompZpmqZq d Zrd!esd"< d#Ztd$Zud!esd%< G d&d' d'ZvG d(d) d)ZwG d*d+ d+ZxG d,d- d-exZyd+d.d/d0Zzd1d.d2d3Z{d1d.d4d5Z|G d6d7 d7Z}G d8d9 d9Z~d¤d:d;d<d<d=d>d?Zed¥d;d<d@dAdBdCZd¦dHdIdJd:dKdLd:d:dMdKdIdNdO dPdQZG dRdS dSZG dTdU dUeZG dVdW dWeZG dXdY dYeZ
G dZd[ d[eZd\dNd]d^d_Zd`dadbdcddZd§dfd:d:dgdhdiZd¨dfd:d<d:djdkdlZd©dad:d<dmdndodpZdqd<d<drdsdtZG dudv dve
ZG dwdx dxeZdªdzd{dadmd|d}d~Zd«dNd:dKddNdddZd¬dd:dNdd
dZd:d:dddZddd:dNdddZddadddZG dd dZd®ddaddddZd¯dHdddddZd dNdd¡d¢d£ZdS )°z
|
Internal module for formatting output data in csv, html, xml,
|
and latex files. This module also applies to display formatting.
|
é )Ú annotations)Úcontextmanager)Ú
|
QUOTE_NONEÚQUOTE_NONNUMERIC)ÚDecimal)Úpartial)ÚStringION)Úget_terminal_size) ÚIOÚ TYPE_CHECKINGÚAnyÚCallableÚFinalÚ GeneratorÚHashableÚIterableÚListÚMappingÚSequenceÚcast)Úeast_asian_width)Ú
|
get_optionÚ
|
set_option)Úlib)ÚNA)ÚNaTÚ TimedeltaÚ TimestampÚget_unit_from_dtypeÚiNaTÚperiods_per_day)ÚNaTType) Ú ArrayLikeÚAxesÚColspaceArgTypeÚ ColspaceTypeÚCompressionOptionsÚFilePathÚFloatFormatTypeÚFormattersTypeÚ
|
IndexLabelÚStorageOptionsÚ WriteBuffer) Úis_categorical_dtypeÚis_complex_dtypeÚis_datetime64_dtypeÚis_extension_array_dtypeÚis_floatÚis_float_dtypeÚ
|
is_integerÚis_integer_dtypeÚ is_list_likeÚis_numeric_dtypeÚ is_scalarÚis_timedelta64_dtype)ÚDatetimeTZDtype)ÚisnaÚnotna)Ú CategoricalÚ DatetimeArrayÚTimedeltaArray)Ú StringDtype)Ú PandasObject)Ú extract_array)ÚIndexÚ
|
MultiIndexÚ PeriodIndexÚ ensure_index)Ú DatetimeIndex)ÚTimedeltaIndex)Úconcat)Úcheck_parent_directoryÚstringify_path)Úprinting)Ú DataFrameÚSeriesa´
|
Parameters
|
----------
|
buf : str, Path or StringIO-like, optional, default None
|
Buffer to write to. If None, the output is returned as a string.
|
columns : sequence, optional, default None
|
The subset of columns to write. Writes all columns by default.
|
col_space : %(col_space_type)s, optional
|
%(col_space)s.
|
header : %(header_type)s, optional
|
%(header)s.
|
index : bool, optional, default True
|
Whether to print index (row) labels.
|
na_rep : str, optional, default 'NaN'
|
String representation of ``NaN`` to use.
|
formatters : list, tuple or dict of one-param. functions, optional
|
Formatter functions to apply to columns' elements by position or
|
name.
|
The result of each function must be a unicode string.
|
List/tuple must be of length equal to the number of columns.
|
float_format : one-parameter function, optional, default None
|
Formatter function to apply to columns' elements if they are
|
floats. This function must return a unicode string and will be
|
applied only to the non-``NaN`` elements, with ``NaN`` being
|
handled by ``na_rep``.
|
|
.. versionchanged:: 1.2.0
|
|
sparsify : bool, optional, default True
|
Set to False for a DataFrame with a hierarchical index to print
|
every multiindex key at each row.
|
index_names : bool, optional, default True
|
Prints the names of the indexes.
|
justify : str, default None
|
How to justify the column labels. If None uses the option from
|
the print configuration (controlled by set_option), 'right' out
|
of the box. Valid values are
|
|
* left
|
* right
|
* center
|
* justify
|
* justify-all
|
* start
|
* end
|
* inherit
|
* match-parent
|
* initial
|
* unset.
|
max_rows : int, optional
|
Maximum number of rows to display in the console.
|
max_cols : int, optional
|
Maximum number of columns to display in the console.
|
show_dimensions : bool, default False
|
Display DataFrame dimensions (number of rows by number of columns).
|
decimal : str, default '.'
|
Character recognized as decimal separator, e.g. ',' in Europe.
|
r Úcommon_docstring) ÚleftÚrightÚcenterÚjustifyz justify-allÚstartÚendZinheritz match-parentÚinitialZunsetz
|
Returns
|
-------
|
str or None
|
If buf is None, returns the result as a string. Otherwise returns
|
None.
|
Úreturn_docstringc @ sP e Zd Zdddddddd d
|
d Zdd d dZdd ddZdd ddZdS )ÚCategoricalFormatterNTÚNaNr< úIO[str] | NoneÚboolÚstrÚNone)Ú categoricalÚbufÚlengthÚna_repÚfooterÚreturnc C s8 || _ |d k r|ntd| _|| _|| _|| _t| _d S ©NÚ )r] r r^ r` r_ ra r Úquoting)Úselfr] r^ r_ r` ra © rg úOd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\pandas/io/formats/format.pyÚ__init__É s z CategoricalFormatter.__init__©rb c C sP d}| j r*|r|d7 }|dt| j 7 }| j ¡ }|r@|d7 }||7 }t|S )Nrd ú, úLength: Ú
|
)r_ Úlenr] Ú_repr_categories_infor[ )rf ra Ú
|
level_inforg rg rh Ú _get_footerØ s
|
z CategoricalFormatter._get_footerú list[str]c C s t | j ¡ d d | j| jdS )N)Ú float_formatr` re )Ú format_arrayr] Ú_internal_get_valuesr` re ©rf rg rg rh Ú_get_formatted_valuesé s ûz*CategoricalFormatter._get_formatted_valuesc C s| | j }t|dkr$| jr | ¡ S dS | ¡ }dd |D }d |¡}d| d g}| jrn| ¡ }|rn| |¡ td |¡S ) Nr rd c S s g | ] }| ¡ qS rg )Ústrip©Ú.0Úirg rg rh Ú
|
<listcomp>ý s z2CategoricalFormatter.to_string.<locals>.<listcomp>rk ú[ú]rm )r] rn ra rq rw ÚjoinÚappendr[ )rf r] Ú
|
fmt_valuesÚvaluesÚresultra rg rg rh Ú to_stringò s
|
|
z CategoricalFormatter.to_string)NTrX T)Ú__name__Ú
|
__module__Ú __qualname__ri rq rw r rg rg rg rh rW È s ú rW c @ sx e Zd Zd dddddd dd
|
dd d d d ddZd dddZd dddZddddZddddZd ddd ZdS ) ÚSeriesFormatterNTrX FrM rY ú
|
bool | strrZ r[ ú
|
str | Noneú
|
int | Noner\ ) Úseriesr^ r_ ÚheaderÚindexr` Únamers ÚdtypeÚmax_rowsÚmin_rowsrb c C st || _ |d k r|nt | _|| _|| _|| _|| _|| _|
|
| _| | _ |d krTt
|
d}|| _ | | _ t | _| ¡ d S )Núdisplay.float_format)r r r^ r r` r r_ r r r r rs r Úget_adjustmentÚadjÚ _chk_truncate) rf r r^ r_ r r r` r rs r r r rg rg rh ri s zSeriesFormatter.__init__rj c C s¨ | | j }| j}|o t| j|k}| j}|rtt|}|rDt||}|dkr`|}|jd |
}n*|d }t|jd |
|j| d
f}|| _ nd | _ || _
|
|| _ d S )Né é ) r r rn r r ÚintÚminÚilocrH Ú
|
tr_row_numÚ tr_seriesÚis_truncated_vertically)rf r r r r Úrow_numrg rg rh r ) s$
|
|
"z SeriesFormatter._chk_truncatec C sF | j j}d}t| j jdd d k rLt| j jtttfs8t|d| j jj 7 }| jdk r|d k r|rj|d7 }t
|
j |dd}|d| 7 }| j d ks | j d
|
krÀ| j rÀ|r¬|d7 }|d t| j 7 }| jdk r| jd k rt| jjd d }|r|rú|d7 }|d t
|
|¡ 7 }t| jjr>| jj ¡ }|r6|d7 }||7 }t|S )Nrd ÚfreqzFreq: Frk ©ú ú rm )Ú escape_charszName: TÚtruncaterl r zdtype: rm )r r Úgetattrr Ú
|
isinstancerF rD rG ÚAssertionErrorZfreqstrrK Ú pprint_thingr_ r rn r r r- Ú_valuesro r[ )rf r ra Z series_nameZ
|
dtype_namerp rg rg rh rq D sB ÿ
|
ÿÿ zSeriesFormatter._get_footerztuple[list[str], bool]c C sR | j j}t|tr4tdd |jD }|jdd}n|jd k }|jdd}||fS )Nc s s | ]
|
}|V qd S ©Nrg ©rz r rg rg rh Ú <genexpr>q s z7SeriesFormatter._get_formatted_index.<locals>.<genexpr>T)Únames)r )r r r§ rC Úanyr® Úformatr )rf r Ú have_headerÚ fmt_indexrg rg rh Ú_get_formatted_indexm s
|
|
z$SeriesFormatter._get_formatted_indexrr c C s t | jjd | j| j| jdS )N)rs r` Ú leading_space)rt r rª rs r` r rv rg rg rh rw x s ûz%SeriesFormatter._get_formatted_valuesc C s. | j }| ¡ }t|dkr2t| jj d| dS | ¡ \}}| ¡ }| jr¾d}| j }t
|
t |}| j ||d ¡}|dkrd} nd} | j j | g|dd d } | || | ¡ | |d d
|
¡ | jrâ| j jd |dd
|g }
|
n| j d|¡}
|
| jr|r|d d |
|
}
|
|r |
|
d | 7 }
|
td
|
|
|
¡S ) Nr z([], ú)r é ú...z..rQ ©Úmoderd rm )r¶ )r rq rn Útyper r
r³ rw r r r r r rR Úinsertr Úadjoinr r[ r ) rf r ra r² r± r Z n_header_rowsr ÚwidthZdot_strr rg rg rh r s2
|
zSeriesFormatter.to_string)
|
NTTTrX FNTNN) r
r r ri r rq r³ rw r rg rg rg rh r s ô& ) r c @ sP e Zd ZddddZddddd Zdd ddd d ddZdddddZdS )ÚTextAdjustmentr\ rj c C s t d| _d S )Nzdisplay.encoding)r Úencodingrv rg rg rh ri © s zTextAdjustment.__init__r[ r ©Útextrb c C s t |S r« ©rn ©rf rÁ rg rg rh rn ¬ s zTextAdjustment.lenrP r rr ©ÚtextsÚmax_lenr¹ rb c C s t j|||dS )Nr¸ )rK rR ©rf rÅ rÆ r¹ rg rg rh rR ¯ s zTextAdjustment.justify)Úspacerb c O s t j|f|| j| jd|S )N)ZstrlenZjustfunc)rK r¼ rn rR )rf rÈ ÚlistsÚkwargsrg rg rh r¼ ² s ÿÿ ÿÿzTextAdjustment.adjoinN)rP )r
r r ri rn rR r¼ rg rg rg rh r¾ ¨ s r¾ c sH e Zd Zdd fdd Zddddd Zdd ddd d ddZ ZS )ÚEastAsianTextAdjustmentr\ rj c s6 t ¡ tdrd| _nd| _dddddd| _d S )Nz!display.unicode.ambiguous_as_wider r )ZNaÚNÚWÚFÚH)Úsuperri r Úambiguous_widthÚ_EAW_MAPrv ©Ú __class__rg rh ri ¹ s
|
|
z EastAsianTextAdjustment.__init__r[ r rÀ c s( t |tst|S t fdd|D S )zN
|
Calculate display width considering unicode East Asian Width
|
c 3 s" | ]} j t| j¡V qd S r« )rÒ Úgetr rÑ )rz Úcrv rg rh r Ì s z.EastAsianTextAdjustment.len.<locals>.<genexpr>)r§ r[ rn Úsumrà rg rv rh rn Å s
|
|
ÿzEastAsianTextAdjustment.lenrP z Iterable[str]rr rÄ c sX fdd |dkr( fdd|D S |dkrB fdd|D S fdd|D S d S ) Nc s | ¡ t | S r« r )Út)rÆ rf rg rh Ú_get_padÔ s z1EastAsianTextAdjustment.justify.<locals>._get_padrO c s g | ]}| |¡qS rg )Úljust©rz Úx©rÙ rg rh r| Ø s z3EastAsianTextAdjustment.justify.<locals>.<listcomp>rQ c s g | ]}| |¡qS rg )rQ rÛ rÝ rg rh r| Ú s c s g | ]}| |¡qS rg )ÚrjustrÛ rÝ rg rh r| Ü s rg rÇ rg )rÙ rÆ rf rh rR Ð s z EastAsianTextAdjustment.justify)rP )r
r r ri rn rR Ú __classcell__rg rg rÓ rh rË ¸ s ÿrË rj c C s t d} | rt S t S d S )Nz display.unicode.east_asian_width)r rË r¾ )Zuse_east_asian_widthrg rg rh r ß s r zdict[str, Any]c C sL ddl m} tdr"| ¡ \}}nd}tdtdtdtdtd |d
|
S ) aõ Get the parameters used to repr(dataFrame) calls using DataFrame.to_string.
|
|
Supplying these parameters to DataFrame.to_string is equivalent to calling
|
``repr(DataFrame)``. This is useful if you want to adjust the repr output.
|
|
.. versionadded:: 1.4.0
|
|
Example
|
-------
|
>>> import pandas as pd
|
>>>
|
>>> df = pd.DataFrame([[1, 2], [3, 4]])
|
>>> repr_params = pd.io.formats.format.get_dataframe_repr_params()
|
>>> repr(df) == df.to_string(**repr_params)
|
True
|
r )Úconsolezdisplay.expand_frame_reprNúdisplay.max_rowsúdisplay.min_rowszdisplay.max_columnsúdisplay.max_colwidthúdisplay.show_dimensions)r r Úmax_colsZ max_colwidthÚshow_dimensionsÚ
|
line_width)Úpandas.io.formatsrà r Zget_console_size)rà rç Ú_rg rg rh Úget_dataframe_repr_paramsç s úrê c C sN t \} }tddkr|ntd}tddkr2|ntd}dd||tddS )aé Get the parameters used to repr(Series) calls using Series.to_string.
|
|
Supplying these parameters to Series.to_string is equivalent to calling
|
``repr(series)``. This is useful if you want to adjust the series repr output.
|
|
.. versionadded:: 1.4.0
|
|
Example
|
-------
|
>>> import pandas as pd
|
>>>
|
>>> ser = pd.Series([1, 2, 3, 4])
|
>>> repr_params = pd.io.formats.format.get_series_repr_params()
|
>>> repr(ser) == ser.to_string(**repr_params)
|
True
|
rá r râ Trä )r r r r r_ )r r )r½ Úheightr r rg rg rh Úget_series_repr_params s
|
|
ÿý
|
ÿýûrì c @ sX e Zd ZdZerendZeee 7 Zdjdd d
|
d d d ddddd ddddd d d ddddZddddZed dd d Z ed dd d Z
|
ed dd d!Z ed dd"d#Z ed dd$d%Z ed dd&d'Zed dd(d)Zed dd*d+Zed dd,d-Zed.dd/d0Zdd d1d2d3Zdd4d5d6d7Zdd d8d9d:Zd d;d<d=d>Zd
|
d?d@dAdBZdddCdDZdddEdFZdddGdHdIZd ddJdKZd ddLdMZ d ddNdOZ d.ddPdQZ dddRdSZ dddTdUZ dddVdWZ!dddXdYZ"d.dZd[d\d]Z#d^d_d[d`daZ$dddbdcddZ%ddZdbdedfZ&dgddhdiZ'dS )kÚDataFrameFormatterz;Class for processing dataframe formatting options and data.rd NTrX FÚ.rL úSequence[Hashable] | NonezColspaceArgType | Nonezbool | Sequence[str]rZ r[ zFormattersType | Noner úFloatFormatType | Noneú bool | Noner r r\ )ÚframeÚcolumnsÚ col_spacer r r` Ú
|
formattersrR rs ÚsparsifyÚ index_namesr r rå ræ ÚdecimalÚ bold_rowsÚescaperb c C sº || _ | |¡| _| |¡| _|| _|| _|| _| |¡| _ |
|
|¡| _ | | _ | |
|
¡| _| | _|| _|| _|| _| | _| | _|| _|| _| ¡ | _| ¡ | _| j | _| ¡ t | _ d S r« ) rò Ú_initialize_columnsró Ú_initialize_colspacerô r r r` Ú_initialize_formattersrõ Ú_initialize_justifyrR rs Ú_initialize_sparsifyrö Úshow_index_namesrø rù rú r r rå ræ Ú_calc_max_cols_fittedÚmax_cols_fittedÚ_calc_max_rows_fittedÚmax_rows_fittedÚtr_framer¥ r r )rf rò ró rô r r r` rõ rR rs rö r÷ r r rå ræ rø rù rú rg rg rh ri 4 s.
|
|
zDataFrameFormatter.__init__zlist[list[str]]rj c C s* | ¡ }| jr&| | j¡}| d|¡ |S )zP
|
Render a DataFrame to a list of columns (as lists of strings).
|
r )Ú_get_strcols_without_indexr r³ r r» )rf ÚstrcolsZ str_indexrg rg rh Ú get_strcolsc s
|
z DataFrameFormatter.get_strcolsc C s | j dkp| j dko| jS )NTr¥ )ræ Ú is_truncatedrv rg rg rh Úshould_show_dimensionso s
|
ÿz)DataFrameFormatter.should_show_dimensionsc C s t | jp | jS r« )rZ Úis_truncated_horizontallyr rv rg rg rh r u s z DataFrameFormatter.is_truncatedc C s t | jot| j| jkS r« )rZ r rn ró rv rg rg rh r y s z,DataFrameFormatter.is_truncated_horizontallyc C s t | jot| j| jkS r« )rZ r rn rò rv rg rg rh r } s z*DataFrameFormatter.is_truncated_verticallyc C s dt | j dt | jj dS )Nz
|
|
[z rows x z columns])rn rò ró rv rg rg rh Údimensions_info s z"DataFrameFormatter.dimensions_infoc C s t | jjS r« )Ú
|
_has_namesrò r rv rg rg rh Úhas_index_names
s z"DataFrameFormatter.has_index_namesc C s t | jjS r« )r rò ró rv rg rg rh Úhas_column_names s z#DataFrameFormatter.has_column_namesc C s t | j| j| jfS r« )Úallr r r rv rg rg rh Úshow_row_idx_names s z%DataFrameFormatter.show_row_idx_namesc C s t | j| j| jfS r« )r r r r rv rg rg rh Úshow_col_idx_names s z%DataFrameFormatter.show_col_idx_namesr c C s t | jpt| jt| jS r« )r r rn rò rv rg rg rh Úmax_rows_displayed s z%DataFrameFormatter.max_rows_displayed)rö rb c C s |d krt dS |S )Nzdisplay.multi_sparse©r )rf rö rg rg rh rÿ s z'DataFrameFormatter._initialize_sparsifyr) )rõ rb c C sT |d kr i S t | jjt |ks*t|tr.|S tdt | dt | jj dd S )NzFormatters length(ú+) should match DataFrame number of columns(rµ )rn rò ró r§ ÚdictÚ
|
ValueError)rf rõ rg rg rh rý s ÿz)DataFrameFormatter._initialize_formatters)rR rb c C s |d krt dS |S d S )Nzdisplay.colheader_justifyr )rf rR rg rg rh rþ « s z&DataFrameFormatter._initialize_justifyrB )ró rb c C s2 |d k r&t tt|}| j| | _|S | jjS d S r« )rE r r# rò ró )rf ró Úcolsrg rg rh rû ± s
|
z&DataFrameFormatter._initialize_columnsr% )rô rb c sÎ d kri }n¼t ttfrBd i}| fdd| jjD ¡ nt tr ¡ D ]&}|| jjkrT|dkrTtd| qT }nHt | jjt kr¸tdt dt | jj dt
|
t | jj }|S )Nrd c s i | ]
|
}| qS rg rg )rz Úcolumn©rô rg rh Ú
|
<dictcomp>Â s z;DataFrameFormatter._initialize_colspace.<locals>.<dictcomp>z,Col_space is defined for an unknown column: zCol_space length(r rµ ) r§ r r[ Úupdaterò ró r Úkeysr rn r Úzip)rf rô r r rg r rh rü » s$
|
ÿ ÿz'DataFrameFormatter._initialize_colspacec C s0 | ¡ s| jS t \}}| |¡r&|S | jS dS )z%Number of columns fitting the screen.N)Ú_is_in_terminalrå r Ú_is_screen_narrow)rf r½ ré rg rg rh r Ó s
|
|
z(DataFrameFormatter._calc_max_cols_fittedc C sP | ¡ r@t \}}| jdkr(|| ¡ S | |¡r8|}qF| j}n| j}| |¡S )z,Number of rows with data fitting the screen.r )r r r Ú _get_number_of_auxillary_rowsÚ_is_screen_shortÚ_adjust_max_rows)rf ré rë r rg rg rh r Þ s
|
|
|
z(DataFrameFormatter._calc_max_rows_fitted)r rb c C s( |r$t | j|kr$| jr$t| j|}|S )zºAdjust max_rows using display logic.
|
|
See description here:
|
https://pandas.pydata.org/docs/dev/user_guide/options.html#frequently-used-options
|
|
GH #37359
|
)rn rò r r )rf r rg rg rh r# ñ s z#DataFrameFormatter._adjust_max_rowsc C s t | jdkp| jdkS )z/Check if the output is to be shown in terminal.r )rZ rå r rv rg rg rh r ÿ s z"DataFrameFormatter._is_in_terminalc C s t | jdkot| jj|kS ©Nr )rZ rå rn rò ró )rf Ú max_widthrg rg rh r s z$DataFrameFormatter._is_screen_narrowc C s t | jdkot| j|kS r$ )rZ r rn rò )rf Z
|
max_heightrg rg rh r" s z#DataFrameFormatter._is_screen_shortc C s: d}d}|| }| j r(|t| j ¡ 7 }| jr6|d7 }|S )z?Get number of rows occupied by prompt, dots and dimension info.r )ræ rn r Ú
|
splitlinesr )rf Zdot_rowZ
|
prompt_rowZnum_rowsrg rg rh r! s z0DataFrameFormatter._get_number_of_auxillary_rowsc C s | j r| ¡ | jr | ¡ dS )zY
|
Check whether the frame should be truncated. If so, slice the frame up.
|
N)r Ú_truncate_horizontallyr Ú_truncate_verticallyrv rg rg rh r¥ s zDataFrameFormatter.truncatec C sÆ | j dk st| j d }|dkr| jjdd
d|
f }| jjdd
| d
f }t||fdd| _t| jttfr¼| jd|
| j| d
| _n&t t
|
| j }| jjdd
d|
f | _|| _ dS )z´Remove columns, which are not to be displayed and adjust formatters.
|
|
Attributes affected:
|
- tr_frame
|
- formatters
|
- tr_col_num
|
Nr r ©Zaxis) r r¨ r r rH r§ rõ ÚlistÚtupler r rå Z
|
tr_col_num)rf Zcol_numrO rP rg rg rh r' ! s
|
þ z)DataFrameFormatter._truncate_horizontallyc C s | j dk st| j d }|dkrb| jjd|
dd
f }| jj| d
dd
f }t||f| _n&tt| j}| jjd|
dd
f | _|| _dS )zRemove rows, which are not to be displayed.
|
|
Attributes affected:
|
- tr_frame
|
- tr_row_num
|
Nr r ) r r¨ r r rH r r r r )rf r ÚheadÚtailrg rg rh r( ; s
|
z'DataFrameFormatter._truncate_verticallyc
|
s g }t jsb jsbt jD ]>\}} |¡}t| jt j |d¡ j
|
d}| |¡ q |S t jrÆt t t j _t jt jkr´tdt j dt j ddd jD }n j¡} jrì|D ]}| d¡ qÜt jD ]\}}|| }tt j |d¡f fd d
|
|D } |¡}t| j| j
|
d }tt fd d
|
|D |} j
|
j|| jd }| || ¡ qö|S )Nr )ÚstringsrR Úminimumr zWriting z cols but got z aliasesc S s g | ]
|
}|gqS rg rg )rz Úlabelrg rg rh r| d s zADataFrameFormatter._get_strcols_without_index.<locals>.<listcomp>rd c 3 s | ]} j |¡V qd S r« ©r rn rÛ rv rg rh r o s z@DataFrameFormatter._get_strcols_without_index.<locals>.<genexpr>)r/ r c 3 s | ]} j |¡V qd S r« r1 rÛ rv rg rh r v s r¸ )r5 r Ú enumerater Ú
|
format_colÚ_make_fixed_widthrR r rô rÕ r r r r r[ rn ró r Ú _get_formatted_column_labelsr Úmax)
|
rf r r{ rÖ r Ú str_columnsrÜ ZcheaderZheader_colwidthrÆ rg rv rh r M sR
|
ü
|
ÿ ÿÿ
|
ÿ z-DataFrameFormatter._get_strcols_without_indexrr )r{ rb c C sL | j }| |¡}t|jd d
|f j|| j| j| j |j | ¡| j
|
| j dS )N)rs r` rÈ rø r´ ) r Ú_get_formatterrt r rª rs r` rô rÕ ró rø r )rf r{ rò Ú formatterrg rg rh r3 | s
|
ùz DataFrameFormatter.format_colú str | intúCallable | Nonec C s` t | jttfr2t|r,tt|}| j| S d S n*t|rN|| jkrN| j| }| j |d ¡S d S r« ) r§ rõ r* r+ r3 r r ró rÕ )rf r{ rg rg rh r8 s
|
|
|
z!DataFrameFormatter._get_formatter)rò rb c sü ddl m} |j}t|tr¼|jddd}tt| }jj j
|
}t dd |j D t t|tt| fddttfd d|D }jr¨t|r¨||}d
|
d t| D }n<| ¡ }jj }t t|tt| fd d t|D }|S ) Nr )Úsparsify_labelsF)rö r¼ c s s | ] }|j V qd S r« )Z is_floating)rz Úlevelrg rg rh r s zBDataFrameFormatter._get_formatted_column_labels.<locals>.<genexpr>c s" |j kr | r s d| S |S )Nú )rõ )rÜ Úy)Ú need_leadspÚrestrict_formattingrf rg rh Ú space_format£ s ÿþýzEDataFrameFormatter._get_formatted_column_labels.<locals>.space_formatc 3 s" | ] fd d D V qdS )c s g | ]} |qS rg rg )rz r? )rB rÜ rg rh r| s zMDataFrameFormatter._get_formatted_column_labels.<locals>.<genexpr>.<listcomp>Nrg )rz )rB ©rÜ rh r s c S s g | ] }t |qS rg )r* rÛ rg rg rh r| ² s zCDataFrameFormatter._get_formatted_column_labels.<locals>.<listcomp>c s0 g | ](\}} |¡s& | r&d | n|gqS )r> )r8 )rz r{ rÜ )r@ rf rg rh r| · s ÿ)Zpandas.core.indexes.multir< ró r§ rC r° r* r rò Údtypesrª r¯ Úlevelsr Úmapr6 rö rn r2 )rf rò r< ró Z fmt_columnsrD r7 rg )r@ rA rf rB rh r5 s,
|
|
ÿ þz/DataFrameFormatter._get_formatted_column_labelsc sÄ dd j ¡ D |j}|j} d¡}t|trL|jjdj |d}n|jj |dg} fdd|D }j
|
j d | d
|
¡}j r¢d d ¡ D }n d g|j }jr¼|| S |S d S )Nc S s i | ]\}}|t t|qS rg )r r )rz ÚkÚvrg rg rh r Á s z;DataFrameFormatter._get_formatted_index.<locals>.<dictcomp>Ú __index__F)rö r¼ r® r9 )r r9 c
|
s. g | ]&}t tt|d dd¡jdqS )rO rd r )rR r/ r )r+ r4 r* rÕ r rÛ ©rô rf rg rh r| Ð s û
|
ÿÿz;DataFrameFormatter._get_formatted_index.<locals>.<listcomp>r rm c S s g | ] }t |qS rg ©r[ rÛ rg rg rh r| Ý s rd )r )rô Úitemsr ró r8 r§ rC r° rö r r r¼ Úsplitr Ú_get_column_name_listZnlevelsr )rf rò r ró Úfmtr² ZadjoinedZ
|
col_headerrg rJ rh r³ ¾ s,
|
|
ü ú z'DataFrameFormatter._get_formatted_indexzlist[Hashable]c C sL g }| j j}t|tr.| dd |jD ¡ n| |jd kr@dn|j¡ |S )Nc s s | ]}|d krdn|V qd S rc rg r¬ rg rg rh r ê s z;DataFrameFormatter._get_column_name_list.<locals>.<genexpr>rd )rò ró r§ rC Úextendr® r r )rf r® ró rg rg rh rN æ s
|
z(DataFrameFormatter._get_column_name_list)NNTTrX NNNNTNNNFrî FT)(r
r r Ú__doc__rN rV ri r Úpropertyr
|
r r r r r r r r r rÿ rý rþ rû rü r r r# r r r" r! r¥ r' r( r r3 r8 r5 r³ rN rg rg rg rh rí . s~ í4/
|
|
/ )(rí c @ s¨ e Zd ZdZdddddZd(d d
|
d d
|
d d
|
d d d
|
d
|
d
|
d ddZd)d d
|
dd dd
|
d d
|
dddZd*d d
|
dd
|
dddZd+d d
|
d d!d"d d#dd d
|
dd
|
d d
|
d d$d
|
d%d&d'ZdS ),ÚDataFrameRendereraJ Class for creating dataframe output in multiple formats.
|
|
Called in pandas.core.generic.NDFrame:
|
- to_csv
|
- to_latex
|
|
Called in pandas.core.frame.DataFrame:
|
- to_html
|
- to_string
|
|
Parameters
|
----------
|
fmt : DataFrameFormatter
|
Formatter with the formatting options.
|
rí r\ )rO rb c C s
|
|| _ d S r« )rO )rf rO rg rg rh ri s zDataFrameRenderer.__init__NFú"FilePath | WriteBuffer[str] | Noner rZ z str | tuple[str, str] | None) r^ Ú column_formatÚ longtabler¿ Ú multicolumnÚmulticolumn_formatÚmultirowÚcaptionr0 Úpositionrb c C s> ddl m} | | j||||||| |
|
d } | ¡ } t| ||dS )zU
|
Render a DataFrame to a LaTeX tabular/longtable environment output.
|
r )ÚLatexFormatter)rV rU rW rX rY rZ r0 r[ ©r^ r¿ )Zpandas.io.formats.latexr\ rO r Úsave_to_buffer)rf r^ rU rV r¿ rW rX rY rZ r0 r[ r\ Zlatex_formatterÚstringrg rg rh Úto_latex s ÷ zDataFrameRenderer.to_latexzstr | list | tuple | Nonezint | bool | None)r^ r¿ ÚclassesÚnotebookÚborderÚtable_idÚ render_linksrb c C sF ddl m}m} |r| n|}
|
|
|
| j||||d} | ¡ } t| ||dS )uJ
|
Render a DataFrame to a html table.
|
|
Parameters
|
----------
|
buf : str, path object, file-like object, or None, default None
|
String, path object (implementing ``os.PathLike[str]``), or file-like
|
object implementing a string ``write()`` function. If None, the result is
|
returned as a string.
|
encoding : str, default âutf-8â
|
Set character encoding.
|
classes : str or list-like
|
classes to include in the `class` attribute of the opening
|
``<table>`` tag, in addition to the default "dataframe".
|
notebook : {True, False}, optional, default False
|
Whether the generated HTML is for IPython Notebook.
|
border : int
|
A ``border=border`` attribute is included in the opening
|
``<table>`` tag. Default ``pd.options.display.html.border``.
|
table_id : str, optional
|
A css id is included in the opening `<table>` tag if specified.
|
render_links : bool, default False
|
Convert URLs to HTML links.
|
r )Ú HTMLFormatterÚNotebookFormatter)ra rc rd re r] )Zpandas.io.formats.htmlrf rg rO r r^ ) rf r^ r¿ ra rb rc rd re rf rg ZKlassZhtml_formatterr_ rg rg rh Úto_html$ s " ûzDataFrameRenderer.to_htmlr )r^ r¿ rç rb c C s0 ddl m} || j|d}| ¡ }t|||dS )u%
|
Render a DataFrame to a console-friendly tabular output.
|
|
Parameters
|
----------
|
buf : str, path object, file-like object, or None, default None
|
String, path object (implementing ``os.PathLike[str]``), or file-like
|
object implementing a string ``write()`` function. If None, the result is
|
returned as a string.
|
encoding: str, default âutf-8â
|
Set character encoding.
|
line_width : int, optional
|
Width to wrap a line in characters.
|
r )ÚStringFormatter)rç r] )Zpandas.io.formats.stringri rO r r^ )rf r^ r¿ rç ri Zstring_formatterr_ rg rg rh r W s zDataFrameRenderer.to_stringú,ÚwÚinferú"TÚstrictz7FilePath | WriteBuffer[bytes] | WriteBuffer[str] | Noner[ rï zIndexLabel | Noner& r+ )Ú path_or_bufr¿ Úsepró Ú index_labelr¹ Ú compressionre Ú quotecharÚlineterminatorÚ chunksizeÚ date_formatÚ doublequoteÚ
|
escapecharÚerrorsÚstorage_optionsrb c C s ddl m} |dkr d}t }nd}|||
|
||||||||| | | | ||| jd}| ¡ |r~t|tsjt| ¡ }| ¡ |S dS )z;
|
Render dataframe as comma-separated file.
|
r )Ú CSVFormatterNTF)ro rt rp r¿ ry rr re r rq r¹ ru rs rv rw rx rz r9 ) Zpandas.io.formats.csvsr{ r rO Úsaver§ r¨ ÚgetvalueÚclose)rf ro r¿ rp ró rq r¹ rr re rs rt ru rv rw rx ry rz r{ Zcreated_bufferZ csv_formatterÚcontentrg rg rh Úto_csvq s> ïzDataFrameRenderer.to_csv)
|
NNFNFNFNNN)NNNFNNF)NNN)NNrj NNrk rl Nrm NNNTNrn N) r
r r rQ ri r` rh r r rg rg rg rh rS ð sT õ$" ø 5 ü ïrS r[ rT r )r_ r^ r¿ rb c
|
C sL t ||d6}| | ¡ |dkr4| ¡ W 5 Q R £ S W 5 Q R £ dS Q R X dS )zQ
|
Perform serialization. Write to buf or return as string if buf is None.
|
)r¿ N)Ú
|
get_bufferÚwriter} )r_ r^ r¿ Úfrg rg rh r^ s
|
|
r^ zIGenerator[WriteBuffer[str], None, None] | Generator[StringIO, None, None])r^ r¿ rb c c s | dk rt | } nt } |dkr&d}nt| ts8tdt| drJ| V nBt| trtt| t| d|dd }|V W 5 Q R X ntddS ) z
|
Context manager to open, yield and close buffer for filenames or Path-like
|
objects, otherwise yield buf unchanged.
|
Nzutf-8z1buf is not a file name and encoding is specified.r rk rd )r¿ Únewlinez1buf is not a file name and it has no write method) rJ r r§ r[ r ÚhasattrrI ÚopenÚ TypeError)r^ r¿ r rg rg rh r ½ s
|
|
|
|
r rX rP rî Tr r; rð r zstr | int | Nonerñ rr ) r r9 rs r` ÚdigitsrÈ rR rø r´ re Úfallback_formatterrb c C s t | jrt} n`t| jtr"t} nNt| jr2t} n>t| jrBt } n.t
|
| jsVt | jr\t } nt | jrlt} nt} |dkr|d}|dkrtd}|dkrtd}| | ||||||||| |
|
d } | ¡ S )a{
|
Format an array for printing.
|
|
Parameters
|
----------
|
values
|
formatter
|
float_format
|
na_rep
|
digits
|
space
|
justify
|
decimal
|
leading_space : bool, optional, default True
|
Whether the array should be formatted with a leading space.
|
When an array as a column of a Series or DataFrame, we do want
|
the leading space to pad between columns.
|
|
When formatting an Index subclass
|
(e.g. IntervalIndex._format_native_types), we don't want the
|
leading space since it should be left-aligned.
|
fallback_formatter
|
|
Returns
|
-------
|
List[str]
|
Né r údisplay.precision)
|
r r` rs r9 rÈ rR rø r´ re r )r/ r ÚDatetime64Formatterr§ r9 ÚDatetime64TZFormatterr8 ÚTimedelta64Formatterr0 ÚExtensionArrayFormatterr2 r. ÚFloatArrayFormatterr4 ÚIntArrayFormatterÚGenericArrayFormatterr Ú
|
get_result) r r9 rs r` r rÈ rR rø r´ re r Z fmt_klassZfmt_objrg rg rh rt ã sB )
|
|
|
|
õrt c @ sP e Zd Zddd d
|
d d d d d dddd
|
dd ddZddddZddddZdS ) r é NrX r rP rî Tr r r; r[ r: rð r rZ rñ r\ ) r r r9 r` rÈ rs rR rø re Ú fixed_widthr´ r rb c C sL || _ || _|| _|| _|| _|| _|| _|| _| | _|
|
| _ | | _
|
| | _ d S r« ) r r r` rÈ r9 rs rR rø re r r´ r ) rf r r r9 r` rÈ rs rR rø re r r´ r rg rg rh ri 6 s z GenericArrayFormatter.__init__rr rj c C s | ¡ }t|| jS r« )Ú_format_stringsr4 rR )rf r rg rg rh r R s z GenericArrayFormatter.get_resultc s j d kr0td}|d kr6tdfdd}nj }jd k rHj n6jd k rZj n$jd k oljtk}ttjd|d fdd}t j
|
d d
|
}t |t j s®td t |t¡}|t jt|ttd t|jd @ }j}|d krö| ¡ }g }t|D ]\} }
|
|| s|s&jd k r<| d||
|
¡ nD|| rV| ||
|
¡ n*|dkrfd} nd} | | j ||
|
d¡ q|S )Nr r c s t | d ddS )Nz .Údr )Ú_trim_zeros_single_floatrC )Ú precisionrg rh Ú<lambda>[ s ÿz7GenericArrayFormatter._format_strings.<locals>.<lambda>r¡ )r¤ Ú quote_stringsc sª j d k rvt| rvt| rvz<| d kr*W dS | tkr<ttW S | tksNt | ¡rTW dS W n tt fk
|
rn Y nX j S t
|
| t rt| S t
|
| t rt | S t | S d S )Nr\ r )r` r7 r: r r[ r ÚnpZisnatr r r§ r@ r? ÚreprrC )r9 rf rg rh Ú_formatm s
|
|
|
|
z6GenericArrayFormatter._format_strings.<locals>._formatT©Z extract_numpyz<ExtensionArray formatting should use ExtensionArrayFormatterr r) r> Fz{v}z {v}©rH ) rs r r9 r re r r rK r© rA r r§ r Úndarrayr r Z map_inferr1 r r; r+ Úrangern Úshaper´ r¯ r2 r r° ) rf rs r r ÚvalsÚinferredZ is_float_typer´ r r{ rH Ztplrg )r9 r rf rh r V sR
|
|
|
ý ÿ þÿ
|
|
z%GenericArrayFormatter._format_strings) r NrX r NrP rî NTTN)r
r r ri r r rg rg rg rh r 5 s ó( r c sR e Zd Zdd fdd Zddddd d
|
d Zd dd dZddddZ ZS )r r\ rj c sD t j|| | jd k r@| jd kr@d| _t| jr@| j| _d | _d S )NF)rÐ ri rs r9 r Úcallable)rf ÚargsrÊ rÓ rg rh ri ¦ s
|
z FloatArrayFormatter.__init__Nrð z float | Noner )rs Ú thresholdrb c sl dkrj r"fdd n fdd jdkrH fddn dkrXS fdd }|S )
|
z;Returns a function to be applied on each value to format itNc s$ d k s t t| r | dS jS )N©Úvalue)r¨ r; r` r )rs rf rg rh Úbase_formatterÄ s
|
ÿ ýz<FloatArrayFormatter._value_formatter.<locals>.base_formatterc s t | rt| S jS r« )r; r[ r` r rv rg rh r« Ñ s rî c s | djd¡S )Nrî r )Úreplacerø r )r« rf rg rh Údecimal_formatterÖ s z?FloatArrayFormatter._value_formatter.<locals>.decimal_formatterc s0 t | r&t| kr | S dS njS d S )Ng )r; Úabsr` r© )r rf r¨ rg rh r9 ß s
|
|
z7FloatArrayFormatter._value_formatter.<locals>.formatter)rs rø )rf rs r¨ r9 rg )r« r rs rf r¨ rh Ú_value_formatter² s
|
z$FloatArrayFormatter._value_formatterú
|
np.ndarrayc
|
sp dddddd j dk r. jj jS jr>tdnd fd d
|
}jdkrjrjd krrd }nd }t|jj d}qj}n fdd}||}js®|S t
|
|dkrÜt dd |D }|j d k}nd}t j dd: t j¡}|dk ¡ }|dj k |dk@ ¡ } W 5 Q R X | s>|rl|rljd krPd}nd}t|jj d}||}|S ) z
|
Returns the float values converted into strings using
|
the parameters given at initialisation, as a numpy array
|
r" r r[ )r r9 r` c s< t | }t fddt| ¡ | ¡ D ¡ | j¡}|S )Nc s g | ]\}}|s |nqS rg rg )rz ÚvalÚm©r9 r` rg rh r| ó s ÿzWFloatArrayFormatter.get_result_as_array.<locals>.format_with_na_rep.<locals>.<listcomp>)r: r Úarrayr ÚravelZreshaper£ )r r9 r` ÚmaskÚ formattedrg r³ rh Úformat_with_na_repð s þÿûzCFloatArrayFormatter.get_result_as_array.<locals>.format_with_na_repNzdisplay.chop_thresholdc sx | ¡}jdkr"dj }nj}j}t|} |||}jrt|rZt|j}n t|j}t j
|
|ddS |S )NrO r> Úobject©r ) r¯ rR r` r r. r Ú_trim_zeros_complexrø Ú_trim_zeros_floatr Úasarray)rs r9 r` r Z
|
is_complexr ©r¸ rf r¨ rg rh Úformat_values_with s
|
zCFloatArrayFormatter.get_result_as_array.<locals>.format_values_withTz{value: .{digits:d}f}z{value:.{digits:d}f})r c s
|
j | S r« )rs r© rv rg rh r ( ó z9FloatArrayFormatter.get_result_as_array.<locals>.<lambda>r c s s | ]}t |V qd S r« r rÛ rg rg rh r 4 s z:FloatArrayFormatter.get_result_as_array.<locals>.<genexpr>é FÚignore©Úinvalidg .Aé
|
z{value: .{digits:d}e}z{value:.{digits:d}e})r9 r r` r r rs r´ r r° r rn r6 r Úerrstater® r¯ )
|
rf r¿ Zfmt_strrs Zformatted_valuesÚmaxlenZtoo_longZabs_valsZhas_large_valuesZhas_small_valuesrg r¾ rh Úget_result_as_arrayê sD
|
|
|
|
|
ÿ z'FloatArrayFormatter.get_result_as_arrayrr c C s t | ¡ S r« )r* rÈ rv rg rg rh r M s z#FloatArrayFormatter._format_strings)NN)r
r r ri r¯ rÈ r rß rg rg rÓ rh r ¥ s ý8cr c @ s e Zd ZddddZdS )r rr rj c s> | j dkrdd }ndd }| jp$| fdd| jD }|S )NFc S s | dj | dS )Nr rC ©r° rC rg rg rh r T rÀ z3IntArrayFormatter._format_strings.<locals>.<lambda>c S s | dj | dS )Nz drC rÉ rC rg rg rh r V rÀ c s g | ] } |qS rg rg rÛ ©r9 rg rh r| X s z5IntArrayFormatter._format_strings.<locals>.<listcomp>)r´ r9 r )rf Z formatter_strr rg rÊ rh r R s
|
|
|
z!IntArrayFormatter._format_stringsN©r
r r r rg rg rg rh r Q s r c s8 e Zd Zd ddddd fdd Zd d
|
d d Z ZS )r r Nz3np.ndarray | Series | DatetimeIndex | DatetimeArrayr[ r\ )r Únat_reprv rb c s t j|f| || _|| _d S r« )rÐ ri rÌ rv )rf r rÌ rv rÊ rÓ rg rh ri ] s z Datetime64Formatter.__init__rr rj c sZ j }t|tst|} jdk r>t jr> fdd|D S |jj j jd}| ¡ S )z&we by definition have DO NOT have a TZNc s g | ]} |¡qS rg rÊ rÛ rv rg rh r| p s z7Datetime64Formatter._format_strings.<locals>.<listcomp>)r` rv )
|
r r§ rF r9 r¦ Ú_dataZ_format_native_typesrÌ rv Útolist)rf r r rg rv rh r h s
|
ÿz#Datetime64Formatter._format_strings)r N©r
r r ri r rß rg rg rÓ rh r \ s ü r c @ s e Zd ZddddZdS )r rr rj c C s| t | jdd}| j}d }|d kr,|jdd}t|tr@| ¡ }n
|
t |¡}t ||| j
|
| j | j | j | j| j| j| j|d }|S )NTr )Zboxed) rs r` r rÈ rR rø r´ re r )rA r r9 Ú
|
_formatterr§ r< ru r r½ rt rs r` r rÈ rR rø r´ re )rf r r9 r r´ r rg rg rh r y s,
|
|
|
õ z'ExtensionArrayFormatter._format_stringsNrË rg rg rg rh r x s r z np.ndarray | Sequence[float])Ú percentilesrb c C sX t | ¡} t jdd2 t| r<t | dk¡r<t | dk¡sDtdW 5 Q R X d| } | ¡ t¡}t || ¡}t |¡r| t
|
¡}dd |D S t | ¡}|d dkr°|d nd }|d
|
dk rÌd|d
|
nd }t t t t j|||d ¡¡¡ t¡ }td|}t j| td }| | ¡ t¡ t
|
¡||< | | |¡ t
|
¡|| < d d |D S )a
|
Outputs rounded and formatted percentiles.
|
|
Parameters
|
----------
|
percentiles : list-like, containing floats from interval [0,1]
|
|
Returns
|
-------
|
formatted : list of strings
|
|
Notes
|
-----
|
Rounding precision is chosen so that: (1) if any two elements of
|
``percentiles`` differ, they remain different after rounding
|
(2) no entry is *rounded* to 0% or 100%.
|
Any non-integer is always rounded to at least 1 decimal place.
|
|
Examples
|
--------
|
Keeps all entries different after rounding:
|
|
>>> format_percentiles([0.01999, 0.02001, 0.5, 0.666666, 0.9999])
|
['1.999%', '2.001%', '50%', '66.667%', '99.99%']
|
|
No element is rounded to 0% or 100% (unless already equal to it).
|
Duplicates are allowed:
|
|
>>> format_percentiles([0, 0.5, 0.02001, 0.5, 0.666666, 0.9999])
|
['0%', '50%', '2.0%', '50%', '66.67%', '99.99%']
|
r rà r r z/percentiles should all be in the interval [0,1]éd c S s g | ] }|d qS ©ú%rg ry rg rg rh r| Ë s z&format_percentiles.<locals>.<listcomp>Néÿÿÿÿ)Úto_beginÚto_endrº c S s g | ] }|d qS rÓ rg ry rg rg rh r| Ú s )r r½ rÆ r6 r r ÚroundÚastyper Úiscloser[ ÚuniqueÚfloorÚlog10r Zediff1dr6 Z
|
empty_liker¹ )rÑ Zpercentiles_round_typeZint_idxÚoutZ unique_pctsrÖ r× Úprecrg rg rh Úformat_percentiles s8 "
|
ÿ þ ý
|
|
|
ÿþ
|
rà z2np.ndarray | DatetimeArray | Index | DatetimeIndexrZ ©r rb c C s~ t | ts| ¡ } t | ttfs(t| } | jd k r6dS | j}|tk}t| j }t
|
|}t ||| dk¡ ¡ dk}|rzdS dS )NFr T)r§ rB rµ r= rF ÚtzZasi8r r r r r Ú logical_andr× )r Ú
|
values_intÚconsider_valuesZresoZppdÚ even_daysrg rg rh Ú is_dates_onlyÝ s
|
|
|
rç r zNaTType | Timestamp)rÜ rÌ rb c C s | t kr |S t| S r« )r r[ )rÜ rÌ rg rg rh Ú_format_datetime64ö s rè )rÜ rÌ rv rb c C s& t | tr|S |r | |¡S | jS d S r« )r§ r! ÚstrftimeZ
|
_date_repr)rÜ rÌ rv rg rg rh Ú_format_datetime64_dateonlyÿ s
|
|
|
rê r )Úis_dates_only_rÌ rv rb c s" | r fddS fddS dS )z]Return a formatter callable taking a datetime64 as input and providing
|
a string as outputc s t | dS )N)rÌ rv )rê rC ©rv rÌ rg rh r s ÿz'get_format_datetime64.<locals>.<lambda>c s t | dS )N©rÌ )rè rC rí rg rh r rÀ Nrg )rë rÌ rv rg rì rh Úget_format_datetime64 s rî z*np.ndarray | DatetimeArray | DatetimeIndex)r rv rb c C s6 t | tjr | jdkr | ¡ } t| }|r2|p0dS |S )z6given values and a date_format, return a string formatr z%Y-%m-%d)r§ r r¡ Úndimrµ rç )r rv Úidorg rg rh Ú!get_format_datetime64_from_values s rñ c @ s e Zd ZddddZdS )r rr rj c s> | j t¡}t|}| jp&t|| jd fdd|D }|S )zwe by definition have a TZ)rv c s g | ] } |qS rg rg rÛ rÊ rg rh r| 4 s z9Datetime64TZFormatter._format_strings.<locals>.<listcomp>)r rÙ r¹ rç r9 rî rv )rf r rð r rg rÊ rh r - s ÿz%Datetime64TZFormatter._format_stringsNrË rg rg rg rh r , s r c s8 e Zd Zdddddd fdd Zd
|
d d d Z ZS )r r Fznp.ndarray | TimedeltaIndexr[ rZ r\ ©r rÌ Úboxrb c s t j|f| || _|| _d S r« )rÐ ri rÌ ró )rf r rÌ ró rÊ rÓ rg rh ri : s z Timedelta64Formatter.__init__rr rj c s. | j pt| j| j| jd fdd| jD S )N)rÌ ró c s g | ] } |qS rg rg rÛ rÊ rg rh r| I s z8Timedelta64Formatter._format_strings.<locals>.<listcomp>)r9 Úget_format_timedelta64r rÌ ró rv rg rÊ rh r E s ÿz$Timedelta64Formatter._format_strings)r FrÏ rg rg rÓ rh r 9 s ü r Fz,np.ndarray | TimedeltaIndex | TimedeltaArrayz str | floatrò c
|
s^ | tj¡}|tk}d}|| dk}t ||¡}| ¡ dk}|rFdnd fdd} | S )z
|
Return a formatter function for a range of timedeltas.
|
These will all have the same format argument
|
|
If box, then show the return in quotes
|
l "R: r NÚlongc sN | d kst | r t| r S t| ts.t| } | jd} rJd| d}|S )NrÉ ú')r7 r: r§ r Z
|
_repr_base)rÜ r ©ró r° rÌ rg rh rÐ k s
|
z*get_format_timedelta64.<locals>._formatter)Úviewr Úint64r rã r× )
|
r rÌ ró rä rå Z one_day_nanosZ not_midnightZbothræ rÐ rg r÷ rh rô L s rô zTextAdjustment | None)r. rR r/ r rb c s® t | dks|dkr| S |d kr(t n| t fdd| D |d k rTt|tdd k rpkrpddd fdd fd
|
d | D } j| |d }|S ) Nr r c 3 s | ]} |¡V qd S r« r rÛ )Ú
|
adjustmentrg rh r s z$_make_fixed_width.<locals>.<genexpr>rã r[ )rÜ rb c s6 d k r2dk | ¡k@ r2| d d
d } | S )Nr¶ r· r rC )rú Úconf_maxrÆ rg rh Újust s z _make_fixed_width.<locals>.justc s g | ] } |qS rg rg rÛ )rü rg rh r| s z%_make_fixed_width.<locals>.<listcomp>r¸ )rn r r6 r rR )r. rR r/ r r rg )rú rû rü rÆ rh r4 { s
|
r4 r° )Ú str_complexesrø rb c sD fdd| D }dd |D }t |fddt||D }|S )z
|
Separates the real and imaginary parts from the complex number, and
|
executes the _trim_zeros_float method on each of those.
|
c s$ g | ] }d tt d|¡ ¡qS )rd z([j+-]))r r¼ ÚrerM rÛ )rø rg rh r| ¢ s ÿz'_trim_zeros_complex.<locals>.<listcomp>c S s g | ] }t |qS rg r )rz Úsrg rg rh r| ¨ s c s g | ]\}}|d |d d d
| d d ||d d d |d d
||d d d
| d d |d qS )Nr r Ú0rÕ rg )rz rÿ rG )Ú
|
max_lengthrg rh r| ª s úÿ"þýüû)r6 r )rý rø ÚtrimmedÚlengthsZpaddedrg )rø r rh r» s
|
þ
|
ù r» )Ú str_floatrb c C s | d¡} | d¡r | d7 } | S )zX
|
Trims trailing zeros after a decimal point,
|
leaving just one if necessary.
|
r rî )ÚrstripÚendswith)r rg rg rh r ¶ s
|
|
r únp.ndarray | list[str])Ú
|
str_floatsrø rb c sp | }t d d¡ddfdd dddfd d
|
}||rXfd d |D }q< fd d |D }|S )z
|
Trims the maximum number of trailing zeros equally from
|
all numbers containing decimals, leaving just one if
|
necessary.
|
z^\s*[\+-]?[0-9]+\z[0-9]*$rZ rj c s t | ¡d k S r« )rþ ÚmatchrC )Ú number_regexrg rh Úis_number_with_decimalÍ s z1_trim_zeros_float.<locals>.is_number_with_decimalr rá c s0 fdd| D }t |dko.tdd |D S )zñ
|
Determine if an array of strings should be trimmed.
|
|
Returns True if all numbers containing decimals (defined by the
|
above regular expression) within the array end in a zero, otherwise
|
returns False.
|
c s g | ]} |r|qS rg rg rÛ ©r rg rh r| Ø s z:_trim_zeros_float.<locals>.should_trim.<locals>.<listcomp>r c s s | ]}| d ¡V qdS )r N©r rÛ rg rg rh r Ù s z9_trim_zeros_float.<locals>.should_trim.<locals>.<genexpr>)rn r )r Znumbersr rg rh Ú should_trimÐ s z&_trim_zeros_float.<locals>.should_trimc s$ g | ] } |r |d d
n|qS )NrÕ rg rÛ r rg rh r| Ü s z%_trim_zeros_float.<locals>.<listcomp>c s* g | ]"}|r"| ¡r"|d n|qS )r r rÛ )rø r rg rh r| ß s ÿ)rþ Úcompile)r rø r r r rg )rø r r
|
rh r¼ Â s þr¼ rB )r rb c C s$ t | trtj| j S | jd k S d S r« )r§ rC ÚcomZ any_not_noner® r )r rg rg rh r æ s
|
r c @ s\ e Zd ZdZdddddddd d
|
d d d ddddddZd!ddddddZd d d d d ZdS )"Ú EngFormatterzl
|
Formats float values according to engineering format.
|
|
Based on matplotlib.ticker.EngFormatter
|
r? ÚzÚar ÚpÚnÚur² rd rG ÚMÚGÚTÚPÚEÚZÚY)ièÿÿÿiëÿÿÿiîÿÿÿiñÿÿÿiôÿÿÿi÷ÿÿÿiúÿÿÿéýÿÿÿr r¶ rÁ é r é é é é NFr rZ r\ ©ÚaccuracyÚuse_eng_prefixrb c C s || _ || _d S r« ©r% r& )rf r% r& rg rg rh ri s zEngFormatter.__init__Úfloatr[ )Únumrb c
|
C s t t|}t |¡rdS t |¡r(dS d}|dk r>d}| }|dkrft tt | ¡ d ¡d }nt d}| t | j
|
¡ ¡}| t| j
|
¡ ¡}t|}| j r°| j
|
| }n$|dk rÈd| d}n d |d}|| d
|
| }| j d krôd }nd | j dd}|j||d} | S )añ
|
Formats a number in engineering notation, appending a letter
|
representing the power of 1000 of the original number. Some examples:
|
>>> format_eng = EngFormatter(accuracy=0, use_eng_prefix=True)
|
>>> format_eng(0)
|
' 0'
|
>>> format_eng = EngFormatter(accuracy=1, use_eng_prefix=True)
|
>>> format_eng(1_000_000)
|
' 1.0M'
|
>>> format_eng = EngFormatter(accuracy=2, use_eng_prefix=False)
|
>>> format_eng("-1e-6")
|
'-1.00E-06'
|
|
@param num: the value to represent
|
@type num: either a numeric value or a string that can be converted to
|
a numeric value (as per decimal.Decimal constructor)
|
|
@return: engineering formatted string
|
rX Úinfr r rÕ r¶ zE-Z02dzE+rÅ Nz{mant: g}{prefix}z{mant: .r z
|
f}{prefix})ÚmantÚprefix)r r[ Úis_nanÚ is_infiniter ÚmathrÜ rÝ r r6 Ú ENG_PREFIXESr r& r% r° )
|
rf r) ZdnumÚsignZpow10Z int_pow10r, r+ Z
|
format_strr· rg rg rh Ú__call__ s4
|
|
|
zEngFormatter.__call__)NF)r
r r rQ r0 ri r2 rg rg rg rh r í s. ï ÿr r¶ r r\ r$ c C s t dt| | dS )a
|
Format float representation in DataFrame with SI notation.
|
|
Parameters
|
----------
|
accuracy : int, default 3
|
Number of decimal digits after the floating point.
|
use_eng_prefix : bool, default False
|
Whether to represent a value with SI prefixes.
|
|
Returns
|
-------
|
None
|
|
Examples
|
--------
|
>>> df = pd.DataFrame([1e-9, 1e-3, 1, 1e3, 1e6])
|
>>> df
|
0
|
0 1.000000e-09
|
1 1.000000e-03
|
2 1.000000e+00
|
3 1.000000e+03
|
4 1.000000e+06
|
|
>>> pd.set_eng_float_format(accuracy=1)
|
>>> df
|
0
|
0 1.0E-09
|
1 1.0E-03
|
2 1.0E+00
|
3 1.0E+03
|
4 1.0E+06
|
|
>>> pd.set_eng_float_format(use_eng_prefix=True)
|
>>> df
|
0
|
0 1.000n
|
1 1.000m
|
2 1.000
|
3 1.000k
|
4 1.000M
|
|
>>> pd.set_eng_float_format(accuracy=1, use_eng_prefix=True)
|
>>> df
|
0
|
0 1.0n
|
1 1.0m
|
2 1.0
|
3 1.0k
|
4 1.0M
|
|
>>> pd.set_option("display.float_format", None) # unset option
|
r N)r r r' rg rg rh Úset_eng_float_formatN s 7r3 rd zbool | object | strzlist[dict[int, int]])rE Úsentinelrb c C s t | dkrg S dgt | d }g }| D ]b}d}i }t|D ]2\}}|| rX||krXq>d||< || ||< |}q>t || ||< | |¡ q*|S )a
|
For each index in each level the function returns lengths of indexes.
|
|
Parameters
|
----------
|
levels : list of lists
|
List of values on for level.
|
sentinel : string, optional
|
Value which states that no new index starts on there.
|
|
Returns
|
-------
|
Returns list of maps. For each level returns map of indexes (key is index
|
in row and value is length of index).
|
r TF)rn r2 r ) rE r4 Úcontrolr r= Ú
|
last_indexr r{ Úkeyrg rg rh Úget_level_lengths s r8 zWriteBuffer[str])r^ Úlinesrb c C s4 t dd |D r dd |D }| d |¡¡ dS )z
|
Appends lines to a buffer.
|
|
Parameters
|
----------
|
buf
|
The buffer to write to
|
lines
|
The lines to append.
|
c s s | ]}t |tV qd S r« )r§ r[ rÛ rg rg rh r ¾ s z#buffer_put_lines.<locals>.<genexpr>c S s g | ] }t |qS rg rK rÛ rg rg rh r| ¿ s z$buffer_put_lines.<locals>.<listcomp>rm N)r¯ r r )r^ r9 rg rg rh Úbuffer_put_lines³ s r: )NN)N) NrX NNrP rî TNN)r )r N)r N)r F)rP NN)rî )rî )r¶ F)rd )rQ Ú
|
__future__r Ú
|
contextlibr Úcsvr r rø r Ú functoolsr Úior r/ rþ Úshutilr Útypingr
|
r r r r r r r r r r r Ú unicodedatar Únumpyr Zpandas._config.configr r Z pandas._libsr Zpandas._libs.missingr Zpandas._libs.tslibsr r r r r r Zpandas._libs.tslibs.nattyper! Zpandas._typingr" r# r$ r% r& r' r( r) r* r+ r, Zpandas.core.dtypes.commonr- r. r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 Zpandas.core.dtypes.dtypesr9 Zpandas.core.dtypes.missingr: r; Zpandas.core.arraysr< r= r> Zpandas.core.arrays.string_r? Zpandas.core.baser@ Zpandas.core.commonÚcoreÚcommonr Zpandas.core.constructionrA Zpandas.core.indexes.apirB rC rD rE Z pandas.core.indexes.datetimesrF Z pandas.core.indexes.timedeltasrG Zpandas.core.reshape.concatrH Zpandas.io.commonrI rJ rè rK ZpandasrL rM rN Ú__annotations__Z_VALID_JUSTIFY_PARAMETERSrV rW r r¾ rË r rê rì rí rS r^ r rt r r r r r rà rç rè rê rî rñ r r rô r4 r» r r¼ r r r3 r8 r: rg rg rg rh Ú<module> sÌ 8 48 ; @ !'!& E @ ý ÿ( õ&Rp - F ý ÿ ý1 ü" ÿ$a; ÿ+
|
