kdtree rs下載 - kdtree rs原始碼下載

kdtree rs

其他源碼

1.0.0

下載

kd樹

Rust 中的 K 維樹用於快速地理空間索引和最近鄰居查找

箱
文件
用法
基準
執照

用法

將kdtree加入Cargo.toml

[ dependencies ]
kdtree = " 0.7.0 "

將點加入kdtree並用距離函數查詢最近的n個點

 use kdtree :: KdTree ;
use kdtree :: ErrorKind ;
use kdtree :: distance :: squared_euclidean ;

let a : ( [ f64 ; 2 ] , usize ) = ( [ 0f64 , 0f64 ] , 0 ) ;
let b : ( [ f64 ; 2 ] , usize ) = ( [ 1f64 , 1f64 ] , 1 ) ;
let c : ( [ f64 ; 2 ] , usize ) = ( [ 2f64 , 2f64 ] , 2 ) ;
let d : ( [ f64 ; 2 ] , usize ) = ( [ 3f64 , 3f64 ] , 3 ) ;

let dimensions = 2 ;
let mut kdtree = KdTree :: new ( dimensions ) ;

kdtree . add ( & a . 0 , a . 1 ) . unwrap ( ) ;
kdtree . add ( & b . 0 , b . 1 ) . unwrap ( ) ;
kdtree . add ( & c . 0 , c . 1 ) . unwrap ( ) ;
kdtree . add ( & d . 0 , d . 1 ) . unwrap ( ) ;

assert_eq ! ( kdtree.size ( ) , 4 ) ;
assert_eq ! (
    kdtree.nearest ( &a. 0 , 0 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ]
) ;
assert_eq ! (
    kdtree.nearest ( &a. 0 , 1 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ( 0f64 , & 0 ) ]
) ;
assert_eq ! (
    kdtree.nearest ( &a. 0 , 2 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ( 0f64 , & 0 ) , ( 2f64 , & 1 ) ]
) ;
assert_eq ! (
    kdtree.nearest ( &a. 0 , 3 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ( 0f64 , & 0 ) , ( 2f64 , & 1 ) , ( 8f64 , & 2 ) ]
) ;
assert_eq ! (
    kdtree.nearest ( &a. 0 , 4 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ( 0f64 , & 0 ) , ( 2f64 , & 1 ) , ( 8f64 , & 2 ) , ( 18f64 , & 3 ) ]
) ;
assert_eq ! (
    kdtree.nearest ( &a. 0 , 5 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ( 0f64 , & 0 ) , ( 2f64 , & 1 ) , ( 8f64 , & 2 ) , ( 18f64 , & 3 ) ]
) ;
assert_eq ! (
    kdtree.nearest ( &b. 0 , 4 , &squared_euclidean ) .unwrap ( ) ,
    vec! [ ( 0f64 , & 1 ) , ( 2f64 , & 0 ) , ( 2f64 , & 2 ) , ( 8f64 , & 3 ) ]
) ;

基準

配備 2.3 GHz Intel i5-7360U 的cargo bench ：

 cargo bench
     Running target/release/deps/bench-9e622e6a4ed9b92a

running 2 tests
test bench_add_to_kdtree_with_1k_3d_points       ... bench:         106 ns/iter (+/- 25)
test bench_nearest_from_kdtree_with_1k_3d_points ... bench:       1,237 ns/iter (+/- 266)

test result: ok. 0 passed; 0 failed; 0 ignored; 2 measured; 0 filtered out

感謝 Eh2406 的各種修復和性能改進。