pandas
Meta: Documentatierichtlijnen

Opmerkingen

Codefragmenten en uitvoer weergeven

Twee populaire opties zijn om te gebruiken:

ipython-notatie:

In [11]: df = pd.DataFrame([[1, 2], [3, 4]])

In [12]: df
Out[12]:
   0  1
0  1  2
1  3  4

Als alternatief (dit is populair in de python-documentatie) en beknopter:

df.columns  # Out: RangeIndex(start=0, stop=2, step=1)

df[0]
# Out:
# 0    1
# 1    3
# Name: 0, dtype: int64

for col in df:
    print(col)
# prints:
# 0
# 1

Over het algemeen is dit beter voor kleinere voorbeelden.

Opmerking: het onderscheid tussen uitvoer en afdrukken. ipython maakt dit duidelijk (de afdrukken vinden plaats voordat de uitvoer wordt geretourneerd):

In [21]: [print(col) for col in df]
0
1
Out[21]: [None, None]

stijl

Gebruik de panda'sbibliotheek als pd , dit kan worden aangenomen (de import hoeft niet in elk voorbeeld te zijn)

import pandas as pd

PEP8!

• 4 ruimte inspringen
• kwargs mag geen spaties gebruiken f(a=1)
• Limiet van 80 tekens (de volledige regelaanpassing in het gerenderde codefragment verdient sterk de voorkeur)

Ondersteuning voor Panda's-versie

De meeste voorbeelden werken in meerdere versies, als u een "nieuwe" functie gebruikt, moet u vermelden wanneer deze werd geïntroduceerd.

Voorbeeld: sort_values .

verklaringen afdrukken

Meestal moet afdrukken worden vermeden, omdat dit een afleiding kan zijn (uit heeft de voorkeur).
Dat is:

a
# Out: 1

is altijd beter dan

print(a)
# prints: 1

Liever ondersteunende python 2 en 3:

print(x)    # yes! (works same in python 2 and 3)
print x     # no! (python 2 only)
print(x, y) # no! (works differently in python 2 and 3)