How henryz16/skd-backtest works
skd-backtest is a daily Python backtesting framework for index-enhancement research, exposed through a single-model Python API and a batch-evaluation CLI. The main workflow loads dated market and reference data, obtains model scores, constructs portfolio targets, executes orders with costs and trading limits, values the account, then evaluates predictions and emits audit results. The graph follows the engine-owned calls visible in its excerpt and documented capabilities; several component internals and engine stages were not fully sampled, so their uncertain links are omitted.
Main entry points: engine.py Backtest engine · data_provider.py Market data provider · runtime_cache.py Runtime cache · __init__.py Python API
Components 26
Entry and orchestration
- Python API
src/skd_backtest/__init__.py - CLI evaluation
src/skd_backtest/evaluate.py - Submission runner
src/skd_backtest/submission_runner.py - Backtest engine
src/skd_backtest/engine.py - Run configuration
src/skd_backtest/config.py - Async inference
src/skd_backtest/inference_pipeline.py
Market and reference data
- Market data provider
src/skd_backtest/data_provider.py - Adjusted limits
src/skd_backtest/adjusted_limits.py - Reference data
src/skd_backtest/reference_data.py
Portfolio and trading
- Portfolio optimizer
src/skd_backtest/portfolio_optimizer.py - Barra optimizer
src/skd_backtest/risk_optimizer.py - Order execution
src/skd_backtest/broker.py - Trading costs
src/skd_backtest/cost_model.py - Account valuation
src/skd_backtest/accounting.py
Evaluation and results
- Forward labels
src/skd_backtest/label_provider.py - Performance metrics
src/skd_backtest/metrics.py - Prediction evaluation
src/skd_backtest/prediction_evaluator.py - Audit output
src/skd_backtest/result_writer.py
Shared runtime protocol
- Runtime cache
src/skd_backtest/runtime_cache.py - Packet contracts
src/skd_backtest/contracts.py - Table schemas
src/skd_backtest/schemas.py
Other components
- Research user
- Evaluation platform
- Market data files
- Reference data files
- Audit artifacts
Connections 27
- Research user → Python API: uses API
README.md - Python API → Backtest engine: creates engine
src/skd_backtest/__init__.py - Evaluation platform → CLI evaluation: invokes evaluation
README.md - CLI evaluation → Backtest engine: runs backtest
src/skd_backtest/evaluate.py - Backtest engine → Run configuration: configures run
src/skd_backtest/engine.py - Backtest engine → Market data provider: prepares playback
src/skd_backtest/engine.py - Market data provider → Market data files: reads parquet
src/skd_backtest/data_provider.py - Market data provider → Adjusted limits: uses limits
src/skd_backtest/data_provider.py - Backtest engine → Reference data: prepares references
src/skd_backtest/engine.py - Reference data → Reference data files: reads datasets
src/skd_backtest/reference_data.py - Backtest engine → Async inference: buffers inference
src/skd_backtest/engine.py - Async inference → Submission runner: requests scores
src/skd_backtest/inference_pipeline.py - Backtest engine → Submission runner: requests prediction
src/skd_backtest/engine.py - Backtest engine → Portfolio optimizer: constructs targets
src/skd_backtest/engine.py - Portfolio optimizer → Barra optimizer: runs Barra
src/skd_backtest/portfolio_optimizer.py - Backtest engine → Order execution: executes trades
src/skd_backtest/engine.py - Order execution → Trading costs: requests quote
src/skd_backtest/broker.py - Backtest engine → Account valuation: values account
src/skd_backtest/engine.py - Backtest engine → Forward labels: builds labels
src/skd_backtest/engine.py - Backtest engine → Prediction evaluation: evaluates predictions
src/skd_backtest/engine.py - Backtest engine → Performance metrics: computes metrics
src/skd_backtest/engine.py - Backtest engine → Audit output: writes results
src/skd_backtest/engine.py - Audit output → Audit artifacts: writes artifacts
README.md - Backtest engine → Runtime cache: coordinates packets
src/skd_backtest/engine.py - Runtime cache → Packet contracts: enforces topics
src/skd_backtest/runtime_cache.py - Runtime cache → Table schemas: validates tables
src/skd_backtest/runtime_cache.py - Forward labels → Market data files: reads prices
src/skd_backtest/label_provider.py