Feat/candlesticks

[jonasvdd]

related: #288, #98

TODO:

• [ ] do we need to lock tsdownsample version (as we now have a hard lock-in on tsdownsample's m4 implementation)?
• [ ] maybe allow the users to configure the candlestick position? (middle of bucket, begin (as it is now), or end)
• [ ] write docs (and focus on limitations)
• [ ] create examples
• [ ] write tests (few datapoints, large zoom-in); how does it behave with different aggregators?

Minimal example:

import pandas as pd; import numpy as np
import plotly.graph_objects as go
from plotly_resampler import FigureResampler
from plotly_resampler.aggregation import M4


# 1. Create dummy data
x = np.arange(2_000_000)
x_time = pd.date_range("2020-01-01", periods=len(x), freq="1min")
noisy_sin = (3 + np.sin(x / (len(x) / 55)) + np.random.randn(len(x)) / 10) * x / 1_000

# 2. Create a figure
fig = FigureResampler(default_n_shown_samples=1000, verbose=False)
fig.add_trace(
    go.Scattergl(name="Original", mode="lines", visible="legendonly"),
    hf_x=x_time,
    hf_y=noisy_sin,
)
fig.add_trace(
    go.Candlestick(name="OHLC"),
    hf_x=x_time,
    hf_y=noisy_sin,
    downsampler=M4(parallel=True),
    max_n_samples=400,
)
fig.update_layout(title="OHLC Downsampling", showlegend=True)
fig.update_xaxes(rangeslider_visible=False)
fig

[codecov-commenter]

Codecov Report

Attention: 33 lines in your changes are missing coverage. Please review.

Comparison is base (46e629f) 96.42% compared to head (5cdb8f4) 93.75%. Report is 2 commits behind head on main.

Files	Patch %	Lines
...ler/figure_resampler/figure_resampler_interface.py	21.05%	30 Missing :warning:
plotly_resampler/aggregation/aggregators.py	50.00%	3 Missing :warning:

:exclamation: Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #289      +/-   ##
==========================================
- Coverage   96.42%   93.75%   -2.67%     
==========================================
  Files          14       14              
  Lines        1146     1185      +39     
==========================================
+ Hits         1105     1111       +6     
- Misses         41       74      +33     

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[jonasvdd]

@jvdd, I suppose we should rebase this branch on main? (so we can fix the NanM4 issue in this PR as well?