From ad647869ff46237ea4e86ae656c6156b9d7ca1da Mon Sep 17 00:00:00 2001 From: SAM-BIM-AI Date: Thu, 10 Sep 2026 09:22:07 +0200 Subject: [PATCH] docs(readme): frame SAM as the analytical-model platform, fix logo image URL - Logo src used the github.com blob page (renders as broken image); use raw URL - First screen: what SAM is, Grasshopper/Rhino/Revit as hosts not foundation, website/installer/wiki links - Commented screenshot strip reserved for E06/E01/E04 evidence captures --- README.md | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 5e4981a31..cd66f7543 100644 --- a/README.md +++ b/README.md @@ -4,13 +4,14 @@ # SAM - **SAM (Sustainable Analytical Model)** is the core of the **SAM Toolkit** — -an open-source platform designed to help engineers create, manage, -and analyse analytical building models for energy and environmental performance. +an open-source analytical-model and computational-engineering platform that +connects BIM, building physics, HVAC engineering and simulation through +deterministic, tested and traceable workflows. SAM provides a structured analytical representation of buildings, supporting workflows for energy modelling, systems analysis, @@ -19,7 +20,24 @@ environmental simulation, and performance-driven design. It is designed as a **modular and extensible platform**: core analytical concepts are implemented in this repository, with additional functionality provided through specialised SAM modules -and integrations. +and integrations. SAM is **not a Grasshopper plugin** — Grasshopper, +Rhino and Revit are hosts and adapters on top of the analytical model, +not its foundation. + +**Website:** https://sambim.xyz · +**Installer:** [SAM_Deploy releases](https://github.com/SAM-BIM/SAM_Deploy/releases/latest) · +**Documentation:** [SAM Wiki](https://github.com/SAM-BIM/SAM/wiki) + + ---