The crate is a Rust API for the GMT second order finite element model (FEM).
The FEM is loaded from a zip file which name must be modal_state_space_model_2ndOrder.zip and the location of the zip file is given by the environment variable FEM_REPO.
The FEM inputs and outputs are dynamically created during compilation from importing input and output tables contained within the zip archive.
This means that each time an application needs a new model, the gmt-fem crate need to be recompiled using the modal_state_space_model_2ndOrder.zip archive corresponding to the new model.
To force a re-compilation of the gmt-crate, the gmt-crate library need to be deleted from Rust Cargo cache like this:
cargo clean --release -p gmt-fem
A summary of the properties of a GMT FEM can be obtained by running the Cargo subcommand
cargo gmt-fem
The subcommand is installed with
cargo install -f --features clap gmt-fem
Run
cargo gmt-fem --help
to see the arguments to apply a custom model reduction.
For the reasons explained above, the subcommand need to be re-installed each time it is applied to a new model.
The zip archive modal_state_space_model_2ndOrder.zip is generated with the Matlab script unwrapFEM.m available in the tools directory.
The script uses the Matlab files modal_state_space_model_2ndOrder.mat and, if present, static_reduction_model.mat to build modal_state_space_model_2ndOrder.zip.