From a8a2d889f13c291e1404407f8fd7387569a564d2 Mon Sep 17 00:00:00 2001 From: Terji Petersen Date: Tue, 16 May 2023 08:34:43 +0100 Subject: [PATCH 1/2] DOC: add examples for setting using .loc --- pandas/core/indexing.py | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/pandas/core/indexing.py b/pandas/core/indexing.py index 6080c55de8a86..16677fb4ef075 100644 --- a/pandas/core/indexing.py +++ b/pandas/core/indexing.py @@ -444,6 +444,26 @@ def loc(self) -> _LocIndexer: viper 0 0 sidewinder 0 0 + Add value matching location + + >>> df.loc["viper", "shield"] += 5 + >>> df + max_speed shield + cobra 30 10 + viper 0 5 + sidewinder 0 0 + + Setting using a ``Series`` or a ``DataFrame`` sets the values mathcing the + index labels, not the index positions. + + >>> shuffled_df = df.loc[["viper", "cobra", "sidewinder"]] + >>> df.loc[:] += shuffled_df + >>> df + max_speed shield + cobra 60 20 + viper 0 10 + sidewinder 0 0 + **Getting values on a DataFrame with an index that has integer labels** Another example using integers for the index From c71b126caf26bd6c69644af67cb9c819386e7fe0 Mon Sep 17 00:00:00 2001 From: Terji Petersen Date: Tue, 16 May 2023 08:56:54 +0100 Subject: [PATCH 2/2] fix codespell --- pandas/core/indexing.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pandas/core/indexing.py b/pandas/core/indexing.py index 16677fb4ef075..8a05a8c5e9af4 100644 --- a/pandas/core/indexing.py +++ b/pandas/core/indexing.py @@ -453,7 +453,7 @@ def loc(self) -> _LocIndexer: viper 0 5 sidewinder 0 0 - Setting using a ``Series`` or a ``DataFrame`` sets the values mathcing the + Setting using a ``Series`` or a ``DataFrame`` sets the values matching the index labels, not the index positions. >>> shuffled_df = df.loc[["viper", "cobra", "sidewinder"]]