3 unstable releases

new 0.2.1 Dec 15, 2024
0.2.0 Dec 15, 2024
0.1.0 Dec 11, 2024

#206 in Math

Download history 4/week @ 2024-09-23 282/week @ 2024-12-09

282 downloads per month

MIT/Apache

210KB
774 lines

Hyperion

Crates.io crate license Docs.rs dependency status unsafe forbidden

![alt text](./.github/Screenshot-1.png) Hyperion is a highly Generic crate for working with lindenmayer systems (LSystems). Inspired by The [Algorithmic beauty of Plants](https://en.wikipedia.org/wiki/The_Algorithmic_Beauty_of_Plants). Made to work with all types of lsytems including:
  • Stochasic
  • Contextual
  • Parametric

Usage

As an example well implement the origin LSystem for the growth of algea.

Hyperion is a framework for working with generic LSystems the first step is to create an enum for grammar that makes up the lsystem.

NOTE: This doesn't necessarily have to be an enum. &'static str/String could also work.

use hyperion::{Rule, LSystemBuilder};

// By Default Alphabet is implemented for any `Copy + PartialEq` type.
#[derive(Clone, Copy, PartialEq)]
pub enum Algea {
    A,
    B,
}

/// Create an LSystem by passing in an Axiom and Rules.
use Algea::*;
let lsys = LSystemBuilder::new([A])
        .rule(Rule::new(A, [A, B]))
        .rule(Rule::new(B, [A]))
        .build();

// To Evauluate the LSystem call .`sample(generation)`. 
lsys.sample(4);
// returns [A, B, A, A, B, A, B, A]


More examples can be found in the tests folder. And a more complex example with rendering a 3d mesh with bevy can be found in the examples folder and run with

cargo run --example bevy_forest --release

Features

  • grammar (default)

License

All code in this repository is dual-licensed under either:

at your option. This means you can select the license you prefer.

Your contributions

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

~250–530KB