Links

Prerequisites

Introduction to Cxx_matrix

The tutorial is based on the C++ project Cxx_matrix.
Its source code on GitHub contains 2 source files:
  • matrix.h that is a matrix operations library coded in C++
  • matrix.cpp that is a simple test over this library
Let's familiarize ourselves with the main function in matrix.cpp:
int
main(void) {
Matrix<2U, 2U> matrix_a {
2., 1.,
4., 2. };
auto id = identity<2>();
bool has_inverse = is_invertible(id);
std::cout << "identity is inversible: " << (has_inverse ? "yes\n" : "no\n");
Matrix<2U, 2U> matrix_b = matrix_a + (5 ^ id);
Matrix<2, 1> res = solve(matrix_b, { 6., 10. });
std::cout << "RESULT IS:\n" << res;
return 0;
(void) has_inverse;
}
The test implemented in main performs the following step:
  • It initializes a 2 x 2 matrix
  • It verifies if the matrix is invertible
  • It performs some basic operations on this matrix
  • It solves a matrix equation

Launching the analyzer

We already configured the project Cxx_matrix for TrustInSoft CI by adding a .trustinsoft/config.json file to the repository. In our example, the Analyses configuration specifies the source file matrix.cpp to analyze, the analysis entry point function main and the preprocessor option -I..
We also launched the analysis in TrustInSoft CI:
1. Load the following URL in your browser to visualize a summary of the analysis results: https://ci.trust-in-soft.com/projects/TrustInSoft-CI/Cxx_matrix/latest
There is only one analysis, as one entry point, and no undefined behavior on the tested path:
2. Launch TrustInSoft CI Analyzer by clicking the #1 analysis and then on the Inspect with TrustInSoft CI Analyzer button.
Next let's dive into C++ identifiers, constructions and calling conventions in TrustInSoft CI Analyzer.