Repository navigation
[Feature] After jitter is set for the scatter points, the scatter points are displayed with fixed coordinates. #21753
Description
Activity
This makes sense. To achieve deterministic jitter layout when data remains unchanged, we could introduce a way to configure a custom random number generator or a random seed.
How about adding options like
jitterRng(orjitterRandom) to the configuration?Here is a quick conceptual example using a seeded random generator (like
seedrandom):The usage is like this,
<script src="https://cdnjs.cloudflare.com/ajax/libs/seedrandom/3.0.5/seedrandom.min.js"></script> <script> const option = { // ... xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'], jitter: (width / 7) * 0.8, // Accept a custom RNG function jitterRng: new Math.seedrandom('jitter'), }, // ... } </script>
WDYT? @100pah @Ovilia @wydsjyoung
The proposed changes for this feature are available at 02eddda .
@plainheart Thanks for the design.
I understandjitterRngaccepts a custom RNG function returning [0,1), matching the signature of Math.random().
Two possible approaches:- Use seedrandom library as shown in the example.
- Implement a simple LCG RNG without external dependencies.
The design looks flexible, and I have no objection to it.
One concern: this may add extra work for ordinary users. Anyone wanting stable jitter positions would need to add an external library or write their own RNG.
Could we add a shorthandjitterSeedoption?
IfjitterSeedis set, ECharts uses its built-in seeded RNG automatically for most users, while keepingjitterRngas the advanced custom override.This is just a suggestion.
Looking forward to this feature.Reacted by Zhongxiang Wang and JB DesbasHi, @wydsjyoung, thanks for your suggestion. I agree that adding a built-in seeded RNG is easier to use for most users. I just opened PR #21765 with the proposed implementation. Feel free to review and leave your comments!
What problem does this feature solve?
The current scenario involves the same set of scatter data. Each time the setOption method is executed, the distribution position of the scatter points in the chart changes. It is hoped that a configuration can be provided to ensure that the coordinate positions of the scatter points do not change when the data remains unchanged.
What does the proposed API look like?
The configuration mode is the same as that of jitter.