kdtree rs

pohon kd

Pohon K-dimensi di Rust untuk pengindeksan geospasial cepat dan pencarian tetangga terdekat

• Peti
• Dokumentasi
• Penggunaan
• Tolok ukur
• Lisensi

Penggunaan

Tambahkan kdtree ke Cargo.toml

[ dependencies ]
kdtree = " 0.7.0 "

Tambahkan titik ke kdtree dan kueri n titik terdekat dengan fungsi jarak

 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 ) ]
) ; 

Tolok ukur

cargo bench dengan 2,3 GHz Intel i5-7360U:

 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

Terima kasih Eh2406 atas berbagai perbaikan dan peningkatan kinerja.

Lisensi

Berlisensi di bawah salah satu dari

• Lisensi Apache, Versi 2.0 (LICENSE-APACHE atau http://www.apache.org/licenses/LICENSE-2.0)
• Lisensi MIT (LICENSE-MIT atau http://opensource.org/licenses/MIT)

sesuai pilihan Anda.

Kontribusi

Kecuali jika Anda secara eksplisit menyatakan sebaliknya, setiap kontribusi yang dengan sengaja Anda kirimkan untuk dimasukkan ke dalam karya Anda, sebagaimana didefinisikan dalam lisensi Apache-2.0, akan memiliki lisensi ganda seperti di atas, tanpa syarat atau ketentuan tambahan apa pun.