pandas
メタ:ドキュメンテーションのガイドライン
サーチ…
備考
このメタポストはpythonのバージョンhttp://stackoverflow.com/documentation/python/394/meta-documentation-guidelines#t=201607240058406359521に似ています。
編集提案を作成し、適切なコメントの代わりにコメントにコメントしてください。これらの提案を肉付け/反復することができます:)
コードスニペットと出力を表示する
2つの一般的なオプションが使用されます:
ipython表記法:
In [11]: df = pd.DataFrame([[1, 2], [3, 4]])
In [12]: df
Out[12]:
0 1
0 1 2
1 3 4
代わりに(これはPythonのドキュメントで一般的です)より簡潔に:
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
一般的に、これは小さな例の方が優れています。
注:出力と印刷の区別。 ipythonはこれを明確にします(出力は出力が返される前に起こります):
In [21]: [print(col) for col in df]
0
1
Out[21]: [None, None]
スタイル
pd
としてpd
ライブラリを使用します。これは想定できます(インポートはすべての例にある必要はありません)
import pandas as pd
- 4スペースインデント
- kwargsは空白を使用しないでください
f(a=1)
- 80文字の制限(レンダリングされたコードスニペットの全フィッティングが強く推奨されるはずです)
パンダ版のサポート
ほとんどの例は複数のバージョン間で動作しますが、新しい機能を使用している場合は、これが導入されたときに言及する必要があります。
例: sort_values
。
印刷文
ほとんどの場合、注意をそらすことができるので、印刷は避けてください(Outを優先すべきです)。
あれは:
a
# Out: 1
常により良いです
print(a)
# prints: 1
Python 2と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)
Modified text is an extract of the original Stack Overflow Documentation
ライセンスを受けた CC BY-SA 3.0
所属していない Stack Overflow