Installation¶

Python¶

Binary wheels are available on PyPI for Linux (x86_64, ARM64), macOS (ARM64), and Windows (x86_64):

pip install tetra3rs

Building from source requires a Rust toolchain:

git clone https://github.com/ssmichael1/tetra3rs.git
cd tetra3rs
pip install .

The crate is published on crates.io as tetra3:

cargo add tetra3

To enable centroid extraction from images, add the image feature:

cargo add tetra3 --features image

tetra3rs generates its pattern database from the Hipparcos catalog. Download hip2.dat:

mkdir -p data
curl -o data/hip2.dat.gz "http://cdsarc.u-strasbg.fr/ftp/I/311/hip2.dat.gz"
gunzip data/hip2.dat.gz

Note

The Hipparcos catalog is also downloaded automatically when running the integration tests (cargo test --features image).