|0.7.6||Nov 11, 2023|
|0.7.4||Apr 10, 2023|
|0.7.1||Dec 21, 2022|
|0.7.0||Oct 29, 2022|
|0.3.3||Jul 28, 2021|
#170 in Simulation
120 downloads per month
A reasonably simple entity component system (ECS) developed for use in the simulation models of project group EcoEpi at the Helmholtz Centre for Environmental Research. The design is based on hecs but has a significantly reduced API surface.
It also has a few changes and additions specific to our use case:
- Its borrow checking is not thread-safe. Single-threaded simulations are often preferable as their execution is trivially deterministic. Additionally, running multiple instances of these in parallel often gives the highest throughput.
- It supports amortised random access to query results by entity identifier using the
QueryRef::mapmethod. This can be useful to efficiently traverse graph-like relations between entities.
- Entities can be transferred between worlds without serialisation using the
World::transfermethod. We use this to completely remove entities from the simulation while keeping their full dynamic state around for later inspection.
- Worlds can be snapshotted to enable e.g. rollback netcode. Due to the lack of specialization on stable Rust, this requires a
Clonerto collect clone and copy methods for all component types.
World::exchangemethod combines removing some and then adding other components for a given entity. This can be used to optimise type-level state machines.
- While queries must be dispatched from a single thread, their results can be iterated using multiple threads via the
QueryRef::par_itermethod. The method is optional, implemented using Rayon and enabled by the
at your option.
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.