oxigrid 0.1.2

Pure Rust Energy Systems Simulation & Optimization Library
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

//! Power system stability analysis: transient, small-signal, and voltage.
//!
//! # Modules
//! - [`transient`]    — Swing equation, RK4 time-domain simulation, SMIB fault analysis
//! - [`small_signal`] — Multi-machine state-space (A-matrix), Schur eigenvalue decomposition,
//!   inter-area and local oscillation mode identification
//! - [`voltage`]      — P-V curve, Q-V curve, voltage stability index (L-index)
//! - [`generator`]    — Classical, detailed (4th-order d-q axis), governor, and AVR models
//!
//! ## Mathematical background
//!
//! **Swing equation** (classical generator model, SMIB):
//!
//! ```text
//! M · d²δ/dt² + D · dδ/dt = Pm − Pe(δ)
//! Pe(δ) = (E'·V / X'd) · sin(δ)
//! ```
//!
//! where M = 2H/ωs (inertia constant), D = damping, Pm = mechanical power,
//! Pe(δ) = electrical power, H = inertia in MWs/MVA, ωs = synchronous speed.
//!
//! **Small-signal stability**: The system A-matrix eigenvalues λ = σ ± jω
//! determine stability. System is stable iff Re(λ) < 0 for all eigenvalues.
//! Oscillation frequency f = ω/(2π); damping ratio ζ = −σ/|λ|.
//!
//! **Voltage stability**: The P-V nose point (bifurcation) is found via
//! continuation power flow. The L-index for bus i:
//!
//! ```text
//! L_i = |1 + Σ_{j ∈ G} F_ij · V_j / V_i|
//! ```
//!
//! L_i ∈ \[0, 1\]; L_i → 1 indicates voltage collapse proximity.
pub mod agc;
pub mod fault_trajectory;
pub mod generator;
pub mod inertia_analysis;
pub mod inertia_emulation;
pub mod inertia_estimation;
pub mod load;
pub mod load_modeling;
pub use load_modeling::*;
pub mod modal;
pub mod multi_machine;
pub mod multi_machine_detail;
pub mod probabilistic_transient;
pub mod small_signal;
pub mod small_signal_enhanced;
pub mod synthetic_inertia_control;
pub mod transient;
pub mod voltage;
pub mod voltage_stability;
pub use inertia_analysis::*;
pub mod pss_design;
pub mod pss_tuning;
pub use pss_design::*;
pub mod black_start_procedure;
pub use black_start_procedure::*;
pub mod tsmi;
pub use tsmi::*;
pub mod tvsa;
pub use tvsa::*;
pub mod grid_forming_stability;
pub use grid_forming_stability::*;
pub mod inter_area;
pub use inter_area::{
    IaGenerator, InterAreaAnalyzer, InterAreaMode, PronyMode, PronyResult, RingdownResult,
    SystemArea, TieLine, WadcDesign,
};
pub mod indices;
pub use indices::{
    BranchStabilityData, BusStabilityData, BusType, StabilityAssessment, StabilityError,
    StabilityIndexCalculator, StabilityIndicesConfig, StabilityRisk, TransientStabilityIndices,
    TsMethod, VoltageStabilityIndices, VsMethod,
};