Bauklimatik-Dresden TrainingDownloadsClimate DataForumImpressumPrivacy Policy deutsch
Documentation & Help
Main pageDocumentation & HelpScreenshotsFAQOrder & LicensesContact
    START»DELPHIN»DOCUMENTATION & HELP

Program- and Model Documentation

The manual for DELPHIN 6 is currently under development and will be available shortly. Until then please refer to the training material of the DELPHIN courses, or the tutorials listed on this page.

The following presentations give a short introduction and overview of the DELPHIN 6 user interface:

  • Nicolai_DELPHIN6_WhatsNew.pdf - New features and optimizations in the hygrothermal transport model DELPHIN 6.

    As a general introduction, and particularly for users switching from DELPHIN 5 to DELPHIN 6, this presentation gives an overview of many functions and central features.

  • Nicolai_DELPHIN6.1_WhatsNew_en.pdf - Overview of new features in DELPHIN 6.1.

    A short tour through the program with introduction to new features, both in the user interface and associated tools.

 

Validation

Validation is the step right after parameterization/calibration (the task to obtain parameters for a specific model from experiments).

The purpose of validation is to use the model and parameterization obtained for a set of exemplary cases (e.g. lab experiments) and apply the model to a new test case. The predicted results are then compared to the measured results for this new case. Hereby, it is important for the validation, that the measured data has not been used in the parameterization/calibration phase.

DELPHIN was validated several times, with focus on different aspects of the software:

Numerical Validation

The implementation and the numerical solution method in the simulation program was checked with the following tests:

  • HAMSTAD Benchmarks 1 through 5
    (transient heat, air and moisture transport)
    Details on HAMSTAD benchmarks
  • EN 15026:2007
    (Transient heat and moisture transport)
  • EN 10211:2007
    (Steady-state heat transport)
    Details on grid sensitivity
  • IBK Wetting and drying
    (Transient heat and moisture transport, focus on capillary transport in middle and low moisture range)


Details on the validation, i.e. model configuration, solver parameters, result calculation etc. are provided in the following publication:

Luisa Sontag, Andreas Nicolai, Stefan Vogelsang,
Validierung der Solverimplementierung des hygrothermischen Simulationsprogramms DELPHIN,
2013, Qucosa, urn:nbn:de:bsz:14-qucosa-128968

This document lists all conditions and requirements of the test cases, include the wetting and drying test defined at the Institute of Building Climatology (TU Dresden) specifically for testing simulations of interior insulation systems.

Validation of transport model

The transport model, and the integrated material and climatic data models were tested in different research projects.

Test houses

  • Talstrasse (Dresden)
  • Herrenschießhaus (Nürnberg)
  • Gemeinschaftshaus (Nürnberg-Langwasser)
  • Umgebindehaus (Ebersbach)
  • Fachwerkhaus (Niedersachsen/Edemissen)
  • Bahnmeistergasse (Senftenberg)
  • Handwerk 15 (Görlitz)

Dissertations

  • Gregor Scheffler: Validation of hygrothermal material modelling under consideration of the hysteresis of moisture storage


Further, DELPHIN was and is used by several research institutes, and it is continuously tested and adapted for different application cases.

 

Performance tests

The DELPHIN solver is parallelized and runs very efficiently on Windows, MacOS and Linux. To compare performance and to evaluate how different hardware is suitable for running DELPHIN simulations, we created a small performance benchmark.

The report PerformanceComparison.pdf (in German) contains a fairly complete description and a selection of results from computers used at the Institut für Bauklimatik.

Test own hardware

It is easily possible to test own hardware by downloading the operating system-specific test archive and running the test script therein. The results are stored in result_xxx-files, whereby the number indicates the number of CPUs used. The results can be compared with the data in the report.

We would like to include such test results also in our statistics. Therefore we'd be happy about test results (results-01.csv...results-04.csv) sent to us, and a small description of the used hardware.

 
 

Step-by-Step Tutorials

The tutorials listed below should give an easy introduction into the program.

Tutorial 1: Basics of the Project Setup

This tutorial shows the basic steps for creating simulation projects in DELPHIN. Using an masonry wall that needs to be insulated as example, the necessary steps are discussed for setting up a simulation and specifying all required parameters. The tutorial is valid from version 6.1.3.

    » Tutorial 1 - Introduction (DELPHIN 6.1.6, PDF, Online)

Older versions.

    » Tutorial 1 (DELPHIN 6.1, PDF)
    » Tutorial 1 (DELPHIN 5, PDF)
    » Tutorial 1 (DELPHIN 6.0, PDF)
    » Tutorial 1 (DELPHIN 6.1.5, PDF)
    » Tutorial 1 (DELPHIN 6.1.5, Online)

Tutorial 2: Modelling a 2D construction detail

This tutorial extends the first tutorial. Focus lies on modelling 2D constructions. A thermal bridge problem is used as example to show the steps in editing the construction and specifying boundary conditions on the various surface of the construction detail. Also, the definition of outputs and the specifics of flux outputs are explained.

    » Tutorial 2 - Introduction 2D (DELPHIN 6.1.5, PDF, Online)

Older versions.

    » Tutorial 2 (DELPHIN 5, PDF)
    » Tutorial 2 (DELPHIN 6.0, PDF)

Tutorial 3: Analysis of results/the Post-Processing

This tutorial covers typical steps in using the post-processing for analysis of results.

    » Tutorial 3 - Quick Start PostProc 2 (PDF, Online)

Older versions.

    » Tutorial 3 (old Post-processing, PDF)

Tutorial 4: Defining outputs

This tutorial explains in detail how to define output files in DELPHIN.

    » Tutorial 4 - Outputs (DELPHIN 6.1, PDF, Online)

Older versions.

    » Tutorial 4 - Outputs (DELPHIN 5, PDF)

Tutorial 5: Assessment of constructions

The current status of construction assessments is shown here. What evaluations exist and what the standards say about them. Then examples are used to show how these evaluations can be implemented in DELPHIN from version 6.1.5.

    » Tutorial 5 - Assessments (DELPHIN 6.1.6, PDF, Online)

Tutorial 6: Climate data

This tutorial explains the handling and use of climate data

    » Tutorial 6 - climate data (DELPHIN 6.1, PDF, Online)

Tutorial 7: Modelling of 3D models

This tutorial explains how to create and evaluate three-dimensional simulations in Delphin 6.

    » Tutorial 7 - 3D modelling (DELPHIN 6.0, PDF)

Tutorial 8: Editing materials with DELPHIN 6.1

In this tutorial, the material editor in DELPHIN 6.1 is explained.

    » Tutorial 8 - Material editor (DELPHIN 6.1, PDF, Online)

Further descriptions

Structure and operation of the dialogue for selecting materials from the material database

    » Material database dialog (DELPHIN 6.1.2, PDF, Online)

Description of the generation and assignment of a moisture source for leakages according to WTA 6.2 or DIN 4108-3

    » WTA leakage moisture source (DELPHIN 6.1.3, PDF, Online)

Description of the generation and assignment of contact conditions for vapor retarders

    » Contact conditions (DELPHIN 6.1.6, PDF, Online)

 

Special Topics/Howtos

With different methods it is possible to use DELPHIN even more efficiently than it can be done by simply using the user interface. A few ideas are presented in the Howtos below.

Automatic Variation and Sensitivity Studies
or Scripting with DELPHIN and Python

In this Howto we show the use of simple Python scripts (a very easy-to-learn script programming language) for automatic processing of many simulations for more efficient calculations. It is shown how modern multi-processor machines can be utilised and a number of scheduled simulations can be distributed on different processors. There are two tutorials, one for DELPHIN 6 and one for the older DELPHIN 5 - the principle is pretty much the same, yet the procedure and scripts are slightly different.

    » Scripting Tutorial (DELPHIN 6, PDF, english)
    » Scripting Tutorial (DELPHIN 6, webpage, english)


    » Python-DELPHIN-Scripting Howto (PDF, english)

FMI Co-Simulation with DELPHIN (FMI-Export)

... under development.

Using the Wave-Form-Relaxation method for co-simulation between heat collector model (DELPHIN) and controlled heat exchanger (Python)

In this Howto we show the use of simple Python scripts for runtime coupling of a detailed DELPHIN model with an simple control model. This procedure is applicable when FMI Co-Simulation is not possible (due to limitations of the other model/software).

    » DELPHIN-WRM Co-Simulation Howto (PDF, deutsch)
    » DELPHIN-WRM Python Scripts (7z archive)

 

(Auf Hintergrund klicken, um zu schließen)