Skip to content

DOC:Remove DataFrame.append from the 10min intro #27520

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
merged 7 commits into from
Aug 2, 2019
Merged

DOC:Remove DataFrame.append from the 10min intro #27520

Changes from 4 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
609e4d9
DOC:Remove DataFrame.append from the 10min intro
sameshl Jul 22, 2019
1da9595
add note on usage of append in 10min guide
sameshl Jul 24, 2019
5d21953
fixed wrong indentation of note directive
sameshl Jul 24, 2019
a7302f1
moved the note directive from object creation section to end of conca…
sameshl Jul 24, 2019
962aae2
made the note more consise
sameshl Jul 28, 2019
9bfec58
remove trailing white spaces
sameshl Jul 28, 2019
27455cb
Minor style changes
sameshl Jul 31, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 7 additions & 15 deletions doc/source/getting_started/10min.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -468,6 +468,13 @@ Concatenating pandas objects together with :func:`concat`:

pd.concat(pieces)

.. note::
Adding a column to a DataFrame is relatively fast. Adding a row, however,
requires a full copy of the data and a construction of a new Index, which
Copy link
Contributor

@jreback jreback Jul 26, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use double-backticks around DataFrame. Also let's make this shorter / simpler.

first part do something like

Adding a column to a DataFrame is relatively fast, However, adding a row requires a copy, and may be expensive.

Copy link
Contributor Author

@sameshl sameshl Jul 28, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jreback Done. Let me know if any more changes are required.

may be expensive. Rather than iteratively building a DataFrame by
appending records, we recommend passing the pre-built list of records
to the DataFrame constructor. See :ref:`Appending to dataframe <merging.concatenation>` for more.

Join
~~~~

Expand All @@ -491,21 +498,6 @@ Another example that can be given is:
right
pd.merge(left, right, on='key')


Append
~~~~~~

Append rows to a dataframe. See the :ref:`Appending <merging.concatenation>`
section.

.. ipython:: python

df = pd.DataFrame(np.random.randn(8, 4), columns=['A', 'B', 'C', 'D'])
df
s = df.iloc[3]
df.append(s, ignore_index=True)


Grouping
--------

Expand Down