Running CrysMAS in Batch Mode

The batch version of CrysMAS , crysmas_onl, enables you to run simulations using pre-processed input files without employing the graphical user interface (GUI) of CrysMAS . Additionally, some basic post-processing routines are only possible with the online version of CrysMAS , like the profiling of computed values.

A typical application of the CrysMAS batch mode is the usage for a sensitivity analysis with a large number of thermal analysis runs. The performance of the batch mode is normally better than for the CrysMAS with GUI, especially for complex computations like convection simulations.

But of course there are also limitations for the user. For example no numerical parameters like under-relaxation factors or convergence criteria can be defined or changed using the batch version of CrysMAS . All these parameters have to be defined using the GUI version of CrysMAS .

The CrysMAS batch mode is run in a terminal window. The program is called typing the program name crysmas_onl followed by a number of parameters specifying what the user wants to do and defining input and output files. In case that no additional parameters are given by the user, a help text is provided in the terminal window. The same information is obtained by calling the program with the option -h. The help information e.g. for the Linux online version 2.8.04 looks like this (newer versions may change, please check!):

This is the online version of CrysMAS 2.8.04 - i686 Linux version USAGE: crysmas_onl [options] possible options:


Set compress option (to load and save .crys files)


Load file.


Save file.


Interpolate values from file to the present mesh.

-cg -cv -cT -cH -cS -cC -cE

Calculate mesh/view factors/stationary Temperature/Heat flux Displacements and Stress/Convection/Evolution Temperature.



-I [variable name, value, file]

Write the profile of an isoline or Temperature (or T), radial gradient etc.


  • -p <x0, y0, x1, y1>

  • -a

  • -r <y>

Make a linear profile

  • - Set start/end points.

  • - Axial plot start/end point = (0, y_min/max).

  • - Radial plot start/end point = (x_min/max, r).


  • -p <x, y>

  • -f <file>

  • -X

Make list profile

  • - Add point to list.

  • - Use points from file (use tabs and new lines to separate coordinates and points).

  • - Close and save list profile.


  • -r <x0, y0, x1, y1>

  • -f

  • -CT, -CS, <v0, vM>

  • -LT, LS, <V0, vM, n>

  • -X

Prepare PS for printing image

  • - Set image region.

  • - Set image region to full size.

  • - Insert colors for Temperature/Stress (first plot color, then isolines!).

  • - Insert Isolines for Temperature/Stress.

  • - Finish and save ps-file.


  • -i

    • -s

    • -S

Change settings for...

  • - cvonl internals.

    • - Save last results in file before aborting.

    • - Do not save last results before aborting.



Nevertheless, we have to keep in mind that we are dealing with complex numerical techniques, whereby wrong numerical parameters may lead to divergence of the computations. Thus, it is in any case recommended to make at first calculations with the GUI version of CrysMAS to identify the optimal numerical parameters. Afterwards, the user can start to run dozens of thermal analysis cases using the batch mode of CrysMAS .

Example 1

It may seem complex at first glance, but it is actually quite simple.

You want to perform the following tasks:

  • Generate a mesh

  • Compute view factors

  • Save intermediate results

  • Compute the temperature

  • Save the results

Simply type the following information into the command line:

  • crysvun_onl -l VGF_prototype.crys -cg -cv -s viewVGF_prototype.crys -cT -s calc_VGF_prototype.crys

Example 2

Besides running the simulations, the CrysMAS batch mode also offers basic post-processing routines.

You want to perform the following task:

  • Make a profile along the axis of symmetry using an already finished calculation as an input file.

Type the following information into the command line:

  • crysvun_onl -l VGF_prototype.crys -p -a

Example 3

It is also possible to use the interpolation routine of CrysMAS in the batch mode.

You want to perform the following tasks:

  • Interpolate the results of a finished calculation in another file

  • Compute the temperature

  • Save the results

  • Make a linear profile

Type the following information into the command line:

  • crysvun_onl -l VGF_prototype.crys -i finished_calc.crys -cT -s calc_VGF_prototype.crys -p -p 0.01,0.01,0.03,0.03

Example 4

As already mentioned, the standard application of crysvun_onl is the usage of the program for a sensitivity analysis. If you intend to study the influence of the thermal conductivity of a certain material used in his furnace, all you have to do is to prepare the input (.crys) files in which you have changed the material properties using the GUI version of CrysMAS .

The thermal analysis is performed in the batch mode by running a script, reading for instance:

crysvun_onl -l file1.crys -cT -s calc_file1.crys

crysvun_onl -l file2.crys -cT -s calc_file2.crys

crysvun_onl -l file3.crys -cT -s calc_file3.crys