2. System configuration

Setting DAMASK options

Adjust the settings in DAMASK/CONFIG using any text editor, the default values should work on most systems.


Setting shell environment

Depending on your shell, execute one of the following commands to set the DAMASK environment.

  • in bash (default on most Linux systems):
     > source DAMASK/env/DAMASK.sh 

  • in the C-Shell:
     > source DAMASK/env/DAMASK.csh 

  • in the Z Shell:
     > source DAMASK/env/DAMASK.zsh 

Sourcing the file is necessary before compiling or running DAMASK, hence it is recommended to do it automatically when logging in. This can be done by adding the source command to shell initialization files such as .bashrc or .profile located in your home directory.


The script reports system environment settings in part derived from DAMASK/CONFIG. Additionally, it
  • exports the variable $DAMASK_NUM_THREADS according to the settings in DAMASK/CONFIG
  • adds DAMASK/python to $PYTHONPATH such that the damask module can be properly imported in Python
  • adds $DAMASK_BIN to $PATH if necessary and possible
  • sets the limits for stack, heap, virtual memory, and physical memory via ulimit


A few words on memory limits

Please note: If you don't change the stack size, you might experience a stack overflow for large models, especially when using openMP. Should your simulation terminate with a segmentation or memory fault at an early stage this is most likely the reason.

Increase the stack size by using the ulimit command in the parent shell.
  • The easiest way would be to run
    > ulimit -s unlimited
    > ulimit -s hard
    which sets the stack size to unlimited (Linux) or 64 MiB (OS X). If you want a different stack limit, you basically have to try what size is necessary for your model.

  • Another option (for the spectral solver and Intel Fortran only) is to append
    to the COMPILE_OPTIONS in DAMASK/code/makefile with 0x40000000 being an exemplary stack size of 1 GiB.

Determining the optimal stack size is difficult. A good start to read about it is http://software.intel.com/en-us/forums/topic/501500.
Topic revision: r56 - 16 Feb 2020, PhilipEisenlohr

  • News
14 Sep 2020
CMCn2020 & DAMASK user meeting to be hosted at Max-Planck-Institut für Eisenforschung (cancelled)
22 Aug 2020
Release of first preview version of DAMASK 3
19 Feb 2020
DAMASK made it to the Advanved Engineering Materials Hall of Fame
26 Mar 2019
DREAM.3D 6.5.119
(released 2019/03/22) comes with a DAMASK export filter
25 Mar 2019
Release of version v2.0.3
21 Jan 2019
DAMASK overview paper finally published with full citation information available
01 Dec 2018
DAMASK overview paper now online
17 Sep 2018
CMCn2018 & DAMASK user meeting to be hosted at Max-Planck-Institut für Eisenforschung
22 May 2018
Release of version v2.0.2
01 Sep 2016
CMCn2016 & DAMASK user meeting to be hosted at Max-Planck-Institut für Eisenforschung
25 Jul 2016
Release of version v2.0.1
08 Mar 2016
Release of version v2.0.0
22 Feb 2016
New webserver up and running
09 Feb 2016
Migrated code repository from Subversion to GitLab
17 Dec 2014
Release of revision 3813
14 May 2014
Release of revision 3108
02 Apr 2014
Release of revision 3062
16 Oct 2013
Release of revision 2689
15 Jul 2013
Release of revision 2555
15 Feb 2013
Release of revision 2174
13 Feb 2013
Doxygen documentation
16 Dec 2012
Powered by MathJax rendering
23 Nov 2012
Release of revision 1955
15 Nov 2012
Release of revision 1924
01 Nov 2012
Updated sidebar
30 Oct 2012
Significant website updates and content extensions

This site is powered by FoswikiCopyright by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding DAMASK? Send feedback
§ Imprint § Data Protection