Skip to content

Commit ba2c3fd

Browse files
committed
DOC: make the comparison to Excel about spreadsheets more generally
1 parent 6cccd67 commit ba2c3fd

File tree

3 files changed

+19
-18
lines changed

3 files changed

+19
-18
lines changed

doc/source/getting_started/comparison/comparison_with_excel.rst renamed to doc/source/getting_started/comparison/comparison_with_spreadsheets.rst

+17-16
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
.. _compare_with_excel:
1+
.. _compare_with_spreadsheets:
22

33
{{ header }}
44

5-
Comparison with Excel
6-
*********************
5+
Comparison with spreadsheets
6+
****************************
77

8-
Since many potential pandas users have some familiarity with `Excel
9-
<https://support.microsoft.com/en-us/excel>`_, this page is meant to provide some examples of how
10-
various Excel operations would be performed using pandas. Much of this will be the
11-
same/similar in `Google Sheets <https://support.google.com/a/users/answer/9282959>`_, `LibreOffice
12-
Calc <https://help.libreoffice.org/latest/en-US/text/scalc/main0000.html?DbPAR=CALC>`_, `Apple
13-
Numbers <https://www.apple.com/mac/numbers/compatibility/functions.html>`_, and other
8+
Since many potential pandas users have some familiarity with spreadsheet programs like
9+
`Excel <https://support.microsoft.com/en-us/excel>`_, this page is meant to provide some examples
10+
of how various spreadsheet operations would be performed using pandas. This page will use
11+
terminology and link to documentation for Excel, but much will be the same/similar in
12+
`Google Sheets <https://support.google.com/a/users/answer/9282959>`_,
13+
`LibreOffice Calc <https://help.libreoffice.org/latest/en-US/text/scalc/main0000.html?DbPAR=CALC>`_,
14+
`Apple Numbers <https://www.apple.com/mac/numbers/compatibility/functions.html>`_, and other
1415
Excel-compatible spreadsheet software.
1516

1617
.. include:: comparison_boilerplate.rst
@@ -48,11 +49,11 @@ A ``Series`` is the data structure that represents one column of a ``DataFrame``
4849

4950
Every ``DataFrame`` and ``Series`` has an ``Index``, which are labels on the *rows* of the data. In
5051
pandas, if no index is specified, an integer index is used by default (first row = 0, second row =
51-
1, and so on), analogous to row headings/numbers in Excel.
52+
1, and so on), analogous to row headings/numbers in spreadsheets.
5253

5354
In pandas, indexes can be set to one (or multiple) unique values, which is like having a column that
54-
use use as the row identifier in a worksheet. Unlike Excel, these ``Index`` values can actually be
55-
used to reference the rows. For example, in Excel, you would reference the first row as ``A1:Z1``,
55+
use use as the row identifier in a worksheet. Unlike spreadsheets, these ``Index`` values can actually be
56+
used to reference the rows. For example, in spreadsheets, you would reference the first row as ``A1:Z1``,
5657
while in pandas you could use ``populations.loc['Chicago']``.
5758

5859
Index values are also persistent, so if you re-order the rows in a ``DataFrame``, the label for a
@@ -61,8 +62,8 @@ particular row don't change.
6162
See the :ref:`indexing documentation<indexing>` for much more on how to use an ``Index``
6263
effectively.
6364

64-
Commonly used Excel functionalities
65-
-----------------------------------
65+
Commonly used spreadsheet functionalities
66+
-----------------------------------------
6667

6768
Importing data
6869
~~~~~~~~~~~~~~
@@ -88,7 +89,7 @@ Fill Handle
8889
~~~~~~~~~~~
8990

9091
Create a series of numbers following a set pattern in a certain set of cells. In
91-
Excel this would be done by shift+drag after entering the first number or by
92+
a spreadsheet, this would be done by shift+drag after entering the first number or by
9293
entering the first two or three values and then dragging.
9394

9495
This can be achieved by creating a series and assigning it to the desired cells.
@@ -145,7 +146,7 @@ Pivot Tables
145146
~~~~~~~~~~~~
146147

147148
`PivotTables <https://support.microsoft.com/en-us/office/create-a-pivottable-to-analyze-worksheet-data-a9a84538-bfe9-40a9-a8e9-f99134456576>`_
148-
from Excel can be replicated in pandas through :ref:`reshaping`. Using the ``tips`` dataset again,
149+
from spreadsheets can be replicated in pandas through :ref:`reshaping`. Using the ``tips`` dataset again,
149150
let's find the average gratuity by size of the party and sex of the server.
150151

151152
In Excel, we use the following configuration for the PivotTable:

doc/source/getting_started/comparison/index.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,6 @@ Comparison with other tools
1111

1212
comparison_with_r
1313
comparison_with_sql
14-
comparison_with_excel
14+
comparison_with_spreadsheets
1515
comparison_with_sas
1616
comparison_with_stata

doc/source/getting_started/index.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -633,7 +633,7 @@ the pandas-equivalent operations compared to software you already know:
633633

634634
.. container:: custom-button
635635

636-
:ref:`Learn more <compare_with_excel>`
636+
:ref:`Learn more <compare_with_spreadsheets>`
637637

638638
.. raw:: html
639639

0 commit comments

Comments
 (0)