139 lines
27 KiB
Plaintext
139 lines
27 KiB
Plaintext
|
rust
|
|||
|
|
¥i #rustc 1.96.0 (ac68faa20 2026-05-25)ÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á íàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–�òÖÀH•‘P IÓHã#£ -055f30b747f859b6Á rustc_std_workspace_coreÁCçß^ò½èÝ$Çÿ+Cé -c4878ee60b2242c9Á ŸÃï+Ñ]ŠqB<ÏïW# -8dd1dd90e70d0b6aÁ miniz_oxideÁ€š»J(P>àö÷g\K -1eb618da2918ab7fÁ adler2ÁÆ;+Þ®5¥ÌýÝ°¦ÛLˆ -f7919172d268e069Á hashbrownÁPäV9ÒÆèÜ�"ÊÖVŽ\ -0fc2184a5da6723aÁ rustc_std_workspace_allocÁs&ØòØy¯s•bæ!‰ýŠ -97e4bf30be240674Á
|
|||
|
|
std_detectÁhŠBîÙºÌI®Ë�Å�š -9dbbf8346ba7ac8bÁ rustc_demangleÁûë9´Ç×@Œ�’ùXFº -f33013f239bf9f14Á cfg_ifÁÜLh�ž§Œaã¯>� -0a71c8f33a838301Á addr2lineÁ׎Þ!]8V$É@@T· -e618e6be60e87ba2Á gimliÁ¸
|
|||
|
|
°µ~Î1‹Ñt ðÁ€w -1f7768a68858f670Á objectÁ
|
|||
|
|
áPÃ?À¶¼QHJ¥� -914cd6a4dbe590d1Á memchrÁ›º«8Ór2Ù $¨ûib‚ -cf21ca6f2bb15dcdÁë
|
|||
|
|
‹ás «LÖ€îâƒ×ɯŒ -ee6f3747e38367f0Á DeserializeÁ\* » use_serdeÁ¬ SerializeÁL7 »Û Å\~»Û¬ZíL‹»Û testsÁ,¸-‚ $-.Å\*»Û¬.íL7»Û.±,‚6‚ $÷5 À configÁ DEFAULT_MAX_BINSÁ
|
|||
|
|
DEFAULT_ALPHAÁ DEFAULT_MIN_VALUEÁ log_gammaÁ æ defaultsÁ keyÁ » ó pow_gammaÁ min_possibleÁ > ddsketchÁ Í ¥ × sourceÁ !> #æ #• # quantileÁ # minÁ # maxÁ # sumÁ #ü # lengthÁ # mergeÁ # emptyÁ È .
|
|||
|
|
CHUNK_SIZEÁ . div_ceilÁ . 1æ 1û 1 is_emptyÁ 1• 1 get_indexÁ 1 extend_rangeÁ 1 get_new_lengthÁ 1 adjustÁ 1
|
|||
|
|
shift_binsÁ 1 center_binsÁ 1 key_at_rankÁ 1ü 1ˆ 1æ ConfigÁ @ max_num_binsÁ @ gammaÁ @ gamma_lnÁ @ min_valueÁ @ž
|
|||
|
|
Hƒ J× M�
|
|||
|
|
DDSketchErrorÁ O QuantileÁ P
|
|||
|
|
O MergeÁ R
|
|||
|
|
T× Vƒ DDSketchÁ X£ XÈ X negative_storeÁ XÖ Xà Xê X
|
|||
|
|
zero_countÁ `ƒ . StoreÁ b binsÁ bü b min_keyÁ b max_keyÁ bž
|
|||
|
|
b bin_limitÁ b is_collapsedÁ .jƒ .l×
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
%
|
|||
|
|
&
|
|||
|
|
'
|
|||
|
|
(
|
|||
|
|
)
|
|||
|
|
*
|
|||
|
|
+
|
|||
|
|
,
|
|||
|
|
,
|
|||
|
|
-
|
|||
|
|
3
|
|||
|
|
4
|
|||
|
|
5
|
|||
|
|
6
|
|||
|
|
7
|
|||
|
|
8
|
|||
|
|
9
|
|||
|
|
:
|
|||
|
|
;
|
|||
|
|
<
|
|||
|
|
=
|
|||
|
|
>
|
|||
|
|
>
|
|||
|
|
?
|
|||
|
|
?
|
|||
|
|
I
|
|||
|
|
K
|
|||
|
|
K
|
|||
|
|
K
|
|||
|
|
N
|
|||
|
|
N
|
|||
|
|
U
|
|||
|
|
U
|
|||
|
|
U
|
|||
|
|
W
|
|||
|
|
a
|
|||
|
|
k
|
|||
|
|
m
|
|||
|
|
m
|
|||
|
|
m
|
|||
|
|
Š @ @ þ
|
|||
|
|
A‹ Bž Cª D¹ Ež
|
|||
|
|
À·D¦Ó | Ûì Øì ¿cì Ðìì µßìì ³ ì ¿c O P Q‘ R S¤ u(ŽäREFÖ Ø€ Äc€ ¾ € Ø X X Ê Y£ ZÈ [ç \Ö ]à ^ê _‘ b’�öÌ5“L ³ Ö Ø b b c¹ . dü . eË . fÙ . gž
|
|||
|
|
. hî . iþ . í Ì„·,î� ¿cÍ F @G @H @V O` Xj bJ @T Ol bL @M @ @! X O OŠ KÛØ¿cÐìµß³ Äc
|
|||
|
|
¾ 2048Á {®Gáz„? 0.01Á •Ö&è .>× 1.0e-9Á € 128Á.À þ
|
|||
|
|
4¿ @ ÊDà X ýlê O ü Ÿ ü § ¢
|
|||
|
|
This crate provides a direct port of the [Golang](https://github.com/DataDog/sketches-go)
|
|||
|
|
[DDSketch](https://arxiv.org/pdf/1908.10693.pdf) implementation to Rust. All efforts
|
|||
|
|
have been made to keep this as close to the original implementation as possible, with a few tweaks to
|
|||
|
|
get closer to idiomatic Rust.
|
|||
|
|
|
|||
|
|
# Usage
|
|||
|
|
|
|||
|
|
Add multiple samples to a DDSketch and invoke the `quantile` method to pull any quantile from
|
|||
|
|
*0.0* to *1.0*.
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use sketches_ddsketch::{Config, DDSketch};
|
|||
|
|
|
|||
|
|
let c = Config::defaults();
|
|||
|
|
let mut d = DDSketch::new(c);
|
|||
|
|
|
|||
|
|
d.add(1.0);
|
|||
|
|
d.add(1.0);
|
|||
|
|
d.add(1.0);
|
|||
|
|
|
|||
|
|
let q = d.quantile(0.50).unwrap();
|
|||
|
|
|
|||
|
|
assert!(q < Some(1.01));
|
|||
|
|
assert!(q > Some(0.99));
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Sketches can also be merged.
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use sketches_ddsketch::{Config, DDSketch};
|
|||
|
|
|
|||
|
|
let c = Config::defaults();
|
|||
|
|
let mut d1 = DDSketch::new(c);
|
|||
|
|
let mut d2 = DDSketch::new(c);
|
|||
|
|
|
|||
|
|
d1.add(1.0);
|
|||
|
|
d2.add(2.0);
|
|||
|
|
d2.add(2.0);
|
|||
|
|
|
|||
|
|
d1.merge(&d2);
|
|||
|
|
|
|||
|
|
assert_eq!(d1.count(), 3);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Á .Àû þ
|
|||
|
|
ü @ Êû X ýú O 69<¤±3tÏ*- #Tû 4ÿ
|
|||
|
|
@ÜD „J ÀÄh ln ×ä‰ Œ� ×üÚ. LÝ ×××
|
|||
|
|
»,ç ªDó \¨ ì
|
|||
|
|
üÞA üºY V Construct a new `Config` struct with specific parameters. If you are unsure of how toÁ ü˜W T configure this, the `defaults` method constructs a `Config` with built-in defaults.Á ô ú üü] Z `max_num_bins` is the max number of bins the DDSketch will grow to, in steps of 128 bins.Á å ×À×ì
|
|||
|
|
|
|||
|
|
alphaÁ,é ‹dõ ¹Lˆ Ì¢
|
|||
|
|
üè 5 2 Return a `Config` using built-in default settingsÁD©
|
|||
|
|
ì
|
|||
|
|
ü� – n nì ׃ š
|
|||
|
|
$› Á ¡ üå $ ,ì o oì ƒ× ò
|
|||
|
|
$ó �
|
|||
|
|
ù üÐ * L× p pì ×× á
|
|||
|
|
$â »,è ü°
|
|||
|
|
( L·
|
|||
|
|
q qì ƒ× Á
|
|||
|
|
|
|||
|
|
$Â
|
|||
|
|
�
|
|||
|
|
È
|
|||
|
|
ü“! dš r rì × §
|
|||
|
|
$¨ ¼× ì ´ ¤õ <ø ì
|
|||
|
|
d‡ D‹ XO errorÁ, ’ × ¤, þ
|
|||
|
|
42 @ ,L b TFD9¬#,œ> t˜4� ¥ Íì ¥ ¤Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¨,€WY ü”# € Åc ü¾4 Á s t u s€ t c c ˆ ¢cµ
|
|||
|
|
` £c bufÁ ` àB¤GS
|