pandas.Series.get#

Series.get(key, default=None)[source]#

Get item from object for given key (ex: DataFrame column).

Returns default value if not found.

Parameters:

keyobject: Key for which item should be returned.
defaultobject, default None: Default value to return if key is not found.

Returns:

same type as items contained in object: Item for given key or default value, if key is not found.

See also

DataFrame.get: Get item from object for given key (ex: DataFrame column).
Series.get: Get item from object for given key (ex: DataFrame column).

Examples

>>> df = pd.DataFrame(
...     [
...         [24.3, 75.7, "high"],
...         [31, 87.8, "high"],
...         [22, 71.6, "medium"],
...         [35, 95, "medium"],
...     ],
...     columns=["temp_celsius", "temp_fahrenheit", "windspeed"],
...     index=pd.date_range(start="2014-02-12", end="2014-02-15", freq="D"),
... )

>>> df
            temp_celsius  temp_fahrenheit windspeed
2014-02-12          24.3             75.7      high
2014-02-13          31.0             87.8      high
2014-02-14          22.0             71.6    medium
2014-02-15          35.0             95.0    medium

>>> df.get(["temp_celsius", "windspeed"])
            temp_celsius windspeed
2014-02-12          24.3      high
2014-02-13          31.0      high
2014-02-14          22.0    medium
2014-02-15          35.0    medium

>>> ser = df["windspeed"]
>>> ser.get("2014-02-13")
'high'

If the key isn’t found, the default value will be used.

>>> df.get(["temp_celsius", "temp_kelvin"], default="default_value")
'default_value'

>>> ser.get("2014-02-10", "[unknown]")
'[unknown]'