3.2.3. The CKSolnList.txt File

The CKSolnList.txt file allows you to create a detailed filter for the GetSolution file. Table 3.2: Summary of Syntax Rules shows the syntax rules for a CKSolnList.txt file.

Table 3.2: Summary of Syntax Rules

Rule

Description

1

Any text after a # character is considered comments.

2

The following keywords are reserved: VARIABLE, UNIT, SPECIES, VAR, SEN, ROP, FILTER, TOP, BOTTOM, MAX, MIN, ALL, NONE.


The initial section of the file handles variable selections. There are three global selection options:

VARIABLE VAR ALL/NONE - select all variables or none

VARIABLE SEN ALL/NONE - select all sensitivities or none

VARIABLE ROP ALL/NONE - select all rate-of-productions or none

There are also selection options on a per-variable base:

VARIABLE var_name var_flag sen_flag rop_flag

The flags can have three types of value:

0 - there is no data, so can not be selected

1 - is selected already, can be de-selected

3 - is de-selected already, can be selected

These two types of selection options can be used together to make the process more efficient. The example below shows to extract temperature and its sensitivity and NO2 and its rate-of-production but nothing else from a variable:

VARIABLE VAR NONE

VARIABLE SEN NONE

VARIABLE ROP NONE

VARIABLE temperature 1 1 0

VARIABLE NO2 1 0 1

The next section handles unit selections. Each unit choice can be set using:

UNIT var_type unit_choice

An example of variable types and their unit choices are shown below:

Time (sec) (min) (hr)

Distance (cm) (m) (inch) (ft) (mil)

Temperature (K) (C) (F)

A full list of unit choices can be seen in GetSolution help.

The next section handles the filter for top/bottom selection. You can pick the top n or bottom n species, reaction sensitivities, and species rate-of-productions. Only one of the three choices, ALL, TOP n, BOTTOM n, can be selected.

SPECIES ALL/TOP n/BOTTOM n

SEN ALL/TOP n/BOTTOM n

ROP ALL/TOP n/BOTTOM n

The next section handles the filter for species data based on mole fraction. The MAX and MIN specifies the range of mole fraction. The default is MAX = 1.0 and MIN = 0.0.

FILTER MAX max_value

FILTER MIN min_value