bixverse-rs 0.7.0

A Rust library with various utilities for computational biology and single cell.
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

//! Implementation of differential correlation method based on the Fisher method

use faer::Mat;
use rayon::prelude::*;

use crate::core::math::stats::z_scores_to_pval;
use crate::prelude::*;

////////////////
// Structures //
////////////////

/// Structure for DiffCor results
#[derive(Clone, Debug)]
pub struct DiffCorRes<T> {
    /// Correlation coefficients of a
    pub r_a: Vec<T>,
    /// Correlation coefficients of b
    pub r_b: Vec<T>,
    /// Z-scores of the differential correlation
    pub z_score: Vec<T>,
    /// Calculated p-values from the Z-scores
    pub p_vals: Vec<T>,
}

//////////
// Main //
//////////

/// Calculate differential correlations
///
/// The function will panic if the two correlation matrices are not symmetric
/// and do not have the same dimensions.
///
/// ### Params
///
/// * `mat_a` - The first correlation matrix.
/// * `mat_b` - The second correlation matrix.
/// * `no_sample_a` - Number of samples that were present to calculate mat_a.
/// * `no_sample_b` - Number of samples that were present to calculate mat_b.
/// * `spearman` - Was Spearman correlation used.
///
/// ### Returns
///
/// The resulting differential correlation results as a structure.
pub fn calculate_diff_correlation<T>(
    mat_a: &Mat<T>,
    mat_b: &Mat<T>,
    no_sample_a: usize,
    no_sample_b: usize,
    spearman: bool,
) -> DiffCorRes<T>
where
    T: BixverseFloat,
{
    assert_symmetric_mat!(mat_a);
    assert_symmetric_mat!(mat_b);
    // assert_same_dims!(mat_a, mat_b);

    let mut cors_a: Vec<T> = Vec::new();
    let mut cors_b: Vec<T> = Vec::new();

    let upper_triangle_indices = upper_triangle_indices(mat_a.ncols(), 1);

    for (&r, &c) in upper_triangle_indices
        .0
        .iter()
        .zip(upper_triangle_indices.1.iter())
    {
        cors_a.push(*mat_a.get(r, c));
        cors_b.push(*mat_b.get(r, c));
    }

    // Maybe save the original correlations... Note to myself.
    let original_cor_a = cors_a.to_vec();
    let original_cor_b = cors_b.to_vec();

    cors_a.par_iter_mut().for_each(|x| *x = x.atanh());
    cors_b.par_iter_mut().for_each(|x| *x = x.atanh());

    // Constant will depend on if Spearman or Pearson
    let constant = if spearman {
        T::from_f32(1.06).unwrap()
    } else {
        T::from_f32(1.0).unwrap()
    };
    let denominator: T = ((constant
        / (T::from_usize(no_sample_a).unwrap() - T::from_f32(3.0).unwrap()))
        + (constant / (T::from_usize(no_sample_b).unwrap() - T::from_f32(3.0).unwrap())))
    .sqrt();

    let z_scores: Vec<T> = cors_a
        .par_iter()
        .zip(cors_b.par_iter())
        .map(|(a, b)| (*a - *b) / denominator)
        .collect();

    let p_values = z_scores_to_pval(&z_scores, "twosided");

    DiffCorRes {
        r_a: original_cor_a,
        r_b: original_cor_b,
        z_score: z_scores,
        p_vals: p_values,
    }
}