From 4bafc9563e5fd04f5b052ab37a5cd41bfad0e18f Mon Sep 17 00:00:00 2001 From: Sergio Souza Costa Date: Wed, 23 Sep 2026 07:55:45 -0300 Subject: [PATCH] docs(readme): add the ecosystem map to the Ecosystem section --- README.md | 6 ++ docs/assets/images/dissmodel_ecosystem.svg | 114 +++++++++++++++++++++ 2 files changed, 120 insertions(+) create mode 100644 docs/assets/images/dissmodel_ecosystem.svg diff --git a/README.md b/README.md index 62997f1..03fada9 100644 --- a/README.md +++ b/README.md @@ -247,6 +247,12 @@ Every run via the executor lifecycle generates a `profiling_{id}.md` alongside t DisSModel is a core framework. To maintain a clean and specialized environment, all simulation models and implementation examples are hosted in separate repositories within the DisSModel ecosystem. +The map below shows how the pieces fit together, and how each one relates to its counterpart in INPE's TerraME ecosystem, which DisSModel takes as its conceptual basis. It is an early snapshot: the `dissmodel` core is the most mature piece, and the other packages are still taking shape. + +

+ DisSModel ecosystem map: TerraME is the conceptual basis for the dissmodel core; TerraME's CA, system dynamics and agent-based packages correspond to dissmodel-ca, dissmodel-sysdyn and dissmodel-abm; LuccME corresponds to disslucc; fillCell corresponds to disscube; haloexec and dissmodel-platform are new infrastructure with no TerraME counterpart +

+ ### 馃敩 Specialized Model Libraries | Repository | Description | Install | diff --git a/docs/assets/images/dissmodel_ecosystem.svg b/docs/assets/images/dissmodel_ecosystem.svg new file mode 100644 index 0000000..fa36d78 --- /dev/null +++ b/docs/assets/images/dissmodel_ecosystem.svg @@ -0,0 +1,114 @@ + + + DisSModel ecosystem map + DisSModel mirrors the TerraME ecosystem from INPE as an independent Python alternative: TerraME is the conceptual basis for the dissmodel core; TerraME's cellular automata, system dynamics and agent-based packages correspond to dissmodel-ca, dissmodel-sysdyn and dissmodel-abm; LuccME corresponds to disslucc; fillCell corresponds to disscube. haloexec and dissmodel-platform are new infrastructure for scale and reproducible execution. + + + + + + + + + REFERENCE 路 INPE + DISSMODEL ECOSYSTEM 路 PYTHON + + + + TerraME + Spatial dynamic modeling (Lua) + + conceptual basis + + + + + dissmodel + Core 路 Environment, Model, vector & raster cellular spaces, scheduling + + + DIDACTIC PACKAGES 路 MODELING PARADIGMS + + TerraME packages + CA 路 sysdyn 路 ABM + + similar packages + + + + + dissmodel-ca + Cellular automata + + + + dissmodel-sysdyn + System dynamics + + + + dissmodel-abm + Agent-based models + + + DOMAIN + + LuccME + LUCC framework on TerraME + + independent + alternative + + + + + disslucc + Land use & cover change 路 Demand 路 Potential 路 Allocation + + + DATA PREPARATION 路 CELLULAR SPACES + + fillCell + Filling cells with data + + similar role + + + + + disscube + Chunked raster cubes 路 grid alignment 路 cell filling + + + INFRASTRUCTURE 路 BEYOND TERRAME + No direct counterpart: + an evolution toward scale and + reproducible execution + + + + haloexec + Larger-than-RAM CA 路 halo / ghost cells + may later move into the core + + + + dissmodel-platform + JupyterLab 路 FastAPI 路 MinIO 路 Redis 路 provenance + prototype, not yet hardened + + + + More mature + Early stage 路 in development + All packages build on the dissmodel core. + An early snapshot: most packages are just getting started, and boundaries and APIs will change. Feedback is very welcome. +