pandas
Meta: Documentatierichtlijnen
Zoeken…
Opmerkingen
Deze metapost is vergelijkbaar met de python-versie http://stackoverflow.com/documentation/python/394/meta-documentation-guidelines#t=201607240058406359521 .
Voer bewerkingssuggesties uit en becommentarieer deze (in plaats van juiste opmerkingen), zodat we deze suggesties kunnen uitwerken / herhalen :)
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
- 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)
