diff --git a/pandas/core/indexing.py b/pandas/core/indexing.py index ddae58fd46bb0..750bcac738842 100644 --- a/pandas/core/indexing.py +++ b/pandas/core/indexing.py @@ -449,6 +449,38 @@ def loc(self) -> _LocIndexer: 8 4 5 9 7 8 + **Set values with a Series** + + Setting column values using a Series aligns along the index values of + the Series and DataFrame + + >>> df.loc[:, 'shield'] = pd.Series({7: 8, 8: 10, 9: 13}) + >>> df + max_speed shield + 7 1 8 + 8 4 10 + 9 7 13 + + Where the index values are not found in the Series index, the values + will be NaN + + >>> df.loc[:, 'shield'] = pd.Series({8: 10}) + >>> df + max_speed shield + 7 1 NaN + 8 4 10.0 + 9 7 NaN + + Setting value to Series with a missing index leaves the DataFrame + unchanged + + >>> df.loc[:, 'shield'] = pd.Series({11: 14}) + >>> df + max_speed shield + 7 1 NaN + 8 4 NaN + 9 7 NaN + **Getting values with a MultiIndex** A number of examples using a DataFrame with a MultiIndex