panda> = 0,24
Deprecare il tuo utilizzo .valuesa favore di questi metodi!
Da v0.24.0 in poi, avremo due nuovi metodi preferiti zecca per ottenere matrici NumPy da Index, Seriese DataFrameoggetti: sono to_numpy(), e .array. Per quanto riguarda l'utilizzo, i documenti menzionano:
Non abbiamo rimosso o deprecato Series.valueso
DataFrame.values, ma consigliamo vivamente e utilizzare .arrayo
.to_numpy()invece.
Vedere questa sezione delle note sulla versione v0.24.0 per ulteriori informazioni.
to_numpy() Metodo
df.index.to_numpy()
# array(['a', 'b'], dtype=object)
df['A'].to_numpy()
# array([1, 4])
Per impostazione predefinita, viene restituita una vista. Qualsiasi modifica apportata influirà sull'originale.
v = df.index.to_numpy()
v[0] = -1
df
A B
-1 1 2
b 4 5
Se invece hai bisogno di una copia, usa to_numpy(copy=True);
v = df.index.to_numpy(copy=True)
v[-1] = -123
df
A B
a 1 2
b 4 5
Nota che questa funzione funziona anche con DataFrames (mentre .arraynon lo fa).
arrayAttributo
Questo attributo restituisce unExtensionArrayoggetto che supporta l'Indice / Serie.
pd.__version__
# '0.24.0rc1'
# Setup.
df = pd.DataFrame([[1, 2], [4, 5]], columns=['A', 'B'], index=['a', 'b'])
df
A B
a 1 2
b 4 5
df.index.array
# <PandasArray>
# ['a', 'b']
# Length: 2, dtype: object
df['A'].array
# <PandasArray>
# [1, 4]
# Length: 2, dtype: int64
Da qui, è possibile ottenere un elenco utilizzando list:
list(df.index.array)
# ['a', 'b']
list(df['A'].array)
# [1, 4]
oppure chiama direttamente .tolist():
df.index.tolist()
# ['a', 'b']
df['A'].tolist()
# [1, 4]
Per quanto riguarda ciò che viene restituito, i documenti menzionano,
Per Seriese Indexes sostenuta da normali array NumPy, Series.array
restituirà una nuova arrays.PandasArray, che è un sottile (no-copy) wrapper una numpy.ndarray. arrays.PandasArraynon è particolarmente utile di per sé, ma fornisce la stessa interfaccia di qualsiasi array di estensione definito in Panda o da una libreria di terze parti.
Quindi, per riassumere, .arraytornerà entrambi
- Il
ExtensionArraysupporto esistente dell'Indice / Serie, o
- Se esiste un array NumPy che supporta la serie, un nuovo
ExtensionArrayoggetto viene creato come un wrapper sottile sull'array sottostante.
Razionale per l'aggiunta di DUE nuovi metodi
Queste funzioni sono state aggiunte a seguito di discussioni in due numeri GitHub GH19954 e GH23623 .
In particolare, i documenti menzionano la logica:
[...] con .valuesesso non era chiaro se il valore restituito sarebbe l'array effettivo, una sua trasformazione o uno degli array personalizzati di panda (come Categorical). Ad esempio, con PeriodIndex, .values
genera ndarrayogni volta un nuovo oggetto period. [...]
Queste due funzioni mirano a migliorare la coerenza dell'API, che rappresenta un passo importante nella giusta direzione.
Infine, .valuesnon sarà deprecato nella versione corrente, ma mi aspetto che ciò accada ad un certo punto in futuro, quindi esorto gli utenti a migrare verso l'API più recente, non appena è possibile.