1. O que é e para que serve?

Armadillo é uma biblioteca de álgebra linear de alto desempenho para C++ que oferece uma interface prática e intuitiva para trabalhar com matrizes, vetores e cubos (arrays tridimensionais). Ela foi projetada para combinar a velocidade de bibliotecas de baixo nível (como LAPACK e BLAS) com a facilidade de uso típica de linguagens de alto nível, como MATLAB ou Python (NumPy).

Para que serve? Se você desenvolve aplicações relacionadas a machine learning, visão computacional, processamento de sinais, robótica, modelagem física ou qualquer área que exija cálculos matriciais intensos, o Armadillo será uma ferramenta indispensável. Ele permite escrever código limpo e legível que executa de forma extremamente rápida, graças à otimização automática e ao suporte a aceleração por hardware (via OpenBLAS, Intel MKL ou Apple Accelerate).

Ao contrário de loops manuais sobre elementos de arrays, o Armadillo oferece operações de alto nível: multiplicação de matrizes, resolução de sistemas lineares, cálculo de autovalores, decomposição em valores singulares (SVD) e muito mais. A biblioteca é amplamente utilizada em projetos de pesquisa e na indústria, e sua API é tão próxima do MATLAB que o código muitas vezes pode ser portado quase que diretamente.

2. Instalação

Armadillo é uma biblioteca para C++, portanto não é instalada via pip ou npm. Em vez disso, você deve instalá-la como uma biblioteca do sistema ou integrá-la ao seu projeto via gerenciador de pacotes C++ (como vcpkg ou Conan) ou manualmente.

Método recomendado (Linux/macOS):

# Ubuntu / Debian
sudo apt-get install libarmadillo-dev

# macOS (via Homebrew)
brew install armadillo

# Fedora / RHEL
sudo dnf install armadillo-devel

Instalação via vcpkg (Windows, Linux, macOS):

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh  # ou bootstrap-vcpkg.bat no Windows
./vcpkg install armadillo

Compilação com Armadillo (g++/clang): Após a instalação, vincule a biblioteca:

g++ -std=c++11 -O2 meu_programa.cpp -larmadillo -o meu_programa

Para obter o máximo desempenho, é recomendável instalar também um backend BLAS otimizado (como OpenBLAS ou Intel MKL). O Armadillo o encontrará automaticamente se estiver instalado.

3. Primeiros passos

Um exemplo funcional mínimo, demonstrando a criação de matrizes e operações básicas:

#include <iostream>
#include <armadillo>

using namespace arma;

int main() {
    // Cria uma matriz 3x3 preenchida com uns
    mat A = ones<mat>(3, 3);
    std::cout << "Matriz A:\n" << A << std::endl;

    // Cria um vetor coluna
    vec b = {1, 2, 3};
    std::cout << "Vetor b:\n" << b << std::endl;

    // Resolve o sistema linear A * x = b
    vec x = solve(A, b);
    std::cout << "Solução x:\n" << x << std::endl;

    // Verificação: A * x deve ser igual a b
    std::cout << "Verificação A * x:\n" << A * x << std::endl;

    return 0;
}

Saída: O programa criará uma matriz de uns (todos os elementos iguais a 1), resolverá o sistema e exibirá o resultado.

4. Principais métodos e classes

O Armadillo fornece três classes principais: mat (matriz de double), vec (v