|Note: This tutorial assumes that you have completed the previous tutorials: Using Eigen.|
|Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.|
Eigen ExtensionsDescription: Some extensions the ecl has made in and around eigen.
Keywords: ecl eigen
Tutorial Level: INTERMEDIATE
The eigen matrixbase class provides a way to extend its api via a macro-based plugin. The trick is enabled by the following code in eigen's MatrixBase class:
Here we take advantage of it to add the following api:
- conservativeResize(int rows, int cols) : matrix resizing, carrying over existing elements
- conservativeResize(int rows) : vector resizing, carrying over existing elements
This will be brought in if you do one of the following before you include any eigen headers:
Note that if you wish to customise the eigen plugin differently, simply define the macro, pointing it at your own customisation before including ecl/linear_algebra.hpp. The ecl plugin makes a check and won't override any existing definitions.
Formatters have been included in the plugin for float and double type matrices (may expand to integral types later if we need them). This is achieved by use of the ecl_formatters framework.
There are several ways you can call these formatters, the most convenient methods are outlined below:
1 #include <linear_algebra.hpp> 2 Matrix2d m; m << 1.0, 2.0, 3.0, 4.0; 3 Matrix2d::Formatter formatter(3,6); // prec 3, width 6 4 formatter.precision(2); formatter.width(5); 5 std::cout << formatter(m) << std::cout; // format using the stored settings 6 std::cout << formatter(m,3,6) << std::cout; // format using one-shot settings 7
1 #include <ecl/formatters.hpp> 2 #include <ecl/linear_algebra.hpp> 3 Matrix2d m; m << 1.0, 2.0, 3.0, 4.0; 4 Format<Matrix2d> format(3,6); // prec 3, width 6 5 format.precision(2); format.width(5); 6 std::cout << format(m) << std::cout; // format using the stored settings 7 std::cout << format(m,3,6) << std::cout; // format using one-shot settings 8