# linkcell > Periodic linked-cell neighbour lists for molecular simulations: a cutoff pair list (`pairs_within`) with the caller's lattice shift per row, and a k-nearest list (`knearest`), on orthorhombic and general triclinic cells. The Rust crate `linkcell` is the implementation. The C ABI (`lc_*`, `include/linkcell.h`) is the interface every other language uses: C++ through `include/linkcell.hpp`, Python through DLPack (`pip install linkcell`). Meson, CMake and pkg-config consume an installed prefix. seams-core (d-SEAMS) calls this library for its neighbour lists. Contributor rules and commands are in the contributing guide at the repository root. ## Start - [README](https://github.com/d-SEAMS/linkcell/blob/main/README.md): what the library computes, install lines for Rust, C, C++, Python, Meson and CMake - [Documentation site](https://linkcell.dseams.info/): the pages below, rendered - [Tutorial: two points](https://linkcell.dseams.info/tutorials/two-points/): nearest neighbour of two atoms in a 10-unit cubic box, in each language ## How-to guides - [Embed linkcell from C](https://linkcell.dseams.info/how-to/embed-c/): link the installed CPU library and include linkcell.h - [Embed linkcell from C++](https://linkcell.dseams.info/how-to/embed-cpp/): the C++17 RAII header over the C ABI, with CMake - [Embed linkcell from Python](https://linkcell.dseams.info/how-to/embed-python/): the DLPack module, accepting any object with `__dlpack__()` - [Use pkg-config](https://linkcell.dseams.info/how-to/pkg-config/): linkcell.pc and linkcell-gpu.pc from Meson and CMake installs ## Reference - [C ABI](https://linkcell.dseams.info/reference/c-api/): every `lc_*` entry point, ownership, thread width, and error contract - [Rust API](https://linkcell.dseams.info/api/linkcell/): rustdoc for the crate - [Algorithm](https://linkcell.dseams.info/reference/algorithm/): the linked-cell walk, the k-heap per source, basis reduction, cost, threading and bit identity - [Features and instruction-set builds](https://linkcell.dseams.info/reference/features/): Cargo features, `LINKCELL_SIMD`, and the AVX2, AVX-512 and NEON kernels - [Cell partition](https://linkcell.dseams.info/reference/partition/): domain ids per cell, halos, and the balance bound - [Changelog](https://github.com/d-SEAMS/linkcell/blob/main/CHANGELOG.md): release notes per version ## Explanation - [Minimum image and linked cells](https://linkcell.dseams.info/explanation/mic-and-cells/): why the walk applies lattice shifts per cell instead of a minimum image per pair - [SIMD paths and dispatch](https://linkcell.dseams.info/explanation/simd-paths/): scalar, AVX2, AVX-512 and NEON paths, and the bit identity they keep ## Related - [minimage](https://github.com/lode-org/minimage): the minimum-image library linkcell uses for cell geometry and floors - [seams-core](https://github.com/d-SEAMS/seams-core): the d-SEAMS analysis engine that calls linkcell, documented at https://docs.dseams.info