Configuration File


The config file is in XML format. It is loaded at program startup and contains the specification of all the main parameters, grouped in respective sections. An example syngas.xml file is provided which includes the setup of syngas reaction on the anode side of a high-temperature solid-oxide fuel cell.

The default name of the config file is <progname>.xml, where <progname> is the name of the executable, such as view, job, or remody. One can override the default name by using -f command line option, like:

remody -f syngas.xml


The sections are enclosed in XML tag pairs, like <tag>...</tag>. where the tags are as follows:

  1. specie: includes such parameters as mass in Atomic units [au], size in nanometers [nm], and specific heat, cp in kJ/(mol*K). The specie tag should also include an attribute id, identifying a specie chemical formula, such as CO2, H2O, etc.
  2. reaction: reaction tag has two attributes: reactants and products. The reactants tag should contain two species identifiers. Since only elementary (binary) reactions are considered, there should be exactly two identifiers for reactants. Each of the identifiers should correspond to one specie identifiers listed in the list of species. The products attribute should consist of one or two identifiers of reaction products. Also in the reaction section the following parameters are specified:
    activation = reaction activation temperature in K,
    probability = probability of reaction outcome as given by the products attribute. This parameter should always be 1.0 if there is only one reaction with the given reactants. In case of several reactions with the same reactants, but with different products, this parameter should indicate the probability of this particular branch with given reaction products.
    enthalpy = enthalpy of reaction in kJ/mol.
  1. type: specifies the geometry. Currently only box type is supported.
  2. grid: Specifies parameters of the rectangular grid used in segmentation algorithm for accelerating the interaction scheme. In particular, the cellsize parameter determines the size of the grid cell. This size should be selected as small as possible but no less than twice the size of the largest specie. Decreasing the cell size will speed-up code execution in better than linear proportion of the cell-size (but no better than quadratic). At the same time it will increase memory utilization in proportion to it's 3-rd power. It is not recommended to increase the memory utilization above 90%. One can use Unix 'top' utility to check memory utilization.
  3. energy: Only used for Lennart-Jones type potentials, currently under development.
  4. bounds: specifies spatial bounds of the computational domain as: xmin xmax ymin ymax zmin zmax.
  5. bulk: this section specifies thermodynamic properties and gas composition inside the bulk of the domain. In particular, temperature is given in Kelvin [K], and for each specie, its density is specified in [kg/m^3].
  6. boundary: each boundary of the domain contains the description of thermodynamic properties and gas composition on the other side of the boundary in the same format as for the bulk of the domain. In addition to these, the boundary tag should have the boundary identifier id-attribute, such as "top", "bottom", "right", "left", "front", and "rear". Also additional boundary tag is type, which can be one of: "open", "elastic", and "periodic". In the case of open boundary the molecules can freely cross the boundary, in which case they will be removed from the domain. In case of elastic boundary the molecules will bounce from the boundary like from an elastic wall. For periodic boundaries, the molecules crossing the boundary will reappear from the opposite boundary. Boundary description can also contain the list reactions, between the boundary species given in the same format as in the species section.

  1. translation: initial translation of the scene.
  2. vector: parameters for displaying vectors.
  3. frame: parameters for displaying a domain frame.
  4. mesh: parameters for displaying mesh. In particular the node tag specifies the parameters for displaying particles, or molecules, such as using points or spheres (type), etc. Note that using 'spehere' for type may significantly slow-down simulation in GUI mode.

Generated on Tue May 26 16:10:36 2009 for ReMoDy by  doxygen