Repository navigation
v0.2: rewrite processing and rendering (fixes #4, #6; live example for #5) - #7
Merged
Merged
Conversation
The bundled examples crashed on current pandas (Series[-1] on a DatetimeIndex), and time-bar data rendered out of order because the x-axis was categorical over random identifiers whose order depended on input sort. Processing - Candles get an integer bar index; rows link by identifier_col or by timestamp (index or time column), tz-aware. Fixes #4. - Candles sorted by time with stable order for shared timestamps; the old identifier-length "sequence" hack is gone. Fixes #6. - Tick size inferred from within-candle level gaps, not the first two rows. - Diagonal imbalance computed per candle by price, zero-safe; optional horizontal mode; user imbalance column still supported. - Stats: volume, delta, true cumulative delta, delta %, POC. - Actionable OrderFlowDataError messages replace bare except clauses. - from_trades() builds footprints from a trade tape; update() for live use. - get_processed_data/from_preprocessed_data use a compact v2 format and still load v0.1 files. Rendering - Numeric x-axis with all geometry in data units: cells, candle beside the cells, horizontal volume-profile bars with POC highlight. - Initial viewport fits readable price levels; y-range no longer collapses for 0.01-tick instruments (int() truncation). - uirevision keeps pan/zoom across live refreshes. Project - pyproject.toml (pip installable), loosened requirements, .gitignore, removed committed __pycache__. - pytest suite (17 tests) and CI on py3.9/pandas 1.5/plotly 5.9 and py3.13/latest. - README rewritten in Markdown with install, data format, options, live usage, roadmap and contributing sections; examples/from_trades.py and examples/live_dash.py.
murtazayusuf
force-pushed
the
revamp-v2
branch
from
November 1, 2026 13:03
35517f8 to
32b3c73
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The bundled examples crashed on current pandas (
ohlc['high'][-1]on a DatetimeIndex), so a fresh install could not render anything. With that patched, charts were still scrambled: the x-axis was categorical over random 5-character identifiers, so candle order depended on input row order, and range-bar order relied on identifier string length as a hidden sequence number.What changed
Processing
identifier_col(range/tick/volume bars) or by timestamp (index ortimecolumn, tz-aware) for time bars. Fixes Unclear documentation - how is 'identifier' handled of not present? #4.OrderFlowDataErrormessages instead of "Data processing failed".OrderFlowChart.from_trades()(build from a trade tape),update(), andbars/footprint/statsproperties.get_processed_datauses a compact v2 format; v0.1 JSON files still load.Rendering
uirevisionkeeps pan/zoom across live refreshes (will it work on real time market #5, seeexamples/live_dash.py).Project
pyproject.toml(pip installable), loosened requirements,.gitignore, committed__pycache__removed.Compatibility notes
OrderFlowChart(orderflow_data, ohlc_data, identifier_col, imbalance_col),plot(return_figure=...),get_processed_data(),from_preprocessed_data().cum_deltais now a true running total, so values differ from v0.1.Fixes #4
Fixes #6
Generated by Claude Code