Tutorials - Обучающие материалы BQuant

📚 Обзор

Обучающие материалы помогут вам освоить BQuant от базовых концепций до продвинутых техник.

🎓 Содержание

🚀 Быстрый старт (5 минут) - Универсальный анализ зон

7 разделов: MACD, RSI, AO, пересечение скользящих средних, предзагруженные зоны, кэширование, модульное использование
Универсальный API: демонстрация fluent builder для всех индикаторов
Ноль дублирования кода: таблица сравнения индикаторов без копирования
297 строк готового к продакшену кода

📊 Глубокое погружение (30 минут) - Полный конвейер анализа

10 шагов NotebookSimulator: от загрузки данных до модульных сценариев
Сравнение старого и нового API: производительность и функциональность
Эксперименты со стратегиями детекции: все 5 типов стратегий
Анализ чувствительности параметров: влияние настроек на качество зон
Полный анализ-пайплайн: признаки, кластеризация, статистические тесты, анализ последовательностей
412 строк всестороннего анализа

🔬 Продвинутые возможности - Свинг, дивергенции, регрессия

10 шагов: от базового анализа до регрессии и валидации
Свинг-стратегии: FindPeaks, PivotPoints, ZigZag (все три работают!)
Расширенные возможности: анализ дивергенций, объёма, волатильности
Миграция на v2.1: полный переход с устаревшего API
Автоматизация статистических гипотез: тесты внутри конвейера

🔄 Руководство по миграции - Старый и новый API

Legacy vs New API: сравнение старого и нового подходов
Предупреждения об устаревании: демонстрация предупреждений
Сравнение производительности: время выполнения и использование памяти
Несколько стратегий: zero_crossing, line_crossing, комбинированные правила
241 строка примеров миграции

🧭 Пошаговые tutorials (v2.1)

MACD zones (Пример 1) — базовый pipeline и визуализация результатов с ZoneVisualizer.
RSI zones (Пример 5) — демонстрация смены стратегий threshold → line_crossing без повторного расчёта индикатора.
Combined Rules (Пример 8) — конфигурация CombinedRulesDetection с AND/OR логикой и ручной отладкой.
Preloaded зоны (Пример 3 + Сценарий 9) — работа с внешними CSV, load_preloaded_zones() и сравнительный анализ экспертов против автоматических стратегий.

🏗️ [Будущие учебные материалы (TODO)] - План

Разработка собственных стратегий - создание пользовательских правил детекции
Шаблоны интеграции с ML - взаимодействие с моделями машинного обучения
Оптимизация производительности - повышение скорости и эффективности
Развёртывание в продакшене - переход из исследований в эксплуатацию

🎯 Целевая аудитория

👶 Начинающие

Быстрый старт - основы универсального API
Руководство по миграции - переход со старого API

👨‍💻 Продвинутые пользователи

Глубокое погружение - полный конвейер анализа
Продвинутые возможности - свинг, дивергенции, регрессия

🚀 Эксперты

Будущие учебные материалы - пользовательские стратегии, интеграция с ML
Оптимизация производительности - вывод решений в продакшен

📋 Предварительные требования

Базовые знания

Python 3.8+
Pandas и NumPy
Основы статистики
Финансовые данные (OHLCV)

Установка

pip install bquant

🚀 Рекомендуемый порядок изучения

Траектория изучения архитектуры

Быстрый старт - основы универсального API → паттерн Fluent Builder
Глубокое погружение - полное понимание → двухслойная архитектура
Продвинутые возможности - расширенные функции → конфигурация стратегий
Руководство по миграции - переход с legacy → шаблоны устаревания

💡 Советы по изучению

🎯 Практический подход

Выполняйте все примеры - Не просто читайте, а запускайте код
Экспериментируйте - Изменяйте параметры и наблюдайте результаты
Используйте sample данные - Для безопасных экспериментов
Ведите заметки - Записывайте важные моменты

🔧 Технические советы

Используйте Jupyter Notebooks - Для интерактивного изучения
Создайте виртуальное окружение - Для изоляции зависимостей
Изучайте ошибки - Они помогают понять систему
Задавайте вопросы - Используйте GitHub Issues

📚 Дополнительные ресурсы

Справочник API - подробная документация
Примеры - готовые сценарии
Руководство пользователя - последовательное обучение

🎓 Структура каждого tutorial

Каждый tutorial содержит:

📖 Теория

Объяснение концепций
Математические основы
Принципы работы

💻 Практика

Пошаговые примеры
Готовый код
Интерактивные упражнения

🔍 Анализ

Интерпретация результатов
Лучшие практики
Типичные ошибки

🚀 Следующие шаги

Продолжение изучения
Дополнительные ресурсы
Практические задания

🤝 Поддержка

Если что-то не работает

Проверьте версии - Убедитесь в совместимости
Изучите ошибки - Читайте сообщения об ошибках
Создайте issue - На GitHub с подробным описанием

Если нужна помощь

GitHub Issues - Для багов и проблем
GitHub Discussions - Для вопросов и обсуждений
Documentation - Изучите API Reference

🔗 Связанные разделы

Руководство пользователя - основное обучение
Справочник API - подробности по модулям
Примеры - практические сценарии
Руководство разработчика - расширение и вклад

Начать изучение: Быстрый стартовый tutorial 🚀