SAM

An open-source software designed to help engineers create analytical models of energy-efficient buildings.
https://github.com/hoarelea/sam

Category: Consumption
Sub Category: Buildings and Heating

Keywords

core sam

Last synced: about 8 hours ago
JSON representation

Repository metadata

Sustainable Analytical Model (SAM) - Core

README.md

Build (Windows)
Installer (latest)

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.

SAM provides a structured analytical representation of buildings,
supporting workflows for energy modelling, systems analysis,
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.


What SAM provides

At its core, SAM enables:

  • creation and management of analytical building models
  • assignment of constructions, loads, and system definitions
  • preparation of models for simulation and analysis
  • orchestration of analytical workflows and scenarios
  • integration with external tools and simulation engines

SAM supports both programmatic and visual workflows,
including integration with environments such as Grasshopper, Rhino, and Revit.


Extensibility

The SAM platform is intentionally modular.
Additional repositories provide functionality such as:

  • simulation engine integrations (e.g. Tas, OpenStudio)
  • data exchange formats (IFC, gbXML, GEM)
  • environmental and physical calculations (psychrometrics, solar, acoustics)
  • UI layers and scripting interfaces (Windows UI, Rhino, Python)
  • experimental and research workflows

The full ecosystem, module descriptions, and relationships
are documented in the SAM Wiki.


Getting started

To install SAM, download and run the
latest Windows installer.

Alternatively, the toolkit can be built from source using Visual Studio.
See the documentation in the SAM Wiki for setup guidance and build details.


Documentation

📘 SAM Wiki:
https://github.com/SAM-BIM/SAM/wiki

The Wiki contains:

  • module overviews and relationships
  • build and dependency information
  • workflow examples
  • developer and contributor guidance

Licence

This repository is free software licensed under the
GNU Lesser General Public License v3.0 or later (LGPL-3.0-or-later).

Each contributor retains copyright to their respective contributions.
The project history (Git) records authorship and provenance of all changes.

See:

  • LICENSE
  • NOTICE
  • COPYRIGHT_HEADER.txt

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 8 days ago

Total Commits: 4,184
Total Committers: 6
Avg Commits per committer: 697.333
Development Distribution Score (DDS): 0.294

Commits in past year: 217
Committers in past year: 2
Avg Commits per committer in past year: 108.5
Development Distribution Score (DDS) in past year: 0.406

Name Email Commits
Jakub Ziolkowski j****i@d****k 2955
Michal Dengusiak t****n@g****m 1203
Maciej Dengusiak m****k@g****m 17
Will Reynolds w****s@h****m 4
Michal Dengusiak d****k@g****m 4
Dengusiak M****K@t****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: about 1 month ago

Total issues: 71
Total pull requests: 51
Average time to close issues: 19 days
Average time to close pull requests: 1 day
Total issue authors: 1
Total pull request authors: 4
Average comments per issue: 0.96
Average comments per pull request: 0.27
Merged pull request: 35
Bot issues: 0
Bot pull requests: 14

Past year issues: 2
Past year pull requests: 6
Past year average time to close issues: N/A
Past year average time to close pull requests: 20 minutes
Past year issue authors: 1
Past year pull request authors: 2
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.0
Past year merged pull request: 5
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/hoarelea/sam

Top Issue Authors

  • michaldengusiak (71)

Top Pull Request Authors

  • ZiolkowskiJakub (27)
  • dependabot[bot] (14)
  • MaciejDengusiak (7)
  • michaldengusiak (3)

Top Issue Labels

  • bug (41)
  • feature request (32)
  • question (1)

Top Pull Request Labels

  • dependencies (14)

Dependencies

Dynamo/SAMAnalyticalDynamo/SAMAnalyticalDynamo.csproj nuget
Dynamo/SAMCoreDynamo/SAMCoreDynamo.csproj nuget
Dynamo/SAMGeometryDynamo/SAMGeometryDynamo.csproj nuget
Grasshopper/SAM.Analytical.Grasshopper/SAM.Analytical.Grasshopper.csproj nuget
Grasshopper/SAM.Architectural.Grasshopper/SAM.Architectural.Grasshopper.csproj nuget
Grasshopper/SAM.Core.Grasshopper/SAM.Core.Grasshopper.csproj nuget
Grasshopper/SAM.Geometry.Grasshopper/SAM.Geometry.Grasshopper.csproj nuget
Grasshopper/SAM.Math.Grasshopper/SAM.Math.Grasshopper.csproj nuget
Grasshopper/SAM.Weather.Grasshopper/SAM.Weather.Grasshopper.csproj nuget
Rhino/SAM.Analytical.Rhino/SAM.Analytical.Rhino.csproj nuget
Rhino/SAM.Core.Rhino/SAM.Core.Rhino.csproj nuget
Rhino/SAM.Geometry.Rhino/SAM.Geometry.Rhino.csproj nuget
Rhino/SAM.Math.Rhino/SAM.Math.Rhino.csproj nuget
SAM/SAM.Analytical/SAM.Analytical.csproj nuget
SAM/SAM.Architectural/SAM.Architectural.csproj nuget
SAM/SAM.Core/SAM.Core.csproj nuget
SAM/SAM.Geometry/SAM.Geometry.csproj nuget
SAM/SAM.Math/SAM.Math.csproj nuget
SAM/SAM.Units/SAM.Units.csproj nuget
SAM/SAM.Weather/SAM.Weather.csproj nuget

Score: 6.040254711277415