deep_causality_discovery 0.1.0

Causality discovery DSL for the DeepCausality project.
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

/*
 * SPDX-License-Identifier: MIT
 * Copyright (c) "2025" . The DeepCausality Authors and Contributors. All Rights Reserved.
 */

use crate::{DataError, DataLoaderConfig};
use deep_causality_tensor::CausalTensor;

/// Defines the contract for loading data from a source into a `CausalTensor`.
///
/// Implementors of this trait handle the specifics of reading different file formats
/// (e.g., CSV, Parquet) and converting the tabular data into the tensor representation
/// required by the CDL pipeline.
pub trait ProcessDataLoader {
    /// Loads data from the specified path.
    ///
    /// # Arguments
    ///
    /// * `path` - A string slice representing the path to the data file.
    /// * `config` - A `DataLoaderConfig` enum containing format-specific settings,
    ///   such as whether a CSV has headers or the batch size for a Parquet file.
    ///
    /// # Returns
    ///
    /// A `Result` containing a `CausalTensor<f64>` with the loaded data on success.
    /// The tensor is expected to be 2-dimensional (rows, columns).
    ///
    /// # Errors
    ///
    /// Returns a `DataError` if loading fails, which can be due to the file not
    /// being found, permission issues, or parsing errors.
    fn load(&self, path: &str, config: &DataLoaderConfig) -> Result<CausalTensor<f64>, DataError>;
}