caexfer 0.2.0

Transfer finite-element meshes, voxel occupancy, and results across CAE formats
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

//! Convert through the public file API, then present the approved receipt.

use std::io::Write;

use caexfer::{ConversionReport, Error, Omission, Result, convert};

use super::approval;
use super::args::Args;
use super::common::{conversion_options, emit, path_json};
use super::json::{array, object, quote};
use super::output::{self, PendingOutput};

/// Convert into private paths so the CLI can confirm losses before install.
pub(super) fn run_convert(args: &Args) -> Result<u8> {
    if args.mesh_out.as_deref() == Some(args.paths[1].as_path()) {
        return Err(Error::new("E_USAGE", "paired outputs need distinct paths"));
    }
    let mut primary = PendingOutput::new(&args.paths[1], &args.paths[0], args.overwrite)?;
    let mut companion = args
        .mesh_out
        .as_deref()
        .map(|path| PendingOutput::new(path, &args.paths[0], args.overwrite))
        .transpose()?;
    let mut options = conversion_options(args)?;
    // The library may write every proposed projection into private paths.
    // Only the CLI approval step can install those bytes at requested names.
    options.accept_all = true;
    options.mesh_output = companion
        .as_ref()
        .map(|pending| pending.temporary().to_path_buf());
    let mut report = convert(&args.paths[0], primary.temporary(), &options)?;
    if companion.is_some() && report.mesh_output.is_none() {
        return Err(Error::new(
            "E_OUTPUT",
            "conversion produced no companion report",
        ));
    }
    approval::confirm(
        args,
        &report,
        report
            .mesh_output
            .as_ref()
            .map(|item| item.omissions.as_slice()),
    )?;
    if let Some(companion) = &mut companion {
        output::install_pair(&mut primary, companion)?;
        if let Some(receipt) = &mut report.mesh_output {
            receipt.path.clone_from(
                args.mesh_out
                    .as_ref()
                    .ok_or_else(|| Error::new("E_OUTPUT", "missing companion path"))?,
            );
        }
    } else {
        primary.install()?;
    }
    present(args, &report)?;
    Ok(0)
}

/// Render the installed conversion receipt in the selected CLI format.
fn present(args: &Args, report: &ConversionReport) -> Result<()> {
    if args.json {
        let mut fields = vec![
            ("schema_version", "1".into()),
            ("operation", quote("mesh-and-fields-projection")),
            ("output", path_json(&args.paths[1])),
            ("points", report.points.to_string()),
            ("cells", report.cells.to_string()),
            ("fields", report.fields.to_string()),
            ("units", quote("unspecified")),
            ("omissions", omissions_json(&report.omissions)),
        ];
        if let Some((dimensions, occupied)) = report.voxel_grid {
            fields.push((
                "voxel_grid",
                object([
                    (
                        "dimensions",
                        array(dimensions.into_iter().map(|v| v.to_string())),
                    ),
                    ("occupied_cells", occupied.to_string()),
                ]),
            ));
        }
        if let Some(companion) = &report.mesh_output {
            fields.push((
                "mesh_output",
                object([
                    ("path", path_json(&companion.path)),
                    ("format", quote(companion.format.name())),
                    ("omissions", omissions_json(&companion.omissions)),
                ]),
            ));
        }
        emit(&object(fields))?;
    } else {
        if report.voxel_grid.is_some() {
            emit(&format!(
                "Wrote {} from {} source points, {} source cells, {} source field(s). Units unspecified.",
                args.paths[1].display(),
                report.points,
                report.cells,
                report.fields
            ))?;
        } else {
            emit(&format!(
                "Wrote {}: {} points, {} cells, {} source field(s). Units unspecified.",
                args.paths[1].display(),
                report.points,
                report.cells,
                report.fields
            ))?;
        }
        if let Some(([nx, ny, nz], occupied)) = report.voxel_grid {
            emit(&format!(
                "Voxel grid: {nx} × {ny} × {nz} cells, {occupied} occupied."
            ))?;
        }
        let mut stderr = std::io::stderr().lock();
        for omission in &report.omissions {
            writeln!(stderr, "Omission: {}", omission.detail)?;
        }
        if let Some(companion) = &report.mesh_output {
            emit(&format!(
                "Wrote companion mesh {}.",
                companion.path.display()
            ))?;
            for omission in &companion.omissions {
                writeln!(stderr, "Companion omission: {}", omission.detail)?;
            }
        }
    }
    Ok(())
}

/// Encode omission stages and details for the versioned CLI JSON schema.
pub(super) fn omissions_json(omissions: &[Omission]) -> String {
    array(omissions.iter().map(|omission| {
        object([
            ("stage", quote(omission.stage.name())),
            ("acceptance_flag", quote(approval::flag_for(omission))),
            ("detail", quote(&omission.detail)),
        ])
    }))
}