Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heckj/lindenmayer
A swift library that implements a parametric Lindenmayer system and related SwiftUI views for presentation of the results of your systems.
https://github.com/heckj/lindenmayer
lindenmayer swift swift5 swiftui
Last synced: 17 days ago
JSON representation
A swift library that implements a parametric Lindenmayer system and related SwiftUI views for presentation of the results of your systems.
- Host: GitHub
- URL: https://github.com/heckj/lindenmayer
- Owner: heckj
- License: mit
- Created: 2021-12-23T04:11:38.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-08T23:32:33.000Z (4 months ago)
- Last Synced: 2024-10-10T19:41:06.032Z (about 1 month ago)
- Topics: lindenmayer, swift, swift5, swiftui
- Language: Swift
- Homepage: https://swiftpackageindex.com/heckj/Lindenmayer/main/documentation/lindenmayer
- Size: 7.1 MB
- Stars: 34
- Watchers: 2
- Forks: 3
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Lindenmayer
[](https://github.com/heckj/Lindenmayer/actions/workflows/swift.yml)
[]()
[](https://developer.apple.com/swift)
[](https://opensource.org/licenses/MIT)
[](http://twitter.com/heckj)
[](https://swiftpackageindex.com/heckj/Lindenmayer)
[](https://swiftpackageindex.com/heckj/Lindenmayer)
The package provides a library you can expand upon to develop your own [Lindenmayer systems](https://en.wikipedia.org/wiki/L-system), directly in the Swift programming language.
While the package includes a number example L-systems, the primary intent is to allow you to create L-systems with rules and modules that you define.
This implementation provides support for context sensitive, and parametric grammars when creating your L-system.
The library provides 2D and 3D representation rendering of a current L-system states, including some SwiftUI views that you can use to display either 2D or 3D results:
- The 2D representation uses [Canvas](http://developer.apple.com/documentation/swiftui/Canvas) and [GraphicsContext](https://developer.apple.com/documentation/swiftui/graphicscontext) from [SwiftUI](https://developer.apple.com/documentation/swiftui) on Apple platforms.
- The 3D representation uses [SceneKit](https://developer.apple.com/documentation/scenekit) on Apple platforms.
The repository has [Discussions](https://github.com/heckj/Lindenmayer/discussions) enabled if you have questions, as well as [issues logged for planned improvements](https://github.com/heckj/Lindenmayer/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement).
Contributions are welcome - as discussion, feedback, questions, or code.
## Inspiration
A combination of influences led to this development, initial as an experiment and general exploration.
One part was the [lindenmayer swift playground](https://github.com/henrinormak/lindenmayer) by [@henrinormak](https://twitter.com/henrinormak), which implements a great single-character representation which is perfect for exploring fractal systems.
That, in turn, was built on the work of Aristid Lindenmayer in the book [The Algorithmic Beauty of Plants](http://algorithmicbotany.org/papers/#abop).
The research that Aristid Lindenmayer started continues to be expanded by [Professor Przemyslaw Prusinkiewicz](https://pages.cpsc.ucalgary.ca/~pwp) with generous publications of research papers on the site [Algorithmic Botany](http://algorithmicbotany.org).
A couple of the papers expand on the tooling to create and evaluate L-systems, and their advances allow for interesting new capabilities to be expressed in the L-systems:
- [The Design and Implementation of the L+C Modeling Language](http://algorithmicbotany.org/papers/l+c.tcs2003.html) (R Karwowski 2003)
- [Parametric L-systems and Their Application to the Modelling and Visualization of Plants](http://algorithmicbotany.org/papers/hanan.dis1992.html) (J Hanan 1992)
The features that I was most interested in leveraging:
- Parameters within an L-system's modules and exposing them to grammar evaluation and production choices (parametric L-systems).
- The introduction of random values with those parameters (stochastic grammars).
While this project can be implemented using an interpreter, I wanted to see how far I could leverage the Swift language.
This project attempts to follow in the conceptual footsteps of the L+C language to create a mechanism to create L-systems that compile down to machine code for efficiency of execution.