SAM is part of SAM Toolkit that is designed to help engneers to create Analytical Model. Welcome and let's make the opensource journey continue. 🤝
SAM_SolarCalculator is a module of the Sustainable Analytical Model (SAM) software developed by Michal Dengusiak and Jakub Ziolkowski. It provides functionality for simulating solar radiation on building surfaces and generating energy models.
- Calculation of solar irradiance on surfaces
- Calculation of solar shading and self-shading effects
- Generation of energy models for buildings based on the calculated solar irradiance
To install SAM from .exe just download and run latest installer otherwise rebuild using VS SAM
SAM_SolarCalculator is a C# project that can be compiled and integrated into larger projects. It has the following dependencies:
- SAM.Core, the core library of the SAM software
- SAM.Geometry, the geometry module of the SAM software
SAM_SolarCalculator provides a Simulate class with methods for simulating solar irradiance and generating energy models.
public static IEnumerable<Surface> Simulate(this IEnumerable<Surface> surfaces, DateTime dateTime, double timeZone = 0, double inclination = 0, double azimuth = 0, double tolerance = Tolerance.Angle, double areaAdjustment = 1, double altitude = double.NaN, double latitude = double.NaN, double longitude = double.NaN, double diffusedFraction = 0.3, double directFraction = 0.7)public static EnergyBase Simulate(this Space space, double solarReflectance, double visibleReflectance, double[] assemblyThicknesses, IEnumerable<Panel> panels, Material sunMaterial, Material skyMaterial, double gridSize = 1, double tolerance = Tolerance.MicroDistance, double offset = 0.1, double factor = 2.5)Examples of how to use SAM_SolarCalculator can be found in the Examples directory.
If you would like to contribute to SAM_SolarCalculator, please fork the repository and submit a pull request. Before submitting a pull request, please make sure that your code adheres to the coding standards and conventions used in the project.
SAM is free software licenced under GNU Lesser General Public Licence - https://www.gnu.org/licenses/lgpl-3.0.html
Each contributor holds copyright over their respective contributions.
The project versioning (Git) records all such contribution source information.
See LICENSE and COPYRIGHT_HEADER.