fmu-runner 0.2.0

A high level Rust wrapper for executing FMU's that follow the FMI 2.0 standard.
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

# Rust FMU Runner library

[![Crates.io](https://img.shields.io/crates/v/fmu-runner.svg?maxAge=2592000)](https://crates.io/crates/fmu-runner)
[![Documentation](https://docs.rs/fmu-runner/badge.svg)](https://docs.rs/fmu-runner)
![Crates.io](https://img.shields.io/crates/l/fmu-runner.svg?maxAge=2592000)


<!-- cargo-rdme start -->

A high level Rust wrapper for executing FMU's that follow the FMI 2.0 standard.

This library contains bindings to the [fmi-standard](https://fmi-standard.org/)
and offers a high-level, safe API for unpacking, parsing, loading and executing FMU's.

## Example

```rust
use std::{collections::HashMap, path::Path};
use fmu_runner::{Fmu, FmuInstance, fmi2Type};

let fmu = Fmu::unpack(Path::new("./tests/fmu/bouncing_ball.fmu"))?;
let signals = fmu.model_description.map_signals();

let fmu_cs = FmuInstance::load(&fmu, fmi2Type::fmi2CoSimulation, true)?;

fmu_cs.setup_experiment(0.0, None, None)?;

// Set initial height to 10m.
fmu_cs.set_reals(&HashMap::from([(signals["h_start"], 10.0)]))?;

// Initialize model.
fmu_cs.enter_initialization_mode()?;
fmu_cs.exit_initialization_mode()?;

// Step model 1 second.
fmu_cs.do_step(0.0, 1.0, true)?;

// Get the current height.
let outputs = fmu_cs.get_reals(&[signals["h_m"]])?;
println!("{}", fmu_runner::outputs_to_string(&outputs));
```

<!-- cargo-rdme end -->