pandas.Index.get_values

Index.get_values(self)[source]

Return Index data as an numpy.ndarray.

Deprecated since version 0.25.0: Use Index.to_numpy() or Index.array instead.

Returns:
numpy.ndarray

A one-dimensional numpy array of the Index values.

See also

Index.values
The attribute that get_values wraps.

Examples

Getting the Index values of a DataFrame:

>>> df = pd.DataFrame([[1, 2, 3], [4, 5, 6], [7, 8, 9]],
...                    index=['a', 'b', 'c'], columns=['A', 'B', 'C'])
>>> df
   A  B  C
a  1  2  3
b  4  5  6
c  7  8  9
>>> df.index.get_values()
array(['a', 'b', 'c'], dtype=object)

Standalone Index values:

>>> idx = pd.Index(['1', '2', '3'])
>>> idx.get_values()
array(['1', '2', '3'], dtype=object)

MultiIndex arrays also have only one dimension:

>>> midx = pd.MultiIndex.from_arrays([[1, 2, 3], ['a', 'b', 'c']],
...                                  names=('number', 'letter'))
>>> midx.get_values()
array([(1, 'a'), (2, 'b'), (3, 'c')], dtype=object)
>>> midx.get_values().ndim
1
Scroll To Top