Skip to content

HTML (and text) reprs for large dataframes. #5550

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
5 commits merged into from
Nov 26, 2013
Merged

HTML (and text) reprs for large dataframes. #5550

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
be80898
Truncate repr by default rather than changing to info view.
takluyver Nov 19, 2013
b6400e0
Add repr footer showing total number of rows and columns
takluyver Nov 23, 2013
ba61b8f
Use to_string() to format DataFrames for clipboard.
takluyver Nov 23, 2013
c42b797
Update FAQ entry on controlling repr
takluyver Nov 25, 2013
03a81c5
Explain repr changes more prominently in release notes
takluyver Nov 26, 2013
File filter

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update FAQ entry on controlling repr
  • Loading branch information
@takluyver
takluyver committed Nov 25, 2013
commit c42b79786716b4889c7ed264f086543036a1d145
28 changes: 16 additions & 12 deletions doc/source/faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,21 +36,25 @@ horizontal scrolling, auto-detection of width/height.
To appropriately address all these environments, the display behavior is controlled
by several options, which you're encouraged to tweak to suit your setup.

As of 0.12, these are the relevant options, all under the `display` namespace,
(e.g. display.width, etc'):
As of 0.13, these are the relevant options, all under the `display` namespace,
(e.g. ``display.width``, etc.):

- notebook_repr_html: if True, IPython frontends with HTML support will display
dataframes as HTML tables when possible.
- expand_repr (default True): when the frame width cannot fit within the screen,
the output will be broken into multiple pages to accomedate. This applies to
textual (as opposed to HTML) display only.
- max_columns: max dataframe columns to display. a wider frame will trigger
a summary view, unless `expand_repr` is True and HTML output is disabled.
- max_rows: max dataframe rows display. a longer frame will trigger a summary view.
- width: width of display screen in characters, used to determine the width of lines
when expand_repr is active, Setting this to None will trigger auto-detection of terminal
width, this only works for proper terminals, not IPython frontends such as ipnb.
width is ignored in IPython notebook, since the browser provides horizontal scrolling.
- large_repr (default 'truncate'): when a :class:`~pandas.DataFrame`
exceeds max_columns or max_rows, it can be displayed either as a
truncated table or, with this set to 'info', as a short summary view.
- max_columns (default 20): max dataframe columns to display.
- max_rows (default 60): max dataframe rows display.

Two additional options only apply to displaying DataFrames in terminals,
not to the HTML view:

- expand_repr (default True): when the frame width cannot fit within
the screen, the output will be broken into multiple pages.
- width: width of display screen in characters, used to determine the
width of lines when expand_repr is active. Setting this to None will
trigger auto-detection of terminal width.

IPython users can use the IPython startup file to import pandas and set these
options automatically when starting up.
Expand Down