Simulation

#summary How to run the simulation

=Simulation=

Let's say you have correctly defined all conditions of the simulation by reading [Inputs this helpful page]. All you need to do now is import the main algorithm and run it {{{ from hamopy.algorithm import calcul

results = calcul(mesh, clim, init, time) }}}

The rest is [PostProcessing post-processing].

=Options=

The syntax for calling the simulation may be slightly modified for three purposes: choosing the type of output, keeping a record of the simulation process, or simulate thermal transfer only.

==Output type==

The calcul() method normally returns a dictionary storing all necessary data for [PostProcessing post-processing]. Another available option is to save this data into a file in the uncompressed .npz format {{{ from hamopy.algorithm import calcul

calcul(mesh, clim, init, time, output_type = 'file') }}} This will create a file called hamopy_output.npz in the working directory. This method of output selection can be customised by modifying the algorithm module.

==Diary==

Should you encounter convergence difficulties, you may want the algorithm to store its progress somewhere so you may locate the problems. The calcul() method may take an additional argument for this purpose:

{{{ from hamopy.algorithm import calcul

diary = 'D:\file_location\file_name'

results = calcul(mesh, clim, init, time, logfile = diary)

}}}

This will create a file at the specified location, on which the record of the convergence criteria will be saved.

==Thermal transfer only==

The code is initially designed for coupled heat and moisture transfer, but the user may want to skip the humidity and only calculate heat. This is done through an alternate version of the algorithm: {{{ from hamopy.algorithm import calcul_thermo

results = calcul_thermo(mesh, clim, init, time) }}} This should run about 4 times faster than coupled heat and mass transfer.

[Overview Documentation main page]