Skip to content

Celeevo/cerebroview

Repository files navigation

CerebroView

Современная HTML-визуализация результатов Backtrader на основе TradingView Lightweight Charts. Прямая замена cerebro.plot() без изменения стратегии и расчетов.

Python License Lightweight Charts

img.png

Быстрый старт

from cerebroview import plot

# здесь создается cerebro, добавляются данные, стратегия, комиссии и т.п.

cerebro.run()
plot(cerebro)

После cerebro.run() вместо cerebro.plot() вызывается plot(cerebro). График открывается на вкладке браузера.

Возможности

  • свечи, объем и индикаторы рисуются автоматически по plotinfo.subplot и plotyhlines стратегии;
  • маркеры сделок с подсказками: цена входа, цена выхода, длительность в барах и PnL;
  • панель Cash / Value по стандартному наблюдателю Backtrader;
  • несколько источников данных в одном HTML, с общей временной шкалой;
  • масштабирование колесом мыши, перетаскивание, синхронизация перекрестия между панелями;
  • перетаскиваемые границы панелей и адаптация к высоте окна;
  • дерево объектов — галочками включаются и выключаются индикаторы, отдельные панели, сделки и рисунки;
  • окно данных, показывающее значения всех серий ровно под курсором;
  • инструменты разметки (линии, прямоугольники, флаги, стрелки, выноски, текст) с сохранением в памяти браузера;
  • экспорт в автономный HTML и CSV;
  • светлая и темная тема, переключатель типа графика (свечи / бары / линия) — без перезапуска стратегии.

Установка

Через pip

python -m pip install cerebroview

Копированием папки

Альтернатива без установки в окружение, скопируйте папку cerebroview в корень проекта рядом со скриптом стратегии:

your_project/
├── cerebroview/
└── your_strategy.py

Импорт остается прежним:

from cerebroview import plot

Использование

В верхней панели графика доступны:

  • переключатель типа графика — свечи, бары или линия;
  • светлая / темная тема;
  • Undo / Redo для инструментов разметки;
  • сохранение в автономный HTML;
  • скачивание CSV (по одному файлу на источник данных);
  • кнопки открытия дерева объектов и окна данных;
  • панель инструментов разметки.

Демонстрация

В репозитории есть демонстрационный скрипт со всеми возможностями:

python showcase_all_features_v082_updated.py

Он запускает Backtrader на двух искусственных инструментах с разными индикаторами и заранее подобранными сделками, а затем открывает интерактивный HTML-отчет.

Требования

  • Python 3.9 или новее;
  • backtrader;
  • современный браузер;
  • доступ в интернет при первом открытии графика — Lightweight Charts подгружается с CDN.

Для запуска демонстрационного скрипта дополнительно требуется pandas.

Документация

  • docs/USER_GUIDE_RU.md — руководство пользователя, параметры plot(...), описание поддерживаемых индикаторов и наблюдателей.

Лицензия

MIT — см. файл LICENSE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages