-
Notifications
You must be signed in to change notification settings - Fork 1
Home
OpenHAM is an open-source Heat, Air and Moisture transport model, initially written by Andreas Nicolai (andreas.nicolai -at- tu-dresden.de). It is meant as an open source reference implementation of the governing equations that are standardized, for example, in the HAMSTAD modeling document and the EN 15026 standard. It uses 1D geometries and includes an automated grid generation algorithm.
Also, it is a testing development to try out and demonstrate various solution methods for efficiently solving the coupled balance equations.
OpenHAM is distributed under an open source license, so that the engine can be freely used and HAM solvers do not need to be black-boxes anylonger. Also, future master/PhD students won't have to spent too much time by redoing the same mistakes as many others before (such as myself) and wasting precious research time by writing and debugging basic solver code.
The code base is based on my PhD thesis (see reference below) and uses the standardized and documented data and output file formats of the (much more capable and advanced) [DELPHIN simulation software].
- Nicolai A., Modeling and Numerical Simulation of Salt Transport and Phase Transitions in Unsaturated Porous Building Materials, PhD Thesis, Syracuse University, 2007
- Vogelsang S., Fechner H. & Nicolai A., Delphin 6 Material File Specification, Technical Report, Technische Universität Dresden, http://nbn-resolving.de/urn:nbn:de:bsz:14-qucosa-126274, 2013
- Vogelsang S. & Nicolai A., Delphin 6 Output File Specification, Technical Report, Technische Universität Dresden, http://nbn-resolving.de/urn:nbn:de:bsz:14-qucosa-70337, 2011
- (in preparation) Nicolai A., An open-source hygrothermal transport solver reference implementation according to EN 15026
OpenHAM is a console application and does not require an installer. Simply extract the archives into some subdirectory and run the solver.
You may want to use the --help command line argument to see available options:
> OpenHAMSolver --help
Please post bugs/feature requests via the ticket system.
The Linux binaries are compiled on a fairly recent Ubuntu installation, typically either 16.04 LTS or Ubuntu 18.04 LTS. Running the executable requires the usual C/C++/GCC libraries (see release notes for details). On different Linux distros, simply recompile the solver - it does not have any dependencies beside the usual built-essentials package.
- physical model conforms to that of DELPHIN, or HAMSTAD modeling document, or EN 15026 (2017) (for details, see publication)
- Material model and supported functions/built-in functions
- input data files follow format conventions of the DELPHIN software: d6p-files for projects/constructions, m6-files for materials, This allows exchange of data files between OpenHAM and DELPHIN and allows reusing some implementation functionality. Details for input file formats are listed in:
- Material data file format
- OpenHAM project file format (actually a subset of DELPHIN 6 input files)
- output files are written in DataIO standard, which allows use of the free PostProcessing software from IBK (see [Bauklimatik Dresden]. A converter utility to extract data from DataIO containers and/or convert to other formats (CSV, TecPlot) is available.
- see Output handling
- Automatic grid generation (equidistant or variable), see Grid Generation Algorithms
- Implicit Euler Time Integration
- Newton-Rapshon solution for non-linear equation systems
- different options for modified Newton-Raphson: strict, once-per-step, threshhold-based
- Banded matrix for solving linear equation systems
- Different options for selecting the solution variable
- Time step adaptation based on convergence properties and local error control
Details see publications.
Suggested is the use of Qt Creator as development environment, with gcc compiler on Linux/Mac and gcc/VC on Windows. For details see wiki-page Development.
Editing: The wiki uses Markdown syntax.