sci-form 0.15.1

High-performance 3D molecular conformer generation using ETKDG distance geometry
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
114
115
116
117
118
119
120
121
122
123
124
125
126

//! EEQ Energy and Gradients — Core
//!
//! Electrostatic energy from EEQ charges and numerical gradients.

use super::charges::{compute_eeq_charges, erf_approx, get_eeq_params, EeqConfig};
use serde::{Deserialize, Serialize};

/// Result of EEQ energy calculation.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct EeqEnergyResult {
    /// Total electrostatic energy (kcal/mol).
    pub electrostatic_energy: f64,
    /// Per-atom charges.
    pub charges: Vec<f64>,
    /// Coordination numbers.
    pub coordination_numbers: Vec<f64>,
}

/// Compute EEQ electrostatic energy.
///
/// E_elec = Σ_i χ_i q_i + 0.5 Σ_{i,j} q_i γ(r_ij) q_j
pub fn compute_eeq_energy(
    elements: &[u8],
    positions: &[[f64; 3]],
    config: &EeqConfig,
) -> EeqEnergyResult {
    let charge_result = compute_eeq_charges(elements, positions, config);
    let q = &charge_result.charges;
    let n = elements.len();

    let mut e_elec = 0.0;

    for i in 0..n {
        let p = get_eeq_params(elements[i]);
        e_elec += p.chi * q[i];
    }

    for i in 0..n {
        let pi = get_eeq_params(elements[i]);
        for j in (i + 1)..n {
            let pj = get_eeq_params(elements[j]);
            let dx = positions[i][0] - positions[j][0];
            let dy = positions[i][1] - positions[j][1];
            let dz = positions[i][2] - positions[j][2];
            let r_ij = (dx * dx + dy * dy + dz * dz).sqrt();

            if r_ij < 1e-10 {
                continue;
            }

            let sigma_ij = (pi.r_eeq * pi.r_eeq + pj.r_eeq * pj.r_eeq).sqrt();
            let arg = std::f64::consts::SQRT_2 / sigma_ij * r_ij;
            let gij = erf_approx(arg) / r_ij;

            e_elec += q[i] * gij * q[j];
        }
    }

    let ev_to_kcal = 23.06;
    e_elec *= ev_to_kcal;

    EeqEnergyResult {
        electrostatic_energy: e_elec,
        charges: charge_result.charges,
        coordination_numbers: charge_result.coordination_numbers,
    }
}

/// Compute numerical gradient of EEQ energy.
pub fn compute_eeq_gradient(
    elements: &[u8],
    positions: &[[f64; 3]],
    config: &EeqConfig,
) -> Vec<[f64; 3]> {
    let n = elements.len();
    let h = 1e-4;
    let mut gradient = vec![[0.0; 3]; n];

    for i in 0..n {
        for d in 0..3 {
            let mut pos_p = positions.to_vec();
            let mut pos_m = positions.to_vec();
            pos_p[i][d] += h;
            pos_m[i][d] -= h;

            let ep = compute_eeq_energy(elements, &pos_p, config).electrostatic_energy;
            let em = compute_eeq_energy(elements, &pos_m, config).electrostatic_energy;

            gradient[i][d] = (ep - em) / (2.0 * h);
        }
    }

    gradient
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_eeq_energy_finite() {
        let elements = [8, 1, 1];
        let pos = [[0.0, 0.0, 0.0], [0.757, 0.586, 0.0], [-0.757, 0.586, 0.0]];
        let config = EeqConfig::default();
        let result = compute_eeq_energy(&elements, &pos, &config);
        assert!(result.electrostatic_energy.is_finite());
    }

    #[test]
    fn test_eeq_gradient_finite() {
        let elements = [6, 8, 1, 1];
        let pos = [
            [0.0, 0.0, 0.0],
            [1.23, 0.0, 0.0],
            [-0.6, 0.9, 0.0],
            [-0.6, -0.9, 0.0],
        ];
        let config = EeqConfig::default();
        let grad = compute_eeq_gradient(&elements, &pos, &config);
        for g in &grad {
            for &d in g {
                assert!(d.is_finite(), "Gradient contains NaN/Inf");
            }
        }
    }
}