
      This file explains each Fatal and Warning message you may get when
running a simulation. Also it's quite possible to obtain errors in which
Kintecus can't catch.

Some errors list the line to screen and the source line. The source line is
the actual line number in the original file that is giving Kintecus trouble.
If you have many warnings/errors that scroll by on the computer screen too
fast you can pause the listing by pressing the Pause/Break key and resuming
by pressing the Enter key, or you can output everything that normally goes to
the screen to a file by using redirection such as:
Kintecus -show -PARM:C/FL/P1.TXT  > View.txt .
All screen output can be seen in the file view.txt using a text editor.

[ Errors That Can Not Be Caught by Kintecus ]
============================================================================

These are errors that are displayed by the operating system or errors that
cause Kintecus to 'Hang'. 

'Hanging'
**********

Kintecus just stops and does nothing, you can't quit the program.

To eliminate most of them, IT IS VERY IMPORTANT THAT THE VERY LAST LINE OF
ALL THE INPUT FILES HAVE A CARRIAGE RETURN (Press the ENTER key)! The Model
Spreadsheet, the Species Description Spreadsheet, the Parameter Spreadsheet
and the Species Name Spreadsheet should all end with END + Carriage Return.
It is possible for Kintecus to detect the end of a file has been reached
without the explicit END at the end, but strangely there are a few occasions
when it won't 'see' it and the program hangs. Also make sure if you have any
concentration profile files that the last line that has a number on it has a
Carriage Return and only one carriage return.  You should be able to see what
file is causing Kintecus to hang by following the screen output on where
Kintecus is in reading and parsing files.


Overflows, Underflows, Division by Zero, Singularities
******************************************************
Kintecus quits and reports some error with one of the above following words.

To eliminate these errors:
Make sure you entered in the initial concentrations for relevant reactants.
If all the reactants have an initial concentration of zero then this will
cause problems. 
If you are sure you've done that than it's very likely you have a very stiff
system of reactions so you must first make sure the value in the Minimum
Integration Field has a value of 1 x 10(-9) or smaller then decrease the
number in the Accuracy field in the Parameter Spreadsheet file. Decrease it
by ten and try again, keep trying until the Accuracy is around 1 x 10(-14).
If you still get errors, it's likely that your system of reactions is not
mass or charge balance. Try to eliminate any mass or charge balance warnings.
If you did and you still have these errors, make sure your equations make
sense, i.e. A==> A is a meaningless reaction.
If your reaction scheme consists of hundreds to thousands of reactions you 
could be experiencing large roundoff error, try using the analytically 
calculated Jacobians by using the -anjac program switch. The -anjac switch 
used on the command line will force Kintecus to calculate Jacobians 
analytically instead of trying to approximate it by finite difference.


[ Fatal Errors ]
============================================================================

      These severe errors when encountered will not allow the simulation
to run. These errors must be corrected.

Fatal Error #1
**************
No data fields in (filename).
Make sure data delimiters (comma, TAB, etc.) are'
in (filename)  and/or the correct data delimiter is'
set. If you haven't set it, then by default a TAB'
is used to separate fields.
Use the -d option to change this (Type Kintecus ?).
 
Explanation:

Kintecus will try to figure out what data delimiter you are using. It will
try TABS, commas, semi-colons, colons and '|'. If you are not using any of
those characters to delimit your data please do so. Do not use a space to
delimit your data! 


Fatal Error #2
**************

'ERROR!, MORE THAN ### COLUMNS OF DATA IN '
  (filename)

Explanation:

You are using a data delimiter which is part of the field data.
You can not use TABS, commas, semi-colons, colons and '|' as part of a field,
these characters are only used for data delimiters. Do not use a space to
delimit your data! 
  
Fatal Error #3
**************

 
NO DATA DELIMITERS FOUND IN (filename)
Make sure data delimiters (comma, TAB, etc.) are'
in (filename) and/or the correct data delimiter is'
set. If you haven't set it, then by default a TAB'
is used to separate fields. '
Use the -d option to change this (Type Kintecus ?).'
      
Explanation:

Make sure you are using either a TABS, commas, semi-colons, colons and '|' as
a data delimiter. You can not use a space as a data delimiter.


Fatal Error #5
***************

The hv energy output file (filename)
does not exist. Please correct.'


Fatal Error #6
***************

Too many data items in (filename)
on a line. Make sure the Data Separator in your '
file is a valid ASCII Separator.'


Explanation:

Make sure you are using either a TABS, commas, semi-colons, colons and '|' as
a data delimiter. You can not use a space as a data delimiter. There may be
extra data delimiters accidentally put at the end of the line.


Fatal Error #10
***************
    
Duplicate species found in (filename)
has duplicate! Please correct.'


Explanation:

Get rid of one of the duplicates you entered in.

Fatal Error #11
***************

Concentration profile file:(filename)
 can not be loaded. Please correct.'
    
Fatal Error #14
***************

Ill-formed reaction line in the model description'
file :(filename)
Remember to use ''==>'' to represent ''produces'' 
on a reaction line. Check for other possible errors.'
        

Fatal Error #15
***************

Missing Reactant/Product on reaction line'
in (filename) Please correct.'
        
Fatal Error #21
***************     
 
You have exceeded the maximum number of species'
allowed in this version of Kintecus.'
(Number)

Explanation:

If you need this to be larger, email the author. 
For the disabled shareware version, buy the registered version which allows a
very large amount.
              
Fatal Error #22
***************

You have exceeded the maximum number of reactions'
allowed in this version of Kintecus.'

Explanation:

If you need this to be larger, email the author. 
For the disabled shareware version, buy the registered version which allows a
very large amount.

Fatal Error #23
***************      
               
You have exceeded the maximum number of times a'
species can appear as a reactant/product in each'
reaction in this version of Kintecus.'


Explanation:

If you need this to be larger, email the author. 
For the disabled shareware version, buy the registered version which allows a
very large amount.


Fatal Error #24
*************** 

An illformed reaction line has been found ' 
in (filename) !!'
Remember to place charges on species on the'
right-hand side, i.e. Cl+++ .'   
Remember to use ''==>'' to represent ''produces'' '
on a reaction line. Check for other possible errors.'
  

Fatal Error #29
***************
      
Not a valid species name in (filename)
(invalid species name) 
     
Explanation

You can not use TABS, commas, semi-colons, colons and '|' as characters in
your species names, nor can you use the characters @, ` (under the ~ key), $.


Fatal Errors #30,31,32
**********************


Species description file (filename),

Model description file (filename)
CAN NOT BE FOUND !!!!'
Make sure the file exists and/or is in the correct'
directory. (Usually the same directory as KINTECUS.)'

     
Fatal Error #35
***************

A duplicate reaction has been found!'
'Reaction #'s (Number1) and (Number2)   
 ( Source line numbers (Number3) & (Number4)
 in (filename)
 are duplicates! Please correct or delete.'
    
Explanation:

Get rid of one of the duplicate reaction lines. Goto line (Number3) or
(Number4) and correct the reaction line or delete it.

Fatal Error #36
***************

An ill-formed reaction line has been found!'
Please condense your reactions! '
i.e. for A+A+A=B type 3A=B.' 

Explanation:

You must condense reaction lines that have more than one reactant/product of
the same species!  

Fatal Error #90
***************

There are NO reactions to compute!!!'

Explanation:

Did you accidentally put in an END before all the reaction lines? Remember, a 
#
or a double quote as the very first non-space character on a line will
comment the whole line out. 



[ Warnings ]
===========================================================================

Warnings will not halt a simulation run, but it may lead Kintecus to crashing
or to yield incorrect results or they just waste computer time for Kintecus
to automatically correct. They should be eliminated.


Warning #1
**********

'You can not define ''hv'' and ''M'' as species.'
'These are internal species that have special'
'definitions in Kintecus. Remove ', 
(hv or M) from your species file: (Filename) 
'You DO NOT have to define these species.' 
'(Ignoring line...)' 
       
  
Warning #3
**********

'THE SPECIES: (Species Name)
' DOES NOT EXIST (spelling? or watch your letter 'O' '
' from the numeral zero, '0', or the lowercase' 
'letter ,''l'',and the numeral one, ''1'')'
'in the species containing file: ',
'Adding in the species and initializing all values as 0.'


Explanation:

You have entered in a reaction which has an undefined species in the Species
Description Spreadsheet. You should halt the simulation and append the
created species file (ADDSPEC.TXT) to the end of your Species Description
Spreadsheet and initialize any fields.  


Warning #5
**********

'Applying Steady State Approximation (SSA) to'
(Species Name) is not applicable !'
'Look at your reactions.... (SSA REMOVED....) '

Explanation:

You can only apply a SSA to a species that has both a sink and source. 
i.e. A--> B --> C, Applying an SSA to B is valid, but invalid to C or A. 

Warning #6
**********

'???? Possible error ????:'
'A negative concentration was detected!!!'
'Halt program and re-RUN with MIN.-Interg.=Min. Interg./10 and/or'
'Accuracy=Accuracy/10.'
'Also CHECK YOUR EQUATIONS!!! Do they make sense? '

Explanation:

See "Overflows, Underflows, Division by Zero, Singularities" under the above
section "[  Errors That Can Not Be Caught by Kintecus  ]".

 
Warning #8
**********       
'You are not displaying the output of ANY SPECIES!'
'You will not be able to see the concentration of any'
 'species!!!'                                         
 
You have not entered a single "yes" or "y" on the Display Output ? field of
any of the species in the Species Description Spreadsheet.

 
Warning #9
**********

'One or more left parenthesis are missing for species:'
(Species Name) in your species file: (Filename)   
'any equations containing this species can not be'
'checked for mass balance.'


Explanation: 
You have entered an invalid species name such as CN2)2.
Correct by placing in a left parenthesis, i.e. C(N2)2.


Warning #10
***********
'You have reached the maximum amount of parenthesis'
'nesting in the species , (Species Name)
'in your species file: , (Filename)  
'Expand the inner most parenthesis.'
'Any equations containing this species can not be'
'checked for mass balance.' 

Warning #11
***********

'One or more right parenthesis are missing for species:'
(Species Name),in your species file: , (filename) 
'Any equations containing this species can not be'
'checked for mass balance.'

Explanation: 
You have entered an invalid species name such as C(N22.
Correct by placing in a right parenthesis, i.e. C(N2)2.

Warning #12
***********
      
'The species (SpeciesName)
 can not be mass determined nor does it exist as'
 an entry in your names file:(filename)     
 Any equations containing this species can not be'
 checked for mass balance.'
 
Explanation:
You have entered an invalid Species Name such as OPL or DNA.
If you wish to use such names and still check for mass balance you 
must create a Species Name file containing the name and it's mass. 
      
Warning #13
*********** 
'One or more left parenthesis are missing for '  
 mass formula ,(Mass Formula Shown)
of the name: (Species Common Name)
in your name file: (File Name)  
 any equations containing this species can not be'
 checked for mass balance.

Explanation: 
You have entered an invalid species name such as CN2)2.
Correct by placing in a left parenthesis, i.e. C(N2)2.

Warning #15
***********

One or more right parenthesis are missing for '  
mass formula,(Mass Formula Shown)
of the name:,(Species Common Name)
in your name file: (File Name)  
Any equations containing this species can not be'
checked for mass balance.'

Explanation: 
You have entered an invalid species name such as C(N22.
Correct by placing in a right parenthesis, i.e. C(N2)2.

      
Warning #16
***********

   The mass formula (Mass Formula Shown) of the name: (Common Name Shown) can
not be mass determined in your names file: (File Name)     
Any equations containing this species can not be'
checked for mass balance.

Explanation:
Kintecus can not determine the mass of the (Mass Formula Shown). Please make
sure it's a valid molecular weight or mass.
 
      
Warning #17
***********

Charge conservation is *NOT CONSERVED*'
in reaction # (Number)    
( Source line number (Number) )
This can possibly lead to divergence in the solution!'
'Please correct.'

Warning #18
***********

'Mass conservation is *NOT CONSERVED*'
' in reaction # (Number)
'( Source line number (Number) )'
'This can possibly lead to divergence in the solution!!'
'Please correct.'
      
Warning #19
***********

Mass conservation for reaction # (line)
( Source line number (Source Line) )
can not be determined because one of the species in'
the reaction has either an illegal molecular weight'
or it's name is not located in the name file or'
'a name file has not been created. A name file'
'contains the common name of the species and it's 
'molecular weight such as: Methanol , CH3OH .'
'This can possibly lead to divergence in the solution!!'
'Please correct.'

Warning #20
***********

Parameter description file (filename),
CAN NOT BE FOUND !!!!'
Make sure the file exists and/or is in the correct'
directory. (Usually the same directory as KINTECUS.)'
Using default values:


Explanation:

The parameter description file contains fields that tell Kintecus how long to
run the simulation, the accuracy of the simulation and many other very
important fields (see the Kintecus.doc file for a full description). 
If Kintecus can't find this file it will assume values for all the fields.
Those values are equivalent to the supplied parameter spreadsheet file:
PARMDEF.TX2 which you should copy as PARM.DAT and go over any relevant fields
to your simulation.


END OF TEXT FILE

