5 unstable releases

0.4.0 Jun 26, 2024
0.3.1 May 31, 2024
0.3.0 May 22, 2024
0.2.1 Apr 26, 2024
0.2.0 Apr 22, 2024

#274 in Data structures

Download history 299/week @ 2024-04-22 24/week @ 2024-04-29 161/week @ 2024-05-20 134/week @ 2024-05-27 14/week @ 2024-06-03 8/week @ 2024-06-10 134/week @ 2024-06-24

162 downloads per month
Used in honeycomb-render

MIT/Apache

255KB
4K SLoC

Honeycomb

Current Version GitHub commits since latest release Build Status Rust Tests codecov

Honeycomb aims to provide a safe, efficient and scalable implementation of combinatorial maps for meshing applications. More specifically, the goal is to converge towards a (or multiple) structure(s) adapted to algorithms exploiting GPU and many-core architectures.

The current objective is to implement basic meshing algorithms to evaluate the viability of the implementation & improve our structure using Rust's framework to streamline the refactoring and parallelization process.

Usage

The user guide provides an overview of everything available in the project as well as usage instructions. It can be generated offline using mdbook. Note that generating the doc using a stable toolchain is possible, the features just won't be documented as clearly.

# Serve the doc on a local server
mdbook serve --open -d ../target/doc/ user-guide/ &
cargo +nightly doc --all --all-features --no-deps
# Kill the local server
kill $(pidof mdbook) 

# Without pidof
kill $(ps -e | awk '/mdbook/ {print $1}')

Rust

The content of each member is described in their respective Rust Doc as well as in the user guide. The following crates are published:

  • Core Version docs.rs basic structures
  • Render Version docs.rs visualizing tool

The repository also hosts these members:

  • Benchmarks are grouped in the honeycomb-benches crate (Rust Doc)
  • Examples are grouped in the honeycomb-examples crate (Rust Doc)

Contributing

Contributions are welcome and accepted as pull requests on GitHub. Feel free to use issues to report bugs, missing documentation or suggest improvements of the project.

Note that a most of the code possess documentation, including private modules / items / sections. You can generate the complete documentation by using the instructions above and passing the option --document-private-items to cargo doc.

License

Licensed under either of

at your preference.

The SPDX license identifier for this project is MIT OR Apache-2.0.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.4–1MB
~21K SLoC