Вы уже использовали color и linewidth у plot. В следующих примерах появятся новые функции и параметры. Запоминать все имена и порядок не нужно: PyneIDE показывает справку рядом с кодом.

Здесь используется готовый first_chart.py. Запускать программу не требуется.

Наведите указатель на имя функции

  1. Откройте first_chart.py из Scripts в Pyne.
  2. Найдите plot(close, "Close", ...) внутри main().
  3. Наведите указатель на plot в начале строки и немного подождите.

Всплывающая справка показывает параметры и описание. Если текст длинный, наведите указатель на справку и прокрутите её. Esc закрывает окно.

Над вызовом plot в first_chart.py открыта справка PyneIDE; значение linewidth по умолчанию равно 1.
Справка над plot показывает типы параметров и значения по умолчанию.

Как читать список параметров?

В справке может быть больше настроек, чем использовано в примере. Найдите только нужные сейчас.

У plot, например:

  • series задаёт отображаемое значение. У нас это место занимает close.
  • title задаёт имя рисунка. Его передаёт второй аргумент "Close".
  • linewidth задаёт толщину линии. = 1 в списке означает значение по умолчанию; наше linewidth=2 его заменяет.

Параметр является именем входного значения или настройки в определении функции. Аргумент является значением, переданным при вызове. Поэтому linewidth является параметром, а 2 в linewidth=2 аргументом.

Тип рядом с именем подсказывает ожидаемое значение. Например, int означает целое число. Аннотации типов встретятся и дальше; учить весь список сейчас не нужно.

Справка написана по-английски, а книга объясняет используемые параметры по-русски. Для новой функции сначала просмотрите описание, затем найдите настройку, которую хотите изменить.

Дополнительно: переход к определению

Чтобы увидеть, где написана функция, удерживайте Command в macOS или Ctrl в Windows и Linux и нажмите на plot. Редактор откроет определение. То же действие доступно через правую кнопку и Go to Definition.

Под def plot(...) в открытом файле находятся описание и реализация. Это код установленной библиотеки: для упражнения достаточно чтения, не изменяйте его. Вернуться можно по вкладке first_chart.py.

PyneIDE перешла к def plot в библиотечном plot.py; ниже видны описания параметров.
Переход к определению открывает библиотечный исходный код plot. Ваша программа остаётся в другой вкладке.

Знание внутреннего устройства библиотеки не требуется для примеров книги. Этот способ пригодится для более подробного изучения функций позднее.

Попробуйте самостоятельно

Откройте справку plot и найдите linewidth. Каково значение по умолчанию? Совпадает ли с ним значение вашего вызова?

Решение

По умолчанию используется 1. В first_chart.py указано linewidth=2, поэтому толщина равна 2. Если убрать этот аргумент, функция использует 1.