bquant 0.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- bquant-0.0.0/CHANGELOG.md +96 -0
- bquant-0.0.0/LICENSE +21 -0
- bquant-0.0.0/MANIFEST.in +49 -0
- bquant-0.0.0/PKG-INFO +167 -0
- bquant-0.0.0/README.md +114 -0
- bquant-0.0.0/bquant/__init__.py +31 -0
- bquant-0.0.0/bquant/analysis/__init__.py +297 -0
- bquant-0.0.0/bquant/analysis/candlestick/__init__.py +100 -0
- bquant-0.0.0/bquant/analysis/chart/__init__.py +98 -0
- bquant-0.0.0/bquant/analysis/statistical/__init__.py +414 -0
- bquant-0.0.0/bquant/analysis/statistical/hypothesis_testing.py +657 -0
- bquant-0.0.0/bquant/analysis/technical/__init__.py +98 -0
- bquant-0.0.0/bquant/analysis/timeseries/__init__.py +102 -0
- bquant-0.0.0/bquant/analysis/zones/__init__.py +547 -0
- bquant-0.0.0/bquant/analysis/zones/sequence_analysis.py +661 -0
- bquant-0.0.0/bquant/analysis/zones/zone_features.py +520 -0
- bquant-0.0.0/bquant/cli.py +160 -0
- bquant-0.0.0/bquant/core/__init__.py +112 -0
- bquant-0.0.0/bquant/core/cache.py +534 -0
- bquant-0.0.0/bquant/core/config.py +328 -0
- bquant-0.0.0/bquant/core/exceptions.py +351 -0
- bquant-0.0.0/bquant/core/logging_config.py +368 -0
- bquant-0.0.0/bquant/core/numpy_fix.py +99 -0
- bquant-0.0.0/bquant/core/performance.py +554 -0
- bquant-0.0.0/bquant/core/utils.py +327 -0
- bquant-0.0.0/bquant/data/__init__.py +85 -0
- bquant-0.0.0/bquant/data/loader.py +436 -0
- bquant-0.0.0/bquant/data/processor.py +644 -0
- bquant-0.0.0/bquant/data/samples/__init__.py +442 -0
- bquant-0.0.0/bquant/data/samples/datasets.py +246 -0
- bquant-0.0.0/bquant/data/samples/embedded/__init__.py +16 -0
- bquant-0.0.0/bquant/data/samples/embedded/mt_xauusd_m15.py +9018 -0
- bquant-0.0.0/bquant/data/samples/embedded/tv_xauusd_1h.py +17018 -0
- bquant-0.0.0/bquant/data/samples/utils.py +393 -0
- bquant-0.0.0/bquant/data/schemas.py +285 -0
- bquant-0.0.0/bquant/data/validator.py +498 -0
- bquant-0.0.0/bquant/indicators/__init__.py +115 -0
- bquant-0.0.0/bquant/indicators/base.py +487 -0
- bquant-0.0.0/bquant/indicators/calculators.py +404 -0
- bquant-0.0.0/bquant/indicators/library.py +514 -0
- bquant-0.0.0/bquant/indicators/loaders.py +413 -0
- bquant-0.0.0/bquant/indicators/macd.py +754 -0
- bquant-0.0.0/bquant/ml/__init__.py +19 -0
- bquant-0.0.0/bquant/visualization/__init__.py +316 -0
- bquant-0.0.0/bquant/visualization/charts.py +616 -0
- bquant-0.0.0/bquant/visualization/statistical.py +812 -0
- bquant-0.0.0/bquant/visualization/themes.py +599 -0
- bquant-0.0.0/bquant/visualization/zones.py +775 -0
- bquant-0.0.0/bquant.egg-info/PKG-INFO +167 -0
- bquant-0.0.0/bquant.egg-info/SOURCES.txt +143 -0
- bquant-0.0.0/bquant.egg-info/dependency_links.txt +1 -0
- bquant-0.0.0/bquant.egg-info/entry_points.txt +2 -0
- bquant-0.0.0/bquant.egg-info/requires.txt +34 -0
- bquant-0.0.0/bquant.egg-info/top_level.txt +1 -0
- bquant-0.0.0/docs/README.md +125 -0
- bquant-0.0.0/docs/api/README.md +181 -0
- bquant-0.0.0/docs/api/analysis/README.md +330 -0
- bquant-0.0.0/docs/api/core/README.md +183 -0
- bquant-0.0.0/docs/api/data/README.md +250 -0
- bquant-0.0.0/docs/api/extension_guide.md +687 -0
- bquant-0.0.0/docs/api/indicators/README.md +315 -0
- bquant-0.0.0/docs/api/visualization/README.md +490 -0
- bquant-0.0.0/docs/developer_guide/README.md +368 -0
- bquant-0.0.0/docs/examples/README.md +268 -0
- bquant-0.0.0/docs/index.rst +93 -0
- bquant-0.0.0/docs/tutorials/README.md +165 -0
- bquant-0.0.0/docs/user_guide/README.md +103 -0
- bquant-0.0.0/docs/user_guide/quick_start.md +198 -0
- bquant-0.0.0/examples/01_basic_indicators.py +297 -0
- bquant-0.0.0/examples/02_macd_zone_analysis.py +411 -0
- bquant-0.0.0/examples/03_data_processing.py +510 -0
- bquant-0.0.0/examples/04_comprehensive_analysis.py +716 -0
- bquant-0.0.0/examples/README.md +244 -0
- bquant-0.0.0/pyproject.toml +125 -0
- bquant-0.0.0/scripts/README.md +65 -0
- bquant-0.0.0/scripts/analysis/README.md +139 -0
- bquant-0.0.0/scripts/analysis/batch_analysis.py +840 -0
- bquant-0.0.0/scripts/analysis/run_macd_analysis.py +566 -0
- bquant-0.0.0/scripts/analysis/test_hypotheses.py +756 -0
- bquant-0.0.0/scripts/data/extract_samples.py +569 -0
- bquant-0.0.0/scripts/data_processing/README.md +120 -0
- bquant-0.0.0/scripts/deployment/README.md +212 -0
- bquant-0.0.0/scripts/publishing/README.md +201 -0
- bquant-0.0.0/setup.cfg +4 -0
- bquant-0.0.0/tests/conftest.py +231 -0
- bquant-0.0.0/tests/fixtures/__init__.py +267 -0
- bquant-0.0.0/tests/integration/__init__.py +17 -0
- bquant-0.0.0/tests/integration/test_data_pipeline.py +172 -0
- bquant-0.0.0/tests/integration/test_full_pipeline.py +421 -0
- bquant-0.0.0/tests/integration/test_scripts_integration.py +515 -0
- bquant-0.0.0/tests/integration/test_visualization_pipeline.py +453 -0
- bquant-0.0.0/tests/unit/__init__.py +17 -0
- bquant-0.0.0/tests/unit/test_analysis_structure.py +481 -0
- bquant-0.0.0/tests/unit/test_core_modules.py +224 -0
- bquant-0.0.0/tests/unit/test_data_modules.py +307 -0
- bquant-0.0.0/tests/unit/test_indicators_base.py +340 -0
- bquant-0.0.0/tests/unit/test_macd_analyzer.py +503 -0
- bquant-0.0.0/tests/unit/test_performance.py +584 -0
- bquant-0.0.0/tests/unit/test_sample_data.py +464 -0
- bquant-0.0.0/tests/unit/test_statistical_hypothesis.py +432 -0
- bquant-0.0.0/tests/unit/test_visualization.py +597 -0
- bquant-0.0.0/tests/unit/test_zones_analysis.py +528 -0
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [Unreleased]
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- Initial release of BQuant package
|
|
12
|
+
- Complete migration from Quanto project
|
|
13
|
+
- Comprehensive technical analysis framework
|
|
14
|
+
- MACD zone analysis with statistical testing
|
|
15
|
+
- Advanced data processing and validation
|
|
16
|
+
- Professional visualization system
|
|
17
|
+
- Embedded sample data for testing
|
|
18
|
+
- CLI scripts for analysis automation
|
|
19
|
+
- Complete documentation and examples
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
## [0.0.0] - 2024-08-25
|
|
23
|
+
|
|
24
|
+
### Added
|
|
25
|
+
- Foundation for BQuant project
|
|
26
|
+
- Basic project structure
|
|
27
|
+
- Core configuration system
|
|
28
|
+
- Initial test framework
|
|
29
|
+
- Initial beta release
|
|
30
|
+
- Basic MACD analysis functionality
|
|
31
|
+
- Core data processing capabilities
|
|
32
|
+
- Preliminary documentation
|
|
33
|
+
|
|
34
|
+
### Structure
|
|
35
|
+
|
|
36
|
+
- **Core Modules**: Configuration, exceptions, logging, performance, utilities
|
|
37
|
+
- **Data Modules**: Loader, processor, validator, samples, schemas
|
|
38
|
+
- **Indicators**: Base classes, MACD analyzer, factory pattern
|
|
39
|
+
- **Analysis**: Statistical analysis, zone analysis, hypothesis testing
|
|
40
|
+
- **Visualization**: Financial charts, zone visualization, statistical plots, themes
|
|
41
|
+
- **Research Structure**: Notebooks, methodology, experiments, studies
|
|
42
|
+
- **Scripts**: Analysis automation, data processing, deployment tools
|
|
43
|
+
- **Documentation**: Complete API reference, user guide, tutorials, examples
|
|
44
|
+
|
|
45
|
+
### Technical Features
|
|
46
|
+
- **MACD Zone Analysis**: Advanced MACD analysis with zone identification
|
|
47
|
+
- **Statistical Testing**: Comprehensive hypothesis testing framework
|
|
48
|
+
- **Data Processing**: Robust data loading, cleaning, and validation
|
|
49
|
+
- **Performance Optimization**: Caching system and optimized algorithms
|
|
50
|
+
- **Visualization**: Professional charts with multiple themes
|
|
51
|
+
- **Sample Data**: Embedded financial data for testing and examples
|
|
52
|
+
|
|
53
|
+
### Architecture
|
|
54
|
+
- **Modular Design**: Clean separation of concerns
|
|
55
|
+
- **Type Safety**: Full type hints and validation
|
|
56
|
+
- **Error Handling**: Comprehensive exception system
|
|
57
|
+
- **Logging**: Professional logging with multiple levels
|
|
58
|
+
- **Testing**: Complete test coverage with pytest
|
|
59
|
+
- **Documentation**: Sphinx-based documentation system
|
|
60
|
+
|
|
61
|
+
### Dependencies
|
|
62
|
+
- **Core**: pandas, numpy, matplotlib, seaborn
|
|
63
|
+
- **Analysis**: scipy, scikit-learn, statsmodels
|
|
64
|
+
- **Visualization**: plotly, seaborn
|
|
65
|
+
- **Development**: pytest, black, flake8, mypy
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Version History
|
|
70
|
+
|
|
71
|
+
### Semantic Versioning
|
|
72
|
+
- **MAJOR**: Incompatible API changes
|
|
73
|
+
- **MINOR**: New functionality in backward-compatible manner
|
|
74
|
+
- **PATCH**: Backward-compatible bug fixes
|
|
75
|
+
|
|
76
|
+
### Release Schedule
|
|
77
|
+
- **Major releases**: Every 6 months
|
|
78
|
+
- **Minor releases**: Every 2-4 weeks
|
|
79
|
+
- **Patch releases**: As needed for critical fixes
|
|
80
|
+
|
|
81
|
+
### Support Policy
|
|
82
|
+
- **Current version**: Full support
|
|
83
|
+
- **Previous major version**: Bug fixes only
|
|
84
|
+
- **Older versions**: No support
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## Contributing
|
|
89
|
+
|
|
90
|
+
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
|
|
91
|
+
|
|
92
|
+
## Acknowledgments
|
|
93
|
+
|
|
94
|
+
- Original Quanto project contributors
|
|
95
|
+
- Open source financial analysis community
|
|
96
|
+
- Python packaging and documentation tools
|
bquant-0.0.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 BQuant Team
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
bquant-0.0.0/MANIFEST.in
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Include README and LICENSE
|
|
2
|
+
include README.md
|
|
3
|
+
include LICENSE
|
|
4
|
+
include CHANGELOG.md
|
|
5
|
+
|
|
6
|
+
# Include package data
|
|
7
|
+
recursive-include bquant *.py
|
|
8
|
+
recursive-include bquant *.pyi
|
|
9
|
+
recursive-include bquant *.txt
|
|
10
|
+
recursive-include bquant *.json
|
|
11
|
+
recursive-include bquant *.yaml
|
|
12
|
+
recursive-include bquant *.yml
|
|
13
|
+
|
|
14
|
+
# Include documentation
|
|
15
|
+
recursive-include docs *.md
|
|
16
|
+
recursive-include docs *.rst
|
|
17
|
+
recursive-include docs *.txt
|
|
18
|
+
|
|
19
|
+
# Include examples
|
|
20
|
+
recursive-include examples *.py
|
|
21
|
+
recursive-include examples *.ipynb
|
|
22
|
+
recursive-include examples *.md
|
|
23
|
+
|
|
24
|
+
# Include tests
|
|
25
|
+
recursive-include tests *.py
|
|
26
|
+
recursive-include tests *.json
|
|
27
|
+
recursive-include tests *.yaml
|
|
28
|
+
|
|
29
|
+
# Include scripts
|
|
30
|
+
recursive-include scripts *.py
|
|
31
|
+
recursive-include scripts *.md
|
|
32
|
+
|
|
33
|
+
# Exclude development files
|
|
34
|
+
global-exclude *.pyc
|
|
35
|
+
global-exclude *.pyo
|
|
36
|
+
global-exclude *.pyd
|
|
37
|
+
global-exclude __pycache__
|
|
38
|
+
global-exclude .git*
|
|
39
|
+
global-exclude .DS_Store
|
|
40
|
+
global-exclude *.egg-info
|
|
41
|
+
global-exclude .pytest_cache
|
|
42
|
+
global-exclude .coverage
|
|
43
|
+
global-exclude htmlcov
|
|
44
|
+
global-exclude .tox
|
|
45
|
+
global-exclude .venv
|
|
46
|
+
global-exclude venv*
|
|
47
|
+
global-exclude .env
|
|
48
|
+
global-exclude .vscode
|
|
49
|
+
global-exclude .idea
|
bquant-0.0.0/PKG-INFO
ADDED
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: bquant
|
|
3
|
+
Version: 0.0.0
|
|
4
|
+
Summary: Quantitative research toolkit for financial markets
|
|
5
|
+
Author-email: kogriv <kogriv@gmail.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/kogriv/bquant
|
|
8
|
+
Project-URL: Documentation, https://bquant.readthedocs.io/
|
|
9
|
+
Project-URL: Repository, https://github.com/kogriv/bquant.git
|
|
10
|
+
Project-URL: Issues, https://github.com/kogriv/bquant/issues
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Intended Audience :: Financial and Insurance Industry
|
|
13
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
16
|
+
Classifier: Topic :: Office/Business :: Financial
|
|
17
|
+
Classifier: Topic :: Scientific/Engineering :: Information Analysis
|
|
18
|
+
Requires-Python: >=3.13
|
|
19
|
+
Description-Content-Type: text/markdown
|
|
20
|
+
License-File: LICENSE
|
|
21
|
+
Requires-Dist: pandas==2.3.1
|
|
22
|
+
Requires-Dist: numpy==2.3.2
|
|
23
|
+
Requires-Dist: matplotlib==3.10.5
|
|
24
|
+
Requires-Dist: seaborn==0.13.2
|
|
25
|
+
Requires-Dist: pandas-ta==0.3.14b0
|
|
26
|
+
Requires-Dist: statsmodels==0.14.5
|
|
27
|
+
Requires-Dist: scipy==1.16.1
|
|
28
|
+
Requires-Dist: scikit-learn==1.7.1
|
|
29
|
+
Requires-Dist: plotly==6.3.0
|
|
30
|
+
Requires-Dist: kaleido==1.0.0
|
|
31
|
+
Requires-Dist: ipywidgets==8.1.7
|
|
32
|
+
Requires-Dist: psutil>=5.9.0
|
|
33
|
+
Provides-Extra: dev
|
|
34
|
+
Requires-Dist: pytest>=6.0; extra == "dev"
|
|
35
|
+
Requires-Dist: pytest-cov>=2.0; extra == "dev"
|
|
36
|
+
Requires-Dist: black>=21.0; extra == "dev"
|
|
37
|
+
Requires-Dist: flake8>=3.8; extra == "dev"
|
|
38
|
+
Provides-Extra: notebooks
|
|
39
|
+
Requires-Dist: jupyter==1.1.1; extra == "notebooks"
|
|
40
|
+
Requires-Dist: ipywidgets==8.1.7; extra == "notebooks"
|
|
41
|
+
Requires-Dist: plotly==6.3.0; extra == "notebooks"
|
|
42
|
+
Requires-Dist: kaleido==1.0.0; extra == "notebooks"
|
|
43
|
+
Provides-Extra: full
|
|
44
|
+
Requires-Dist: pytest>=6.0; extra == "full"
|
|
45
|
+
Requires-Dist: pytest-cov>=2.0; extra == "full"
|
|
46
|
+
Requires-Dist: black>=21.0; extra == "full"
|
|
47
|
+
Requires-Dist: flake8>=3.8; extra == "full"
|
|
48
|
+
Requires-Dist: jupyter==1.1.1; extra == "full"
|
|
49
|
+
Requires-Dist: ipywidgets==8.1.7; extra == "full"
|
|
50
|
+
Requires-Dist: plotly==6.3.0; extra == "full"
|
|
51
|
+
Requires-Dist: kaleido==1.0.0; extra == "full"
|
|
52
|
+
Dynamic: license-file
|
|
53
|
+
|
|
54
|
+
# BQuant - Quantitative Research Toolkit
|
|
55
|
+
|
|
56
|
+
**BQuant** is a universal toolkit for quantitative research of financial markets. The project starts with MACD zone analysis as the first use case, but the architecture is designed for exploring various aspects: technical indicators, chart patterns, candlestick formations, time series, and machine learning applications.
|
|
57
|
+
|
|
58
|
+
## 🔧 Key Features
|
|
59
|
+
|
|
60
|
+
- **Universal configuration system** - support for multiple data sources and brokers
|
|
61
|
+
- **Multi-level analysis** - technical, statistical, graphical, candlestick, time series
|
|
62
|
+
- **ML readiness** - structure for machine learning (stubs)
|
|
63
|
+
- **Visualization tools** - charts and reports
|
|
64
|
+
- **Research environment** - notebooks and experiments
|
|
65
|
+
- **Automated pipelines** - ready-to-use analysis scripts
|
|
66
|
+
|
|
67
|
+
## 🚀 Quick Start
|
|
68
|
+
|
|
69
|
+
### Installation
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
# Install in development mode
|
|
73
|
+
pip install -e .
|
|
74
|
+
|
|
75
|
+
# Install with optional dependencies
|
|
76
|
+
pip install -e .[dev,notebooks]
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Basic Usage
|
|
80
|
+
|
|
81
|
+
```python
|
|
82
|
+
from bquant.data import load_symbol_data
|
|
83
|
+
from bquant.indicators import MACDAnalyzer
|
|
84
|
+
|
|
85
|
+
# Load data
|
|
86
|
+
data = load_symbol_data('XAUUSD', '1h')
|
|
87
|
+
|
|
88
|
+
# Analyze MACD zones
|
|
89
|
+
analyzer = MACDAnalyzer(data, fast=8, slow=21)
|
|
90
|
+
zones = analyzer.identify_zones()
|
|
91
|
+
|
|
92
|
+
print(f"Found {len(zones)} zones")
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Command Line
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
# Analyze single instrument
|
|
99
|
+
bquant-analyze XAUUSD
|
|
100
|
+
|
|
101
|
+
# Batch analysis
|
|
102
|
+
bquant-batch EURUSD GBPUSD XAUUSD
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## 📋 Project Structure
|
|
106
|
+
|
|
107
|
+
This is a monorepo that contains:
|
|
108
|
+
|
|
109
|
+
- **`bquant/`** - Python package (for PyPI)
|
|
110
|
+
- **`research/`** - Jupyter notebooks and experiments
|
|
111
|
+
- **`scripts/`** - Automation scripts
|
|
112
|
+
- **`data/`** - Data storage
|
|
113
|
+
- **`tests/`** - Test suite
|
|
114
|
+
- **`docs/`** - Documentation
|
|
115
|
+
|
|
116
|
+
## 🛠️ Development
|
|
117
|
+
|
|
118
|
+
### Setting up development environment
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
# Create virtual environment
|
|
122
|
+
python -m venv venv_bquant_dell
|
|
123
|
+
|
|
124
|
+
# Activate (Windows)
|
|
125
|
+
venv_bquant_dell\Scripts\activate
|
|
126
|
+
|
|
127
|
+
# Activate (Linux/Mac)
|
|
128
|
+
source venv_bquant_dell/bin/activate
|
|
129
|
+
|
|
130
|
+
# Install dependencies
|
|
131
|
+
pip install -r requirements.txt
|
|
132
|
+
|
|
133
|
+
# Install in development mode
|
|
134
|
+
pip install -e .[dev]
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### Running tests
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
pytest tests/ -v
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## 📚 Documentation
|
|
144
|
+
|
|
145
|
+
- [API Documentation](docs/api/)
|
|
146
|
+
- [Tutorials](docs/tutorials/)
|
|
147
|
+
- [Examples](docs/examples/)
|
|
148
|
+
|
|
149
|
+
## 🎯 Roadmap
|
|
150
|
+
|
|
151
|
+
- **Phase 1**: Core functionality (data, MACD analysis, statistics)
|
|
152
|
+
- **Phase 2**: Extended visualization, time series, other indicators
|
|
153
|
+
- **Phase 3**: Full ML, chart patterns, automation
|
|
154
|
+
|
|
155
|
+
## 📄 License
|
|
156
|
+
|
|
157
|
+
MIT License - see [LICENSE](LICENSE) file for details.
|
|
158
|
+
|
|
159
|
+
## 🤝 Contributing
|
|
160
|
+
|
|
161
|
+
Contributions are welcome! Please read our contributing guidelines and submit pull requests.
|
|
162
|
+
|
|
163
|
+
## 📞 Contact
|
|
164
|
+
|
|
165
|
+
- **Author**: kogriv
|
|
166
|
+
- **Email**: kogriv@gmail.com
|
|
167
|
+
- **Repository**: https://github.com/kogriv/bquant
|
bquant-0.0.0/README.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# BQuant - Quantitative Research Toolkit
|
|
2
|
+
|
|
3
|
+
**BQuant** is a universal toolkit for quantitative research of financial markets. The project starts with MACD zone analysis as the first use case, but the architecture is designed for exploring various aspects: technical indicators, chart patterns, candlestick formations, time series, and machine learning applications.
|
|
4
|
+
|
|
5
|
+
## 🔧 Key Features
|
|
6
|
+
|
|
7
|
+
- **Universal configuration system** - support for multiple data sources and brokers
|
|
8
|
+
- **Multi-level analysis** - technical, statistical, graphical, candlestick, time series
|
|
9
|
+
- **ML readiness** - structure for machine learning (stubs)
|
|
10
|
+
- **Visualization tools** - charts and reports
|
|
11
|
+
- **Research environment** - notebooks and experiments
|
|
12
|
+
- **Automated pipelines** - ready-to-use analysis scripts
|
|
13
|
+
|
|
14
|
+
## 🚀 Quick Start
|
|
15
|
+
|
|
16
|
+
### Installation
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
# Install in development mode
|
|
20
|
+
pip install -e .
|
|
21
|
+
|
|
22
|
+
# Install with optional dependencies
|
|
23
|
+
pip install -e .[dev,notebooks]
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Basic Usage
|
|
27
|
+
|
|
28
|
+
```python
|
|
29
|
+
from bquant.data import load_symbol_data
|
|
30
|
+
from bquant.indicators import MACDAnalyzer
|
|
31
|
+
|
|
32
|
+
# Load data
|
|
33
|
+
data = load_symbol_data('XAUUSD', '1h')
|
|
34
|
+
|
|
35
|
+
# Analyze MACD zones
|
|
36
|
+
analyzer = MACDAnalyzer(data, fast=8, slow=21)
|
|
37
|
+
zones = analyzer.identify_zones()
|
|
38
|
+
|
|
39
|
+
print(f"Found {len(zones)} zones")
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Command Line
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
# Analyze single instrument
|
|
46
|
+
bquant-analyze XAUUSD
|
|
47
|
+
|
|
48
|
+
# Batch analysis
|
|
49
|
+
bquant-batch EURUSD GBPUSD XAUUSD
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## 📋 Project Structure
|
|
53
|
+
|
|
54
|
+
This is a monorepo that contains:
|
|
55
|
+
|
|
56
|
+
- **`bquant/`** - Python package (for PyPI)
|
|
57
|
+
- **`research/`** - Jupyter notebooks and experiments
|
|
58
|
+
- **`scripts/`** - Automation scripts
|
|
59
|
+
- **`data/`** - Data storage
|
|
60
|
+
- **`tests/`** - Test suite
|
|
61
|
+
- **`docs/`** - Documentation
|
|
62
|
+
|
|
63
|
+
## 🛠️ Development
|
|
64
|
+
|
|
65
|
+
### Setting up development environment
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# Create virtual environment
|
|
69
|
+
python -m venv venv_bquant_dell
|
|
70
|
+
|
|
71
|
+
# Activate (Windows)
|
|
72
|
+
venv_bquant_dell\Scripts\activate
|
|
73
|
+
|
|
74
|
+
# Activate (Linux/Mac)
|
|
75
|
+
source venv_bquant_dell/bin/activate
|
|
76
|
+
|
|
77
|
+
# Install dependencies
|
|
78
|
+
pip install -r requirements.txt
|
|
79
|
+
|
|
80
|
+
# Install in development mode
|
|
81
|
+
pip install -e .[dev]
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Running tests
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
pytest tests/ -v
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## 📚 Documentation
|
|
91
|
+
|
|
92
|
+
- [API Documentation](docs/api/)
|
|
93
|
+
- [Tutorials](docs/tutorials/)
|
|
94
|
+
- [Examples](docs/examples/)
|
|
95
|
+
|
|
96
|
+
## 🎯 Roadmap
|
|
97
|
+
|
|
98
|
+
- **Phase 1**: Core functionality (data, MACD analysis, statistics)
|
|
99
|
+
- **Phase 2**: Extended visualization, time series, other indicators
|
|
100
|
+
- **Phase 3**: Full ML, chart patterns, automation
|
|
101
|
+
|
|
102
|
+
## 📄 License
|
|
103
|
+
|
|
104
|
+
MIT License - see [LICENSE](LICENSE) file for details.
|
|
105
|
+
|
|
106
|
+
## 🤝 Contributing
|
|
107
|
+
|
|
108
|
+
Contributions are welcome! Please read our contributing guidelines and submit pull requests.
|
|
109
|
+
|
|
110
|
+
## 📞 Contact
|
|
111
|
+
|
|
112
|
+
- **Author**: kogriv
|
|
113
|
+
- **Email**: kogriv@gmail.com
|
|
114
|
+
- **Repository**: https://github.com/kogriv/bquant
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"""
|
|
2
|
+
BQuant - Quantitative Research Toolkit for Financial Markets
|
|
3
|
+
|
|
4
|
+
A comprehensive toolkit for quantitative analysis of financial data,
|
|
5
|
+
starting with MACD analysis and expandable to all aspects of market research.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
__version__ = "0.0.0"
|
|
9
|
+
__author__ = "kogriv"
|
|
10
|
+
__email__ = "kogriv@gmail.com"
|
|
11
|
+
|
|
12
|
+
# Core exports
|
|
13
|
+
from bquant.core.config import (
|
|
14
|
+
get_data_path,
|
|
15
|
+
get_indicator_params,
|
|
16
|
+
validate_timeframe,
|
|
17
|
+
PROJECT_ROOT,
|
|
18
|
+
DATA_DIR
|
|
19
|
+
)
|
|
20
|
+
|
|
21
|
+
# Version info
|
|
22
|
+
__all__ = [
|
|
23
|
+
"__version__",
|
|
24
|
+
"__author__",
|
|
25
|
+
"__email__",
|
|
26
|
+
"get_data_path",
|
|
27
|
+
"get_indicator_params",
|
|
28
|
+
"validate_timeframe",
|
|
29
|
+
"PROJECT_ROOT",
|
|
30
|
+
"DATA_DIR"
|
|
31
|
+
]
|