pandas => Meta: Руководство по документации

замечания

Эта мета-запись похожа на версию python http://stackoverflow.com/documentation/python/394/meta-documentation-guidelines#t=201607240058406359521 .

Просьба внести предложения по редактированию и прокомментировать их (вместо правильных комментариев), чтобы мы могли выполнить / повторить эти предложения :)

Отображение фрагментов кода и вывода

Два популярных варианта использования:

Обозначение 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]

стиль

Используйте библиотеку pandas как pd , это можно предположить (импорт не обязательно должен быть в каждом примере)

import pandas as pd

PEP8!

4 отпечатка в пространстве
kwargs не должны использовать пробелы f(a=1)
80 символов (вся строка, связанная с предоставленным фрагментом кода, должна быть строго предпочтительной)

Поддержка версии Pandas

Большинство примеров будут работать в нескольких версиях, если вы используете «новую» функцию, которую вы должны указать, когда это было введено.

Пример: sort_values .

печать заявлений

Большую часть времени следует избегать, так как это может быть отвлечение (следует предпочесть Out 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

pandas
Meta: Руководство по документации

Поиск…