[](https://github.com/EmilyMatt/mapping-rs/actions/workflows/main.yml)
[](https://codecov.io/gh/EmilyMatt/mapping-rs)
[](https://github.com/EmilyMatt/mapping-rs/issues)
[](https://github.com/EmilyMatt/mapping-rs?tab=License-1-ov-file)


[](https://github.com/EmilyMatt/mapping-rs/fork)
[](https://discord.gg/j4z4WM3ZNV)
# mapping-suites
### SLAM suites based on the `mapping-algorithms` crates
## ⚠️ Unstable API ⚠️
### Warning: this crate is in early development, breaking API changes are to be expected.
## Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
mapping-suites = { git = "https://github.com/EmilyMatt/mapping-rs.git" }
```
# Features
## no_std support
While the `std` feature is enabled by default,
this crate can was designed with `no_std` support in mind,\
provided that a memory allocator is configured
(this crate __does__ use the `alloc` crate).
It can be easily achieved like so:
```toml
[dependencies.mapping-suites]
default-features = false
```
## tracing
This crate provides profiling and instrumentation insight
via the [tracing](https://github.com/tokio-rs/tracing) crate.
To use it, simply enable the `tracing` feature in your Cargo.toml,
and use your choice of a subscriber.
Note that different functions have different tracing levels.
Since each and every function is instrumented, be sure to remember the overhead for enabling tracing.
## Contributing
If you would like to contribute, we welcome your contributions.
Please be sure to check out our [CONTRIBUTING.md](https://github.com/EmilyMatt/mapping-rs/blob/main/CONTRIBUTING.md)