diff --git a/doc/source/getting_started/10min.rst b/doc/source/getting_started/10min.rst index fdf1f05b8e61f..b98f2a74ce2f3 100644 --- a/doc/source/getting_started/10min.rst +++ b/doc/source/getting_started/10min.rst @@ -3,7 +3,7 @@ {{ header }} ******************** -10 Minutes to pandas +10 minutes to pandas ******************** This is a short introduction to pandas, geared mainly for new users. @@ -16,7 +16,7 @@ Customarily, we import as follows: import numpy as np import pandas as pd -Object Creation +Object creation --------------- See the :ref:`Data Structure Intro section `. @@ -83,7 +83,7 @@ As you can see, the columns ``A``, ``B``, ``C``, and ``D`` are automatically tab completed. ``E`` is there as well; the rest of the attributes have been truncated for brevity. -Viewing Data +Viewing data ------------ See the :ref:`Basics section `. @@ -183,7 +183,7 @@ Selecting via ``[]``, which slices the rows. df[0:3] df['20130102':'20130104'] -Selection by Label +Selection by label ~~~~~~~~~~~~~~~~~~ See more in :ref:`Selection by Label `. @@ -224,7 +224,7 @@ For getting fast access to a scalar (equivalent to the prior method): df.at[dates[0], 'A'] -Selection by Position +Selection by position ~~~~~~~~~~~~~~~~~~~~~ See more in :ref:`Selection by Position `. @@ -271,7 +271,7 @@ For getting fast access to a scalar (equivalent to the prior method): df.iat[1, 1] -Boolean Indexing +Boolean indexing ~~~~~~~~~~~~~~~~ Using a single column's values to select data. @@ -340,7 +340,7 @@ A ``where`` operation with setting. df2 -Missing Data +Missing data ------------ pandas primarily uses the value ``np.nan`` to represent missing data. It is by @@ -428,7 +428,7 @@ See more at :ref:`Histogramming and Discretization `. s s.value_counts() -String Methods +String methods ~~~~~~~~~~~~~~ Series is equipped with a set of string processing methods in the `str` @@ -580,7 +580,7 @@ With a "stacked" DataFrame or Series (having a ``MultiIndex`` as the stacked.unstack(1) stacked.unstack(0) -Pivot Tables +Pivot tables ~~~~~~~~~~~~ See the section on :ref:`Pivot Tables `. @@ -600,7 +600,7 @@ We can produce pivot tables from this data very easily: pd.pivot_table(df, values='D', index=['A', 'B'], columns=['C']) -Time Series +Time series ----------- pandas has simple, powerful, and efficient functionality for performing @@ -734,7 +734,7 @@ of the columns with labels: @savefig frame_plot_basic.png plt.legend(loc='best') -Getting Data In/Out +Getting data in/out ------------------- CSV diff --git a/doc/source/getting_started/basics.rst b/doc/source/getting_started/basics.rst index 5ec0094de0a91..23d7228e88cd2 100644 --- a/doc/source/getting_started/basics.rst +++ b/doc/source/getting_started/basics.rst @@ -3,7 +3,7 @@ {{ header }} ============================== - Essential Basic Functionality + Essential basic functionality ============================== Here we discuss a lot of the essential functionality common to the pandas data @@ -19,7 +19,7 @@ the previous section: .. _basics.head_tail: -Head and Tail +Head and tail ------------- To view a small sample of a Series or DataFrame object, use the @@ -34,7 +34,7 @@ of elements to display is five, but you may pass a custom number. .. _basics.attrs: -Attributes and Underlying Data +Attributes and underlying data ------------------------------ pandas objects have a number of attributes enabling you to access the metadata @@ -286,7 +286,7 @@ using ``fillna`` if you wish). .. _basics.compare: -Flexible Comparisons +Flexible comparisons ~~~~~~~~~~~~~~~~~~~~ Series and DataFrame have the binary comparison methods ``eq``, ``ne``, ``lt``, ``gt``, @@ -304,7 +304,7 @@ indexing operations, see the section on :ref:`Boolean indexing .. _basics.reductions: -Boolean Reductions +Boolean reductions ~~~~~~~~~~~~~~~~~~ You can apply the reductions: :attr:`~DataFrame.empty`, :meth:`~DataFrame.any`, diff --git a/doc/source/getting_started/dsintro.rst b/doc/source/getting_started/dsintro.rst index 1abca7ac393dd..7675737b82c8f 100644 --- a/doc/source/getting_started/dsintro.rst +++ b/doc/source/getting_started/dsintro.rst @@ -3,7 +3,7 @@ {{ header }} ************************ -Intro to Data Structures +Intro to data structures ************************ We'll start with a quick, non-comprehensive overview of the fundamental data @@ -407,7 +407,7 @@ represent missing values. Alternatively, you may pass a ``numpy.MaskedArray`` as the data argument to the DataFrame constructor, and its masked entries will be considered missing. -Alternate Constructors +Alternate constructors ~~~~~~~~~~~~~~~~~~~~~~ .. _basics.dataframe.from_dict: @@ -498,7 +498,7 @@ available to insert at a particular location in the columns: .. _dsintro.chained_assignment: -Assigning New Columns in Method Chains +Assigning new columns in method Chains ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Inspired by `dplyr's @@ -614,7 +614,7 @@ To write code compatible with all versions of Python, split the assignment in tw -Indexing / Selection +Indexing / selection ~~~~~~~~~~~~~~~~~~~~ The basics of indexing are as follows: diff --git a/doc/source/getting_started/overview.rst b/doc/source/getting_started/overview.rst index b531f686951fc..ec76c60f24257 100644 --- a/doc/source/getting_started/overview.rst +++ b/doc/source/getting_started/overview.rst @@ -81,7 +81,7 @@ Some other notes - pandas has been used extensively in production in financial applications. -Data Structures +Data structures --------------- .. csv-table:: @@ -131,7 +131,7 @@ changed, but, for example, columns can be inserted into a DataFrame. However, the vast majority of methods produce new objects and leave the input data untouched. In general we like to **favor immutability** where sensible. -Getting Support +Getting support --------------- The first stop for pandas issues and ideas is the `Github Issue Tracker @@ -152,7 +152,7 @@ pandas is a `NumFOCUS `__ sponso This will help ensure the success of development of pandas as a world-class open-source project, and makes it possible to `donate `__ to the project. -Project Governance +Project governance ------------------ The governance process that pandas project has used informally since its inception in 2008 is formalized in `Project Governance documents `__. @@ -160,13 +160,13 @@ The documents clarify how decisions are made and how the various elements of our Wes McKinney is the Benevolent Dictator for Life (BDFL). -Development Team +Development team ----------------- The list of the Core Team members and more detailed information can be found on the `people’s page `__ of the governance repo. -Institutional Partners +Institutional partners ---------------------- The information about current institutional partners can be found on `pandas website page `__. diff --git a/doc/source/getting_started/tutorials.rst b/doc/source/getting_started/tutorials.rst index 8e23c643280c1..71a9610cf24a5 100644 --- a/doc/source/getting_started/tutorials.rst +++ b/doc/source/getting_started/tutorials.rst @@ -8,7 +8,7 @@ Tutorials This is a guide to many pandas tutorials, geared mainly for new users. -Internal Guides +Internal guides =============== pandas' own :ref:`10 Minutes to pandas<10min>`. @@ -17,10 +17,10 @@ More complex recipes are in the :ref:`Cookbook`. A handy pandas `cheat sheet `_. -Community Guides +Community guides ================ -pandas Cookbook by Julia Evans +pandas cookbook by Julia Evans ------------------------------ The goal of this 2015 cookbook (by `Julia Evans `_) is to @@ -30,7 +30,7 @@ entails. For the table of contents, see the `pandas-cookbook GitHub repository `_. -Learn Pandas by Hernan Rojas +Learn pandas by Hernan Rojas ---------------------------- A set of lesson for new pandas users: https://bitbucket.org/hrojas/learn-pandas @@ -74,7 +74,7 @@ Excel charts with pandas, vincent and xlsxwriter * `Using Pandas and XlsxWriter to create Excel charts `_ -Video Tutorials +Video tutorials --------------- * `Pandas From The Ground Up `_ @@ -96,7 +96,7 @@ Video Tutorials `Jupyter Notebook `__ -Various Tutorials +Various tutorials ----------------- * `Wes McKinney's (pandas BDFL) blog `_ diff --git a/doc/source/reference/arrays.rst b/doc/source/reference/arrays.rst index fb9a95b6736d5..4528215a2575d 100644 --- a/doc/source/reference/arrays.rst +++ b/doc/source/reference/arrays.rst @@ -3,7 +3,7 @@ .. _api.arrays: ============= -Pandas Arrays +Pandas arrays ============= .. currentmodule:: pandas @@ -15,7 +15,7 @@ objects contained with a :class:`Index`, :class:`Series`, or For some data types, pandas extends NumPy's type system. =================== ========================= ================== ============================= -Kind of Data Pandas Data Type Scalar Array +Kind of data Pandas data type Scalar Array =================== ========================= ================== ============================= TZ-aware datetime :class:`DatetimeTZDtype` :class:`Timestamp` :ref:`api.arrays.datetime` Timedeltas (none) :class:`Timedelta` :ref:`api.arrays.timedelta` @@ -37,7 +37,7 @@ stored in a :class:`Series`, :class:`Index`, or as a column in a :class:`DataFra .. _api.arrays.datetime: -Datetime Data +Datetime data ------------- NumPy cannot natively represent timezone-aware datetimes. Pandas supports this @@ -155,7 +155,7 @@ If the data are tz-aware, then every value in the array must have the same timez .. _api.arrays.timedelta: -Timedelta Data +Timedelta data -------------- NumPy can natively represent timedeltas. Pandas provides :class:`Timedelta` @@ -209,7 +209,7 @@ A collection of timedeltas may be stored in a :class:`TimedeltaArray`. .. _api.arrays.period: -Timespan Data +Timespan data ------------- Pandas represents spans of times as :class:`Period` objects. @@ -274,7 +274,7 @@ Every period in a ``PeriodArray`` must have the same ``freq``. .. _api.arrays.interval: -Interval Data +Interval data ------------- Arbitrary intervals can be represented as :class:`Interval` objects. @@ -315,7 +315,7 @@ A collection of intervals may be stored in an :class:`arrays.IntervalArray`. .. _api.arrays.integer_na: -Nullable Integer +Nullable integer ---------------- :class:`numpy.ndarray` cannot natively represent integer-data with missing values. @@ -341,7 +341,7 @@ Pandas provides this through :class:`arrays.IntegerArray`. .. _api.arrays.categorical: -Categorical Data +Categorical data ---------------- Pandas defines a custom data type for representing data that can take only a @@ -406,7 +406,7 @@ data. See :ref:`api.series.cat` for more. .. _api.arrays.sparse: -Sparse Data +Sparse data ----------- Data where a single value is repeated many times (e.g. ``0`` or ``NaN``) may @@ -439,4 +439,4 @@ and methods if the :class:`Series` contains sparse values. See DatetimeTZDtype.unit DatetimeTZDtype.tz PeriodDtype.freq - IntervalDtype.subtype \ No newline at end of file + IntervalDtype.subtype diff --git a/doc/source/reference/frame.rst b/doc/source/reference/frame.rst index 7d5cd5d245631..297b69075f4ab 100644 --- a/doc/source/reference/frame.rst +++ b/doc/source/reference/frame.rst @@ -115,7 +115,7 @@ Binary operator functions DataFrame.combine DataFrame.combine_first -Function application, GroupBy & Window +Function application, GroupBy & window ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -133,7 +133,7 @@ Function application, GroupBy & Window .. _api.dataframe.stats: -Computations / Descriptive Stats +Computations / descriptive statistics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -177,7 +177,7 @@ Computations / Descriptive Stats DataFrame.var DataFrame.nunique -Reindexing / Selection / Label manipulation +Reindexing / selection / label manipulation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -312,7 +312,7 @@ specific plotting methods of the form ``DataFrame.plot.``. .. _api.frame.sparse: -Sparse Accessor +Sparse accessor ~~~~~~~~~~~~~~~ Sparse-dtype specific methods and attributes are provided under the @@ -332,7 +332,7 @@ Sparse-dtype specific methods and attributes are provided under the DataFrame.sparse.to_dense -Serialization / IO / Conversion +Serialization / IO / conversion ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ diff --git a/doc/source/reference/groupby.rst b/doc/source/reference/groupby.rst index 5c8a563a47d00..598058d160914 100644 --- a/doc/source/reference/groupby.rst +++ b/doc/source/reference/groupby.rst @@ -40,7 +40,7 @@ Function application GroupBy.transform GroupBy.pipe -Computations / Descriptive Stats +Computations / descriptive statistics -------------------------------- .. autosummary:: :toctree: api/ diff --git a/doc/source/reference/index.rst b/doc/source/reference/index.rst index 31b493e472099..12ca318c815d3 100644 --- a/doc/source/reference/index.rst +++ b/doc/source/reference/index.rst @@ -3,7 +3,7 @@ .. _api: ============= -API Reference +API reference ============= This page gives an overview of all public pandas objects, functions and diff --git a/doc/source/reference/indexing.rst b/doc/source/reference/indexing.rst index 6d27e225b681e..7efbc9146dabd 100644 --- a/doc/source/reference/indexing.rst +++ b/doc/source/reference/indexing.rst @@ -3,7 +3,7 @@ .. _api.indexing: ============= -Index Objects +Index objects ============= Index @@ -48,7 +48,7 @@ Properties Index.T Index.memory_usage -Modifying and Computations +Modifying and computations ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -96,7 +96,7 @@ Compatibility with MultiIndex Index.is_lexsorted_for_tuple Index.droplevel -Missing Values +Missing values ~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -173,7 +173,7 @@ Selecting .. _api.numericindex: -Numeric Index +Numeric index ------------- .. autosummary:: :toctree: api/ @@ -202,7 +202,7 @@ CategoricalIndex CategoricalIndex -Categorical Components +Categorical components ~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -219,7 +219,7 @@ Categorical Components CategoricalIndex.as_ordered CategoricalIndex.as_unordered -Modifying and Computations +Modifying and computations ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -237,7 +237,7 @@ IntervalIndex IntervalIndex -IntervalIndex Components +IntervalIndex components ~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -275,7 +275,7 @@ MultiIndex IndexSlice -MultiIndex Constructors +MultiIndex constructors ~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -296,7 +296,7 @@ MultiIndex Properties MultiIndex.nlevels MultiIndex.levshape -MultiIndex Components +MultiIndex components ~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -313,7 +313,7 @@ MultiIndex Components MultiIndex.reorder_levels MultiIndex.remove_unused_levels -MultiIndex Selecting +MultiIndex selecting ~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ @@ -333,7 +333,7 @@ DatetimeIndex DatetimeIndex -Time/Date Components +Time/Date components ~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ diff --git a/doc/source/reference/resampling.rst b/doc/source/reference/resampling.rst index 2a52defa3c68f..2c8fb232d9e7c 100644 --- a/doc/source/reference/resampling.rst +++ b/doc/source/reference/resampling.rst @@ -43,7 +43,7 @@ Upsampling Resampler.asfreq Resampler.interpolate -Computations / Descriptive Stats +Computations / descriptive statistics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. autosummary:: :toctree: api/ diff --git a/doc/source/reference/series.rst b/doc/source/reference/series.rst index 79beeb0022307..93a41e8bb1271 100644 --- a/doc/source/reference/series.rst +++ b/doc/source/reference/series.rst @@ -119,7 +119,7 @@ Binary operator functions Series.product Series.dot -Function application, GroupBy & Window +Function application, GroupBy & window -------------------------------------- .. autosummary:: :toctree: api/ @@ -137,7 +137,7 @@ Function application, GroupBy & Window .. _api.series.stats: -Computations / Descriptive Stats +Computations / descriptive statistics -------------------------------- .. autosummary:: :toctree: api/ @@ -188,7 +188,7 @@ Computations / Descriptive Stats Series.value_counts Series.compound -Reindexing / Selection / Label manipulation +Reindexing / selection / label manipulation ------------------------------------------- .. autosummary:: :toctree: api/ @@ -286,7 +286,7 @@ These are separate namespaces within :class:`Series` that only apply to specific data types. =========================== ================================= -Data Type Accessor +Data type Accessor =========================== ================================= Datetime, Timedelta, Period :ref:`dt ` String :ref:`str ` @@ -296,14 +296,14 @@ Sparse :ref:`sparse ` .. _api.series.dt: -Datetimelike Properties +Datetimelike properties ~~~~~~~~~~~~~~~~~~~~~~~ ``Series.dt`` can be used to access the values of the series as datetimelike and return several properties. These can be accessed like ``Series.dt.``. -Datetime Properties +Datetime properties ^^^^^^^^^^^^^^^^^^^ .. autosummary:: @@ -339,7 +339,7 @@ Datetime Properties Series.dt.tz Series.dt.freq -Datetime Methods +Datetime methods ^^^^^^^^^^^^^^^^ .. autosummary:: @@ -358,7 +358,7 @@ Datetime Methods Series.dt.month_name Series.dt.day_name -Period Properties +Period properties ^^^^^^^^^^^^^^^^^ .. autosummary:: @@ -369,7 +369,7 @@ Period Properties Series.dt.start_time Series.dt.end_time -Timedelta Properties +Timedelta properties ^^^^^^^^^^^^^^^^^^^^ .. autosummary:: @@ -382,7 +382,7 @@ Timedelta Properties Series.dt.nanoseconds Series.dt.components -Timedelta Methods +Timedelta methods ^^^^^^^^^^^^^^^^^ .. autosummary:: @@ -476,7 +476,7 @@ strings and apply several methods to it. These can be accessed like .. _api.series.cat: -Categorical Accessor +Categorical accessor ~~~~~~~~~~~~~~~~~~~~ Categorical-dtype specific methods and attributes are available under @@ -506,7 +506,7 @@ the ``Series.cat`` accessor. .. _api.series.sparse: -Sparse Accessor +Sparse accessor ~~~~~~~~~~~~~~~ Sparse-dtype specific methods and attributes are provided under the @@ -558,7 +558,7 @@ specific plotting methods of the form ``Series.plot.``. Series.hist -Serialization / IO / Conversion +Serialization / IO / conversion ------------------------------- .. autosummary:: :toctree: api/ diff --git a/doc/source/reference/style.rst b/doc/source/reference/style.rst index bd9635b41e343..3d155535e2585 100644 --- a/doc/source/reference/style.rst +++ b/doc/source/reference/style.rst @@ -9,7 +9,7 @@ Style ``Styler`` objects are returned by :attr:`pandas.DataFrame.style`. -Styler Constructor +Styler constructor ------------------ .. autosummary:: :toctree: api/ @@ -17,7 +17,7 @@ Styler Constructor Styler Styler.from_custom_template -Styler Properties +Styler properties ----------------- .. autosummary:: :toctree: api/ @@ -26,7 +26,7 @@ Styler Properties Styler.template Styler.loader -Style Application +Style application ----------------- .. autosummary:: :toctree: api/ @@ -44,7 +44,7 @@ Style Application Styler.clear Styler.pipe -Builtin Styles +Builtin styles -------------- .. autosummary:: :toctree: api/ @@ -55,7 +55,7 @@ Builtin Styles Styler.background_gradient Styler.bar -Style Export and Import +Style export and import ----------------------- .. autosummary:: :toctree: api/