cudf 0.3.1

Safe Rust bindings for NVIDIA libcudf -- GPU-accelerated DataFrame operations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! # cudf -- GPU-Accelerated DataFrames for Rust
//!
//! `cudf` provides safe Rust bindings for NVIDIA's [libcudf](https://github.com/rapidsai/cudf),
//! enabling GPU-accelerated DataFrame operations. The public API is fully safe, with the
//! sole exception of `DLPackTensor::from_raw_ptr` which requires an unsafe block.
//!
//! ## Quick Start
//!
//! ```rust,no_run
//! use cudf::{Column, Table, Result};
//!
//! fn main() -> Result<()> {
//!     // Create a GPU column from host data
//!     let prices = Column::from_slice(&[100.0f64, 200.5, 300.75, 150.25])?;
//!     let quantities = Column::from_slice(&[10i32, 20, 30, 15])?;
//!
//!     // Inspect
//!     assert_eq!(prices.len(), 4);
//!     assert!(!prices.has_nulls());
//!
//!     // Read back to host
//!     let host_prices: Vec<f64> = prices.to_vec()?;
//!     assert_eq!(host_prices, vec![100.0, 200.5, 300.75, 150.25]);
//!
//!     Ok(())
//! }
//! ```
//!
//! ## Architecture
//!
//! This crate is the **safe public API** layer in a 3-crate stack:
//!
//! ```text
//! +---------------------------------------------+
//! |  cudf (this crate) -- safe Rust API          |
//! +---------------------------------------------+
//! |  cudf-cxx -- cxx bridge + C++ shim layer    |
//! +---------------------------------------------+
//! |  cudf-sys -- links libcudf.so               |
//! +---------------------------------------------+
//! ```
//!
//! ## Feature Flags
//!
//! | Feature | Default | Description |
//! |---------|---------|-------------|
//! | `arrow-interop` | Yes | Zero-copy conversion to/from `arrow` arrays |

#[cfg(not(target_pointer_width = "64"))]
compile_error!("cudf-rs requires a 64-bit target (CUDA is 64-bit only)");

pub mod aggregation;
pub mod binaryop;
pub mod column;
pub mod concatenate;
pub mod copying;
pub mod datetime;
pub mod dictionary;
pub mod error;
pub mod filling;
pub mod groupby;
pub mod hashing;
pub mod interop;
pub mod io;
pub mod join;
pub mod json;
pub mod label_bins;
pub mod lists;
pub mod merge;
pub mod null_mask;
pub mod partitioning;
pub mod quantiles;
pub mod reduction;
pub mod replace;
pub mod reshape;
pub mod rolling;
pub mod round;
pub mod scalar;
pub mod search;
pub mod sorting;
pub mod stream_compaction;
pub mod strings;
pub mod structs;
pub mod table;
pub mod timezone;
pub mod transform;
pub mod transpose;
pub mod types;
pub mod unary;

// Re-exports for convenience
pub use aggregation::AggregationKind;
pub use binaryop::BinaryOp;
pub use column::{Column, CudfType};
pub use copying::OutOfBoundsPolicy;
pub use error::{CudfError, Result};
pub use groupby::{GroupBy, GroupByGroups, GroupByReplacePolicy, GroupByScan, GroupByScanOp};
pub use join::{HashJoin, JoinResult, SemiJoinResult};
pub use json::JsonObjectOptions;
pub use partitioning::PartitionResult;
pub use quantiles::Interpolation;
pub use reduction::{MinMaxResult, ReduceOp, ScanOp};
pub use replace::NullReplacePolicy;
pub use rolling::RollingAgg;
pub use scalar::Scalar;
pub use sorting::{NullOrder, SortOrder};
pub use stream_compaction::{DuplicateKeepOption, NullEquality};
pub use table::{Table, TableWithMetadata};
pub use types::{DataType, NullHandling, TypeId};
pub use unary::UnaryOp;

// Interop re-exports
pub use interop::{DLPackTensor, PackedTable, SplitResult};