финансы

matplotlib.finance

Сборник функций для сбора, анализа и построения графиков финансовых данных.

Этот модуль устарел в версии 2.0 и был перемещён в модуль под названием mpl_finance.

matplotlib.finance.candlestick2_ochl(ax, opens, closes, highs, lows, width=4, colorup='k', colordown='r', alpha=0.75)

Представляет открытие и закрытие в виде столбца, а диапазон высоких и низких значений в виде вертикальной линии.

Сохраняет исходный порядок аргументов.

Параметры:

ax : Axes экземпляр Axes для построения графика opens : последовательность последовательность начальных значений closes : последовательность последовательность конечных значений highs : последовательность последовательность максимальных значений lows : последовательность последовательность минимальных значений ticksize : int размер отметки открытия и закрытия в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие alpha : float прозрачность столбца

Возвращает:

ret : кортеж (lineCollection, barCollection)

matplotlib.finance.candlestick2_ohlc(ax, opens, highs, lows, closes, width=4, colorup='k', colordown='r', alpha=0.75)

Представляет открытие и закрытие в виде столбца, а диапазон высоких и низких значений в виде вертикальной линии.

ПРИМЕЧАНИЕ: этот код предполагает, что если отсутствует любое значение open, low, high, close, то отсутствуют все.

Параметры:

ax : Axes экземпляр Axes для построения графика opens : последовательность последовательность начальных значений highs : последовательность последовательность максимальных значений lows : последовательность последовательность минимальных значений closes : последовательность последовательность конечных значений ticksize : int размер отметки открытия и закрытия в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие alpha : float прозрачность столбца

Возвращает:

ret : кортеж (lineCollection, barCollection)

matplotlib.finance.candlestick_ochl(ax, quotes, width=0.2, colorup='k', colordown='r', alpha=1.0)

Строит график свечей с указанием времени, открытия, закрытия, максимума и минимума в виде вертикальной линии, охватывающей диапазон от минимума до максимума. Использует прямоугольный столбец для отображения разницы между открытием и закрытием. Если закрытие >= открытие, использует цвет colorup для заливки столбца, иначе использует colordown.

Параметры:

ax : Axes экземпляр Axes для построения графика quotes : последовательность последовательностей (time, open, close, high, low, …) Достаточно, чтобы первые 5 элементов были этими значениями, запись может быть сколь угодно длинной (например, может хранить объём). время должно быть в формате дробных дней - см. date2num width : float доля дня для ширины прямоугольника colorup : цвет цвет прямоугольника, где закрытие >= открытие colordown : цвет цвет прямоугольника, где закрытие < открытие alpha : float уровень прозрачности прямоугольника

Возвращает:

ret : кортеж возвращает (lines, patches), где lines - список добавленных линий, а patches - список добавленных прямоугольных фигур

matplotlib.finance.candlestick_ohlc(ax, quotes, width=0.2, colorup='k', colordown='r', alpha=1.0)

Строит график свечей с указанием времени, открытия, максимума, минимума и закрытия в виде вертикальной линии, охватывающей диапазон от минимума до максимума. Использует прямоугольный столбец для отображения разницы между открытием и закрытием. Если закрытие >= открытие, использует цвет colorup для заливки столбца, иначе использует colordown.

Параметры:

ax : Axes экземпляр Axes для построения графика quotes : последовательность последовательностей (time, open, high, low, close, …) Достаточно, чтобы первые 5 элементов были этими значениями, запись может быть сколь угодно длинной (например, может хранить объём). время должно быть в формате дробных дней - см. date2num width : float доля дня для ширины прямоугольника colorup : цвет цвет прямоугольника, где закрытие >= открытие colordown : цвет цвет прямоугольника, где закрытие < открытие alpha : float уровень прозрачности прямоугольника

Возвращает:

ret : кортеж возвращает (lines, patches), где lines - список добавленных линий, а patches - список добавленных прямоугольных фигур

matplotlib.finance.fetch_historical_yahoo(ticker, date1, date2, cachename=None, dividends=False)

Получение исторических данных для тикера между датами date1 и date2. date1 и date2 — экземпляры date или datetime, или последовательности (год, месяц, день).

Параметры:

ticker : str тикер date1 : последовательность вида (год, месяц, день), datetime, или date начальная дата date2 : последовательность вида (год, месяц, день), datetime, или date конечная дата cachename : str имя локального кеша файлов. Если None, будет использоваться md5 хэш или URL (который включает тикер и диапазон дат) dividends : bool установите dividends=True, чтобы вернуть дивиденды вместо данных цен. С этим параметром функции парсинга работать не будут

Возвращает:

file_handle : дескриптор файла возвращается дескриптор файла

Примеры

>>> fh = fetch_historical_yahoo('^GSPC', (2000, 1, 1), (2001, 12, 31))

matplotlib.finance.index_bar(ax, vals, facecolor='b', edgecolor='l', width=4, alpha=1.0)

Добавление графика с набором столбцов, высота vals (-1 означает отсутствующее значение).

Параметры:	ax : Axes экземпляр Axes для построения графика vals : последовательность последовательность значений facecolor : цвет цвет заливки столбца edgecolor : цвет цвет границ столбца width : int ширина столбца в пунктах alpha : float прозрачность столбца
Возвращает:	ret : barCollection Добавленные barrCollection к оси

matplotlib.finance.md5(x)

matplotlib.finance.parse_yahoo_historical_ochl(fh, adjusted=True, asobject=False)

Парсинг исторических данных из файла fh, полученных с Yahoo Finance.

Параметры:

adjusted : bool Если True (по умолчанию), заменяет цены open, close, high, low на их скорректированные значения. Коррекция выполняется с помощью коэффициента S = adjusted_close/close. Скорректированные цены — это фактические цены, умноженные на S. Объём не корректируется, так как уже скорректирован Yahoo на базе обратного разделения. Если нужно вычислить сумму торгов, умножьте объём на скорректированное закрытие, независимо от того, установлено ли adjusted = True|False. asobject : bool или None Если False (по умолчанию для совместимости с предыдущими версиями), возвращает список кортежей, содержащих d, open, close, high, low, volume Если None (предпочтительная альтернатива False), возвращает 2-мерный массив NumPy, соответствующий списку кортежей. В противном случае возвращает массив NumPy recarray со столбцами date, year, month, day, d, open, close, high, low, volume, adjusted_close где d — дробное представление даты, возвращённое date2num, и date — стандартный объект datetime.date из библиотеки Python. Название этого параметра — историческая особенность. Ранее True возвращал экземпляр cbook Bunch, содержащий одномерные массивы NumPy. Поведение массива NumPy recarray очень похоже на Bunch.

matplotlib.finance.parse_yahoo_historical_ohlc(fh, adjusted=True, asobject=False)

Парсинг исторических данных из файла fh от Yahoo Finance.

Параметры:

adjusted : bool Если True (по умолчанию), заменяет цены открытой, высокой, низкой и закрытой позиции на их скорректированные значения. Корректировка производится с помощью масштабного множителя S = adjusted_close/close. Скорректированные цены — это фактические цены, умноженные на S. Объем не корректируется, так как он уже скорректирован Yahoo с учетом обратного разделения. Если вы хотите вычислить торги в долларах, умножьте объем на скорректированную цену закрытия, независимо от того, выбрали ли вы adjusted = True|False. asobject : bool или None Если False (по умолчанию для совместимости с более ранними версиями), возвращает список кортежей, содержащих: d, открытая, высокая, низкая, закрытая, объем Если None (предпочтительный вариант по сравнению с False), возвращает 2-мерный массив ndarray, соответствующий списку кортежей. В противном случае возвращает массив numpy recarray со следующими полями: дата, год, месяц, день, d, открытая, высокая, низкая, закрытая, объем, скорректированная_цена_закрытия где d — плавающее числовое представление даты, как возвращается date2num, а date — экземпляр стандартной библиотеки Python datetime.date. Имя этого ключевого аргумента — исторический артефакт. Раньше True возвращал cbook Bunch, содержащий 1-мерные массивы ndarray. Поведение массива numpy recarray очень похоже на Bunch.

matplotlib.finance.plot_day_summary2_ochl(ax, opens, closes, highs, lows, ticksize=4, colorup='k', colordown='r')

Представляет время, открытие, закрытие, максимум, минимум в виде вертикальной линии, простирающейся от минимума до максимума. Левая отметка — открытие, правая — закрытие.

Параметры:

ax : Axes объект Axes для построения графика opens : последовательность последовательность значений открытия closes : последовательность последовательность значений закрытия highs : последовательность последовательность максимальных значений lows : последовательность последовательность минимальных значений ticksize : целое число размер отметки открытия и закрытия в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие

Возвращает:

ret : список список линий, добавленных на ось

matplotlib.finance.plot_day_summary2_ohlc(ax, opens, highs, lows, closes, ticksize=4, colorup='k', colordown='r')

Представляет время, открытие, максимум, минимум, закрытие в виде вертикальной линии, простирающейся от минимума до максимума. Левая отметка — открытие, правая — закрытие. opens, highs, lows и closes должны иметь одинаковую длину. ПРИМЕЧАНИЕ: этот код предполагает, что если какое-либо значение открытие, максимум, минимум, закрытие отсутствует (-1), то все они отсутствуют.

Параметры:

ax : Axes объект Axes для построения графика opens : последовательность последовательность значений открытия highs : последовательность последовательность максимальных значений lows : последовательность последовательность минимальных значений closes : последовательность последовательность значений закрытия ticksize : целое число размер отметки открытия и закрытия в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие

Возвращает:

ret : список список линий, добавленных на ось

matplotlib.finance.plot_day_summary_oclh(ax, quotes, ticksize=3, colorup='k', colordown='r')

Построение сводки дня

Представляет время, открытие, закрытие, максимум, минимум в виде вертикальной линии, простирающейся от минимума до максимума. Левая отметка — открытие, правая — закрытие.

Параметры:	ax : Axes объект Axes для построения графика quotes : последовательность кортежей (время, открытие, закрытие, максимум, минимум, …) данные для построения. Время должно быть в формате чисел с плавающей запятой — см. date2num ticksize : целое число отметка открытия/закрытия в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие
Возвращает:	lines : список список кортежей добавленных линий (один кортеж на каждую запись)

matplotlib.finance.plot_day_summary_ohlc(ax, quotes, ticksize=3, colorup='k', colordown='r')

Построение сводки дня

Представляет время, открытие, максимум, минимум, закрытие в виде вертикальной линии, простирающейся от минимума до максимума. Левая отметка — открытие, правая — закрытие.

Параметры:	ax : Axes объект Axes для построения графика quotes : последовательность кортежей (время, открытие, максимум, минимум, закрытие, …) данные для построения. Время должно быть в формате чисел с плавающей запятой — см. date2num ticksize : целое число отметка открытия/закрытия в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие
Возвращает:	lines : список список кортежей добавленных линий (один кортеж на каждую запись)

matplotlib.finance.quotes_historical_yahoo_ochl(ticker, date1, date2, asobject=False, adjusted=True, cachename=None)

Получение исторических данных для тикера между датами date1 и date2.

См. parse_yahoo_historical() для объяснения форматов вывода и ключевых слов asobject и adjusted.

Параметры:	ticker : str тикер акций date1 : последовательность в формате (год, месяц, день), datetime, или date начальная дата date2 : последовательность в формате (год, месяц, день), datetime, или date конечная дата cachename : str или None имя локального кеша файла. Если None, будет использоваться md5 хэш или URL (включающий тикер и диапазон дат)

Примеры

>>> sp = f.quotes_historical_yahoo_ochl('^GSPC', d1, d2,
                         asobject=True, adjusted=True)
>>> returns = (sp.open[1:] - sp.open[:-1])/sp.open[1:]
>>> [n,bins,patches] = hist(returns, 100)
>>> mu = mean(returns)
>>> sigma = std(returns)
>>> x = normpdf(bins, mu, sigma)
>>> plot(bins, x, color='red', lw=2)

matplotlib.finance.quotes_historical_yahoo_ohlc(ticker, date1, date2, asobject=False, adjusted=True, cachename=None)

Получение исторических данных для тикера между датами date1 и date2.

См. parse_yahoo_historical() для объяснения форматов вывода и ключевых слов asobject и adjusted.

Параметры:	ticker : str тикер акций date1 : последовательность в формате (год, месяц, день), datetime, или date начальная дата date2 : последовательность в формате (год, месяц, день), datetime, или date конечная дата cachename : str или None имя локального кеша файла. Если None, будет использоваться md5 хэш или URL (включающий тикер и диапазон дат)

Примеры

>>> sp = f.quotes_historical_yahoo_ohlc('^GSPC', d1, d2,
                         asobject=True, adjusted=True)
>>> returns = (sp.open[1:] - sp.open[:-1])/sp.open[1:]
>>> [n,bins,patches] = hist(returns, 100)
>>> mu = mean(returns)
>>> sigma = std(returns)
>>> x = normpdf(bins, mu, sigma)
>>> plot(bins, x, color='red', lw=2)

matplotlib.finance.volume_overlay(ax, opens, closes, volumes, colorup='k', colordown='r', width=4, alpha=1.0)

Добавление наложения объема к текущей оси. Открытия и закрытия используются для определения цвета столбца. -1 обозначает отсутствие данных. Если одно значение отсутствует, то должны отсутствовать все значения.

Параметры:

ax : Axes объект Axes для построения графика opens : последовательность последовательность значений открытия closes : последовательность последовательность значений закрытия volumes : последовательность последовательность значений объемов width : целое число ширина столбца в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие alpha : число с плавающей запятой прозрачность столбцов

Возвращает:

ret : barCollection Добавленные на ось barrCollection

matplotlib.finance.volume_overlay2(ax, closes, volumes, colorup='k', colordown='r', width=4, alpha=1.0)

Добавление наложения объёма на текущую ось. Закрытия используются для определения цвета столбца. -1 означает отсутствие данных. Если значение отсутствует в одном ряду, оно должно отсутствовать во всех.

Примечание: первая точка не отображается — она используется только для выбора правильного цвета.

Параметры:	ax : Axes экземпляр оси для построения графика closes : последовательность последовательность закрытий volumes : последовательность последовательность объёмов width : целое число ширина столбца в пунктах colorup : цвет цвет линий, где закрытие >= открытие colordown : цвет цвет линий, где закрытие < открытие alpha : число с плавающей запятой прозрачность столбца
Возвращаемое значение:	ret : barCollection Элемент barrCollection добавленный на ось

matplotlib.finance.volume_overlay3(ax, quotes, colorup='k', colordown='r', width=4, alpha=1.0)

Добавление наложения объёма на текущую ось. quotes — список (d, открытие, максимум, минимум, закрытие, объём), и закрытие-открытие используется для определения цвета столбца.

Параметры:

ax : Axes экземпляр оси для построения графика quotes : последовательность последовательностей (время, открытие, максимум, минимум, закрытие, …) данные для построения графика. Время должно быть в формате даты с плавающей запятой — см. date2num width : целое число ширина столбца в пунктах colorup : цвет цвет линий, где закрытие1 >= закрытие0 colordown : цвет цвет линий, где закрытие1 < закрытие0 alpha : число с плавающей запятой прозрачность столбца

Возвращаемое значение:

ret : barCollection Элемент barrCollection добавленный на ось