Difference between revisions of "Input file"

From MKMCXX
Jump to: navigation, search
(Overview)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
An input contains at least four mandatory sections, which are <code>&compounds</code>, <code>&reactions</code>, and <code>&settings</code> and <code>&runs</code>. In each of these sections, specific instructions for the microkinetic simulation need to be placed which are explained in more detail below. If you want to add comments to the input file, you can do so by placing a <code>#</code> at the beginning of the line. Lines that start with a <code>#</code> or which are empty (i.e. have only white space characters), will be automatically ignored by the parser. Each section starts with a section header, which is simply the section keyword prepended by a <code>&</code>.
+
[[Image:Mkmcxx2.15.3.png]]
 +
 
 +
An input contains at least four mandatory sections, which are <code>&compounds</code>, <code>&reactions</code>, and <code>&settings</code> and <code>&runs</code>. In each of these sections, specific instructions for the microkinetic simulation need to be placed which are explained in more detail below. If you want to add comments to the input file, you can do so by placing a <code>#</code> before the text you want the input parser to ignore. Lines that start with a <code>#</code> or which are empty (i.e. have only white space characters), will be automatically ignored by the parser. Each section starts with a section header, which is simply the section keyword prepended by a <code>&</code>.
  
 
== Compounds ==
 
== Compounds ==
Line 17: Line 19:
 
A;  0;  1.0
 
A;  0;  1.0
 
B;  0;  1.0
 
B;  0;  1.0
A*;  1;  1.0
+
A*;  1;  0.0
B*;  1;  1.0
+
B*;  1;  0.0
 
*;  1;  1.0
 
*;  1;  1.0
<pre>
+
</pre>
  
Each line corresponds to a different compound. The first column is the name of each compound. The second and third columns correspond to whether the compound is a surface site (1=yes, 0=no) and the starting concentration, respectively. It is good practice to also put a <code>*</code> or some other character behind every compound which is a surface site.
+
Each line corresponds to a different compound. The first column is the name of each compound. The second and third columns correspond to whether the compound is a surface site (1=yes, 0=no) and the starting concentration, respectively. It is good practice to also put a <code>*</code> or some other character (but not #) behind every compound which is a surface site.
  
 
== Reactions ==
 
== Reactions ==
 +
<pre>
 +
AR; {A} + {*} => {A*}; 1e8 ; 1e15;  0e3; 100e3
 +
AR; {B} + {*} => {B*}; 1e8 ; 1e15;  0e3; 100e3
 +
AR; {A*}      => {B*}; 1e13; 1e13; 90e3;  90e3
 +
</pre>
  
 
== Settings ==
 
== Settings ==
 +
<pre>
 +
&settings
 +
TYPE = SEQUENCERUN
 +
</pre>
  
 
== Runs ==
 
== Runs ==
 +
<pre>
 +
&runs
 +
600; 1e2; 1e-12; 1e-10
 +
700; 1e1; 1e-12; 1e-10
 +
800; 1e0; 1e-12; 1e-10
 +
</pre>

Revision as of 12:54, 26 March 2020

Overview

Mkmcxx2.15.3.png

An input contains at least four mandatory sections, which are &compounds, &reactions, and &settings and &runs. In each of these sections, specific instructions for the microkinetic simulation need to be placed which are explained in more detail below. If you want to add comments to the input file, you can do so by placing a # before the text you want the input parser to ignore. Lines that start with a # or which are empty (i.e. have only white space characters), will be automatically ignored by the parser. Each section starts with a section header, which is simply the section keyword prepended by a &.

Compounds

For each compound in the system, you need to specify:

  • the name of the compound
  • whether this compound is a surface site or a gas species
  • the starting concentration of the compound

(there is a fourth parameter, called the TDRC flag, but you can ignore this for the time being)

A simple compound header looks as follows:

&compounds
A;  		0;  1.0
B;  		0;  1.0
A*;  		1;  0.0
B*;  		1;  0.0
*;  		1;  1.0

Each line corresponds to a different compound. The first column is the name of each compound. The second and third columns correspond to whether the compound is a surface site (1=yes, 0=no) and the starting concentration, respectively. It is good practice to also put a * or some other character (but not #) behind every compound which is a surface site.

Reactions

AR; {A} + {*} => {A*}; 1e8 ; 1e15;  0e3; 100e3
AR; {B} + {*} => {B*}; 1e8 ; 1e15;  0e3; 100e3
AR; {A*}      => {B*}; 1e13; 1e13; 90e3;  90e3

Settings

&settings
TYPE = SEQUENCERUN

Runs

&runs
600;	1e2;	1e-12;	1e-10
700;	1e1;	1e-12;	1e-10
800;	1e0;	1e-12;	1e-10