Instalação

• CPython 3.12, 3.13 ou 3.14
• numpy (2.0+), pyproj e shapely (instalados automaticamente como dependências)
• Wheels prontas para Linux em x86_64 (glibc 2.28+), macOS em arm64 (14+) e x86_64 (15+) e Windows em x86_64. Não é publicada distribuição de código-fonte, então outras plataformas e versões do Python não conseguem instalar o pacote.

• Rust 1.85+ (edition 2024)
• Linux em x86_64 (x86_64-unknown-linux-gnu), macOS em Apple Silicon (aarch64-apple-darwin) e Intel (x86_64-apple-darwin), ou Windows em x86_64 com o toolchain GNU (x86_64-pc-windows-gnu); o toolchain MSVC ainda não é suportado
• GEOS 3.12 ou mais recente e PROJ 9.6.2 ou mais recente (veja a nota abaixo para um PROJ mais antigo), além do runtime de Fortran, OpenMP e BLAS usado pelos kernels nativos

pip install apbase

Para instalar a versão de desenvolvimento a partir do repositório:

pip install git+https://github.com/ap-base/apbase-python.git

Instale as bibliotecas do sistema e depois adicione o crate. No Linux (Ubuntu/Debian):

sudo apt install gfortran libopenblas-dev libgeos-dev libproj-dev pkg-config
cargo add apbase

No macOS, com o Homebrew:

brew install gcc openblas geos proj pkgconf
cargo add apbase

No Windows, instale o MSYS2 e, no shell MINGW64 dele:

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gcc-fortran mingw-w64-x86_64-openblas \
  mingw-w64-x86_64-geos mingw-w64-x86_64-proj mingw-w64-x86_64-pkgconf

Depois compile com o toolchain GNU do Rust, com C:\msys64\mingw64\bin em primeiro lugar no PATH:

rustup toolchain install stable-x86_64-pc-windows-gnu
rustup default stable-x86_64-pc-windows-gnu
$env:PKG_CONFIG = "pkgconf"
cargo add apbase

Os programas compilados precisam das DLLs de mingw64\bin (libgfortran, libgomp, OpenBLAS, GEOS, PROJ) no PATH ou ao lado do executável.

Em vez do cargo add, você pode declará-lo no Cargo.toml:

[dependencies]
apbase = "0.2.0"

Os kernels Fortran vêm dentro do crate como biblioteca estática, então nenhum compilador Fortran roda durante o build. Os pacotes de Fortran e OpenBLAS acima só são necessários na etapa de link, que procura libgfortran, libgomp e OpenBLAS.

Três variáveis de ambiente de build mudam o que é linkado: APBASE_BLAS_LIBS recebe bibliotecas BLAS/LAPACK separadas por espaço para linkar no lugar do OpenBLAS (entradas -L<dir> acrescentam um diretório de busca), APBASE_FORTRAN_LIB_DIR aponta para o diretório com libgfortran e libgomp quando o linker não os encontra, e APBASE_NATIVE_LIB_DIR aponta para um diretório com o seu próprio libapbase_native.a, para builds de desenvolvimento.

O argumento targets de IDW, Kriging e CoKriging também aceita um GeoDataFrame ou GeoSeries de pontos quando o geopandas está instalado. Você pode dispensar esse extra se passar arrays NumPy simples:

pip install geopandas

O crate Rust não tem extras opcionais. Contornos são passados como WKT, WKB ou geos::Geometry, e os pontos a estimar como arrays ndarray, slices de pares [x, y], valores geos::Geometry de ponto ou um Grid ajustado.

Gere um mapa pequeno para confirmar que os kernels nativos carregam e rodam:

import numpy as np

import apbase

rng = np.random.default_rng(0)
x, y = rng.uniform(0, 100, 50), rng.uniform(0, 100, 50)
result = apbase.create_map(x, y, x + y, resolution=10.0)
print(result.method, result.z.size)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let x: Vec<f64> = (0..50).map(|i| (i * 37 % 100) as f64).collect();
    let y: Vec<f64> = (0..50).map(|i| (i * 61 % 100) as f64).collect();
    let z: Vec<f64> = x.iter().zip(&y).map(|(a, b)| a + b).collect();
    let result = apbase::create_map(&x, &y, &z, apbase::MapOptions::new(10.0))?;
    println!("{} {}", result.method, result.z.len());
    Ok(())
}

cargo run --release