PriceGenerator — Release notes

• 🇷🇺 Релиз-ноты на русском (see release notes in russian here)
• 📚 Документация для модуля PriceGenerator и примеры работы с CLI
• ⚙️ API-документация PriceGenerator
• 🎁 Поддержите проект пожертвованием на наш кошелёк ЮMoney: 410015019068268

[1.4.93 (2023-11-25)] — released

Обзор

Теперь значения объёма зависят от предыдущего значения и вероятности выбросов и выглядят более реалистично. Алгоритм генератора создаёт серию свечей, лучше подходящих для сложных трендов, включая различные выбросы для верхних и нижних теней свечей и их тел. Также больше не должны появляться ошибки с отрицательными числами в серии.

Пример долгосрочной серии с реалистичным разбросом значений объёма и различными трендами:

Новые функции

• Алгоритм генератора теперь создаёт серию свечей, лучше подходящую для сложных трендов и включающую различные выбросы для верхней и нижней теней свечей.

Улучшения

• Тип ZigZagFilter() был изменён на Pandas Dataframe вместо dict.
• Значения объёма теперь зависят от предыдущего значения и вероятности выбросов.

Исправления ошибок

• Исправлена ошибка с отрицательными числами в сериях.

[1.3.81 (2023-01-05)] — released

Обзор

ВНИМАНИЕ! Версия Python была изменена на 3.9.

Теперь вы можете рисовать дополнительные пользовательские линии и маркеры на основной диаграмме со свечами (используя метод RenderBokeh()). Вы можете указать направления тренда простыми словами: вверх, вниз, нет или символами: u, d, n при использовании ключа --split-trend (в дополнение к существующей возможности идентифицировать тренд с помощью символов /-), например, --split-trend=up-down-no-up, --split-trend=u-d-n-u и т. д. Кроме того, вы можете выбрать темы для диаграмм, нарисованных методом RenderBokeh(), с новым параметром darkTheme (если True, то используется тёмная тема, иначе светлая тема).

Пример светлой темы (с некоторыми пользовательскими маркерами и новой средней линией):

Пример тёмной темы (с некоторыми пользовательскими маркерами):

Новые функции

• Поддержка версии Python была изменена на 3.9.
• В метод RenderBokeh() были добавлены параметры layouts. Вы можете добавить новые объекты Bokeh Chart на основную диаграмму с этим параметром. Также был добавлен параметр darkTheme. Если он равен True, будет использоваться тёмная тема, False (по умолчанию) означает светлую тему. Также вы можете манипулировать диаграммой и добавлять линии или маркеры к основной диаграмме. Используйте параметры markers и lines для этого. markers — это Pandas Dataframe с пользовательскими сериями, где дополнительные маркеры будут размещаться на основной серии. По умолчанию None. Один маркер — это пользовательский символ, например ×, ↓ или ↑ или кто-то ещё. Данные маркера должны содержать как минимум два столбца. Есть datetime с датой и временем и некоторые столбцы маркеров. Возможность задавать направления с помощью слов или символов была добавлена.

Слова могут быть следующими: up, down, no или символы: u, d, n для ключа --split-trend, в дополнение к существующей возможности устанавливать тренд с помощью символов /-. Для разделения слов или символов используйте символ дефиса, например, --split-trend=up-down-no-up, --split-trend=u-d-n-u и т. д.

Был добавлен API-doc по модулю PriceGenerator.

Улучшения:

• Был улучшен вид блока статистики.
• Были добавлены примеры: как создать цепочку цен без свечей.

Исправления ошибок:

• Ошибка с неверными значениями максимума и минимума при установленном тренде была исправлена.
• Ошибка с некорректными множественными подсказками на графике и некорректной шириной видимой области была исправлена.
• Некорректные предупреждения были отключены.

[1.2.58 (2021-12-09)] — выпущено

Новые функции:

• Лицензия изменена с MIT на Apache-2.0.
• Добавлена возможность разделять свечи по некоторым трендам. Были реализованы два дополнительных ключа: --split-trend и --split-count. Эти ключи влияют на внешний вид тренда и количество свечей в каждом тренде.
  • Ключ --split-trend показывает движения тренда, например, --split-trend=/- означает, что сгенерированные свечи имеют восходящий тренд в первой части, затем нисходящий тренд и после этого отсутствие тренда.
  • Ключ --split-count устанавливает количество свечей разных периодов, например, --split-count 5 10 15 означает, что сгенерированные свечи имеют 3 тренда с 5, 10 и 15 свечами в цепочке.

[1.2.46 (2021-02-28)] — выпущено

Новые функции:

• Некоторые скользящие средние были добавлены в график Bokeh с библиотекой pandas_ta:
  • Простые скользящие средние (5, 20, 50, 200),
  • Скользящие средние Халла (5, 20),
  • Взвешенные по объёму скользящие средние (5, 20).
• Также по умолчанию отображаются только «Max_close / Min_close / Линия тренда».
• Реализованы индикаторы волатильности:
  • Полосы Боллинджера,
  • Параболическая система SAR,
  • Аллигатор (на основе HMA 13, 8, 5),
  • Зигзаг с отклонением 3% по умолчанию.
• Была добавлена диаграмма объёма.
• На основном и объёмном графиках появились всплывающие подсказки свечей.

Улучшения:

• Было добавлено больше тестов и примеров. Также был проведён небольшой рефакторинг. Все используемые библиотеки были обновлены.
• Ключ —horizon при загрузке из файла используется для указания загрузки последних N = горизонт свечей.
• Ключ —precision используется для указания знаков после запятой.

Исправление ошибок:

• Ошибки с нераспознанным таймфреймом при рендеринге из Pandas DataFrame без загрузки из файла были исправлены.

[1.1.30 (2021-02-20)] — выпущено

Новые функции:

Было добавлено множество ключей для CLI: --ticker, --timeframe, --start, --horizon, --max-close, --min-close, --init-close, --max-outlier, --max-body, --max-volume, --up-candles-prob и др. --outliers-prob, --trend-deviation. Эти ключи переопределяют параметры по умолчанию.

Реализован новый метод RenderGoogle() и ключ --render-google, который может рисовать неинтерактивную свечную диаграмму Google.

Улучшения

Добавлены расширенные примеры. См. примеры в README.md (на английском языке) и README_RU.md (на русском языке).

1.0.19 (2021-02-05) — выпущена

Ретроспектива

Первая версия библиотеки PriceGenerator позволяет:

• сохранять сгенерированные цены в формате csv (пример: ./media/test.csv);
• сохранять сгенерированные цены в переменную Pandas DataFrame для дальнейшего использования в сценариях автоматизации;
• автоматически вычислять некоторые статистические и вероятностные характеристики сгенерированных цен и сохранять их в формате Markdown (пример: ./media/index.html.md);
• загружать цены реальных инструментов в соответствии с моделью OHLCV-свечей из файла csv и проводить их статистический анализ;
  • рисовать график сгенерированных или загруженных реальных цен и сохранять его в формате html (пример: ./media/index.html);
  • генерировать цены, график и некоторые данные о поведении цен можно сохранить как обычное изображение png (пример: ./media/index.html.png).