powerio-matrix 0.7.1

Sparse matrices and graph outputs for power system case files, built on powerio.
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

//! Per case metadata: matrices emitted, their stats, source file digest,
//! build options. Used by the TUI Inspect screen and as a sidecar for
//! downstream tooling.

use std::path::Path;

use serde::{Deserialize, Serialize};

use crate::Result;
use crate::matrix::{BuildOptions, MatrixStats};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CaseMetadata {
    pub case_name: String,
    pub source_file: Option<String>,
    pub source_sha256: Option<String>,
    pub base_mva: f64,
    pub n_buses: usize,
    pub n_branches: usize,
    pub build_options: BuildOptions,
    pub matrices: Vec<MatrixMetadata>,
    pub powerio_version: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MatrixMetadata {
    pub kind: String,
    pub file: String,
    pub stats: MatrixStats,
    pub sddm: bool,
}

pub fn write_meta_json(meta: &CaseMetadata, path: impl AsRef<Path>) -> Result<()> {
    let json = serde_json::to_string_pretty(meta).map_err(|e| crate::Error::Mtx(e.to_string()))?;
    std::fs::write(path, json)?;
    Ok(())
}