The program has been written such that it should handle almost any typing error when giving commands and hopefully all errors that result from calculation with erroneous data. When an error is found an error message is displayed that should get you back on track.
The error messages are grouped in the following categories:
COMM Command language errors FORT Fortran interpreter errors I/O Errors regarding input/output MACR Errors related to macros MATH General mathematical errors
KUPL Errors specific to KUPLOT usage
Each error message is displayed together with the corresponding category <cccc> and the error number <numb> in the form: ****CCCC**** Message **** numb ****
More information to a particular error message can be found by typing 'help <cccc> <numb>' where <cccc> is the category and <numb> the error number.
These messages describe application specific errors (here KUPLOT) in contrast to errors concerning the command language handling.
Error : -1
Maximum number of data sets exceeded
There is no space left for a new data set. KUPLOT allows to adjust the maximum number of data sets using the command 'kurv'. It can only be used, if NO data sets are loaded. The product of number of data sets and length of each data set is a fixed number, defined by MAXARRAY in 'kuplot.inc'. If you need more total space, you will have to recompile the program.
Error : -2
Unkown file format
The given file format with the 'load' command is unknown. Check the online help for 'load' for a list of valid file formats.
Error : -3
Maximum number of data sets exceeded
There is no space left for a new data set. KUPLOT allows to adjust the maximum number of data sets using the command 'kurv'. It can only be used, if NO data sets are loaded. The product of number of data sets and length of each data set is a fixed number, defined by MAXARRAY in 'kuplot.inc'. If you need more total space, you will have to recompile the program.
Error : -4
Invalid data set selected
The given data set number is not valid. Try 'show data' for a list of loaded data sets.
Error : -5
Not an ASCII PGM file
The PGM file to be read is not ASCII (Code P2). Currently KUPLOT can only read ASCII PGM files. If you have the 'pbmplus' package installed, use the tool 'pnmnoraw' to convert from binary to ASCII format.
Error : -6
Number of data points exceeds limit
The number of data points exceed the given limit. Check if reducing the number of data sets with the 'kurv' command gives enough space. Otherwise you might want to change the value of MAXARRAY in 'config.f' and recompile the program.
Error : -7
Invalid parameter value entered
The given parameter value like colour, line typ or font id is invalid. Check the online help for the corresponding command for valid parameters.
Error : -8
Use only if NO data set is loaded
The command can only be used, if NO data sets are loaded. Use the command 'rese' and reload the data sets after executing the command.
Error : -9
Too many excluded regions
The number of excluded regions exceeds the upper limit. The number is defined in 'load.f' and the program must be recompiled after changing the value.
Error : -10
Too many major tick marks
The number of major tick marks is too large to be displayed. Use the 'mark' command to adjust the number of tick marks.
Error : -11
Invalid plot device selected
The output device selected is invalid. Check the online help for supported output device types.
Error : -12
No data present to plot
There are no data present to be plotted. You are doing something wrong :-)
Error : -13
Too much points for spline / steps
The number of points for the current data set is too large for 'step' or 'spline' mode. The value is set by MAXSP in the file 'config.f'. The program needs recompiling after the value is changed.
Error : -14
Invalid contour line set selected
An invalid contour line set was selected. The maximum number of contour line sets is specified by MAXHL in the file 'config.f'. The program must be recompiled after the variable was altered.
Error : -15
Invalid frame selected
An invalid frame was selected. Check 'show frames' for the current frame settings.
Error : -16
Invalid X11 screen width entered
The entered screen width is invalid !
Error : -17
Maximum number of frames exceeded
You want more frames than KUPLOT can handle. If you absolutely need more frames, change the setting of MAXFRAME in 'config.f' and re- compile the program.
Error : -18
Invalid RGB colour found
RGB colours must have values between 0.0 and 1.0. The entered value is invalid.
Error : -19
Invalid peak number found
There is no maximum with the specified number. Use the 'smax' command to see a list of found maxima.
Error : -20
No data points in selected area
The area selected for the command contains no points.
Error : -21
Too many maxima found at search
The search routine called by 'smax' has found too many maxima. Try limiting the number by changing the parameter <ifen> (see help for smax). The maximum number is set by MAXMAX in the file 'plot.f' and 'math.f'.
Error : -22
No maxima found
No maxima were found. Try a different setting of the <ifen> parameter (see help for command 'smax') or are there no maxima after all ???
Error : -23
Incompatible data sets for KCAL
The command 'kcal' works only for data sets of the same typ (2d or 3d) and identical size.
Error : -24
Size of res[] array exceeded
The size of the result variable array res[i] is exceeded. The size is defined in 'param.inc'.
Error : -25
Invalid fit function selected
An invalid fit function was selected. Note that not all functions are available for 3D data sets. Check the help entry for 'fit func' for more information.
Error : -26
Invalid fit parameter selected
An invalid fit parameter was selected.
Error : -27
Invalid weighting scheme selected
The selected weighting scheme is invalid. Check the help entry for 'fit wic' for more information.
Error : -28
Invalid annotation number selected
The given annotation number (command 'sann') is not vaild. If you need more annotations, you have to change MAXAN in the file 'kuplot.inc' and recompile KUPLOT.
Error : -29
x or y-range of data set is zero
The x- or y-range of the read 3D file is zero. Check your input file.
These messages describe illegal usage of the command language, such as unknown commands, improper numbers of parameters.
Error : -1
KUPLOT directory not defined
The environment variable KUPLOT was not defined. Check the chapter on installation for your platform for the appropriate definition.
Error : -5
Error in operating system command
The operating system/shell returned an error message. Check the appropriate system manuals for details.
Error : -6
Missing or wrong parameters for command
Either the command needs more parameters than were provided, or the parameters are incorrect. Check the number and type of parameters. Is the sequence of numerical and character parameters correct?
Error : -8
Unknown command
The command interpreter read an unknown command. Check the spelling of the command or check, whether this command is allowed at the current sublevel.
Error : -11
Error in subroutine
More or less a system error message, ignore this message.
Error : -17
Too many parameters
More parameters have been provided than are required by the command. Check the number, and type of parameters supplied, or the occurrence of additional ','.
These messages describe erroneous mathematical calculations and improper usage of control structures (do,if, ...).
Error : -1
Nonnumerical Parameters in expression
The interpreter found a nonnumerical string where a number is expected. If an intrinsic function or a variable was intended, check for missing parentheses.
Error : -2
Unknown Variable
The expression contains a reference to an unknown variable. Check the spelling of the variable. Chapter 3.7.1 of the manual and the help entry "variables" contains a list of allowed variables. Check whether the variable is a read-only variable and was used on the left side of an expression. Some of the variables associated with microdomains are read-only depending of the circumstances!b
Error : -3
Unknown intrinsic function
The expression contains a reference to an unknown intrinsic function. Check the spelling of the function. Chapter 3.7.4 of the general part in the manual and the help entry "functions' contain a complete list of the allowed intrinsic functions.
Error : -4
Division by zero'
An attempt was made to divide by zero. Check the value of the argument and correct the algorithm that calculates the argument.
Error : -5
Square root of negative number
An attempt was made to calculate the square root of a negative argument. Check the value of the argument and correct the algorithm that calculates the argument.
Error : -6
Missing or wrong Parameters for command
Either the function or variable referenced needs more parameters than were provided, or the parameters are incorrect. Check the number and type of parameters. Is the sequence of numerical and character parameters correct?
Error : -7
Argument for asin,acos greater 1
An attempt was made to calculate asin or acos with an argument greater than 1. Check the value of the argument and correct the algorithm that calculates the argument.
Error : -8
Index outside array limits
The index supplied for the variable is outside the limits of this variable. Check the general part for the dimensions of the variables.
Error : -9
Number of brackets is not matching
The number of opening and closing brackets "[" and "]" does not match or is illegally nested with parentheses "(", ")" or other operators. Check the string used in the expression and correct it following the FORTRAN rules.
Error : -10
Index for array element is missing
You have used a string like "i[]", where the opening and closing brackets do not contain any expression. Check the string used in the expression and correct it following the FORTRAN rules.
Error : -11
Number of parentheses is not matching
The number of opening and closing parentheses "(" and ")" does not match or is illegally nested with brackets "[", "]" or other operators. Check the string used in the expression and correct it following the FORTRAN rules.
Error : -12
Expression between () is missing
You have used a string like "()", where the opening and closing parentheses "(" and ")" do not contain any expression. Check the string used in the expression and correct it following the FORTRAN rules.
Error : -13
Wrong number of indizes for array
The number of indices given for the entered parameter is wrong. Check the help entry 'variables' for the proper number of indices.
Error : -14
Index of DO-loop counter is missing
Here the index for the loop counter of a do-loop is missing. Check the online help for the correct syntax of such loops.
Error : -15
Too many commands
The program stores all commands within a control block in an array. The maximum number of commands that can be stored in this array is given by the parameter MAXCOM in file "doloop.inc". The macro or run used more commands than currently allowed by this parameter. Rewrite the macro or list of commands such that less commands are sufficient, or change the value of the parameter and recompile the program.
Error : -16
Too deeply leveled (do,if) construction
The program stores all commands within a control block in an array. The maximum number of levels for this array is given by the parameter MAXLEV in file "doloop.inc". The macro or run used more levels than currently allowed by this parameter. Rewrite the macro or list of commands such that less levels are sufficient, or change the value of the parameter and recompile the program.
Error : -18
Unresolvable condition
An error occurred while trying to calculate the value of an arithmetic or logical expression. Check that there is no illegal operation/division by zero .../ no typing errors, all parentheses are properly matched.
Error : -19
Illegal nesting of control commands
Do loops and/or if constructions have been nested with overlapping segments, missing enddo or endif statements or similar causes. Check for spelling errors on the control statements, and that each control statement is properly terminated by a corresponding enddo or endif statement that is not enclosed within another control block.
Error : -28
Too deeply leveled break command
Illegal use of the break command. The parameter on the break command signals how many block structure levels are to be exited. Check the value of this parameter with regard to the nesting of do-loops and if-blocks.
An error occurred while attempting to read/write from a file
Error : -1
File does not exist
KUPLOT could not find the file. Check the spelling and the path.
Error : -2
Error opening file
KUPLOT could not open a file. The file might be in use by another process.
Error : -3
Error reading file
An error occurred while KUPLOT was reading a file. Check whether the contents of the file is correct.
Error : -4
File already exists
An attempt was made to overwrite an existing file. Rename or delete the file in question.
Error : -5
No such entry in online help
You have tried to obtain help for a string that does not have a matching entry in the help file.
Check the spelling of the string. Are you at the right sublevel? Use the '?' command to get a listing of available help entries.
Error : -6
Unexpected end of file
KUPLOT has encountered the end of a file, but is still expecting data. Check the file(s) involved, to see whether the data are complete or whether erroneous data are present.
Error : -7
Learning sequence already in progress
You have tried to start a learning sequence by ==>'learn' without closing the active learning sequence. Close the current learning sequence by ==> 'lend' before starting to record a new macro.
Error : -8
Nothing learned - no macro written
You did not type any commands since the ==>'learn' command. No commands are written to the macro file. You need to give at least one command before closing a learn sequence.
Error : -9
Error reading user input
An error occurred while reading the last input. Does the string contain any characters where a number is expected, or any control or escape sequences.
These messages describe situations that result from missing macrofiles, missing macro parameters ...
Error : -1
Too many macro parameters given
The number of parameters given on the macro command line is higher than allowed in your installation. The maximum number of parameters allowed is defined by the parameter MAC_MAX_PARA in the file macro.inc. Check the macro command line for any additional "," or rewrite the macro to use less parameters. If necessary adjust the value of the parameter MAC_MAX_PARA and recompile the program.
Error : -12
Macro not found
The file given on the @<name> command does not exist. Check the spelling of <name> and the path.
Error : -13
Macro filename is missing on the command line
The command '@' to execute a macro was called without any macro file name. The file name must start immedately after the "@". Check the '@' command for completeness and blanks after the "@".
Error : -35
Too deeply leveled macros
The maximum level at which macros may be nested is defined in the file macro.inc in the parameter MAC_MAX_LEVEL. Check the nesting of macro file for the level of nesting or possible recursive nesting without proper termination. Rewrite the macros to use less nesting, or change the value of the parameter and recompile the program.
Error : -36
Unexpected EOF in macro file
When KUPLOT finds a '@' command inside a macro, it stores the current macro name, the line number inside the current macro and closes the current macro file. After completion of the new macro, the previous macro is read again up to the position stored. The error message is displayed when an end of file is found before the position is reached. Check whether the macro file was damaged, or accidentally deleted during execution of the nested macro.
Error : -41
Not enough macro parameters given
KUPLOT read a parameter number inside a macro file that is higher than the number of parameters given on the command line of the macro. Check the parameters inside the macro for correct numbering and spelling. Check the number of parameters supplied on the command and check whether any "," is missing between parameters.
General mathematical errors that occurred during the execution of KUPLOT.
Error : -1
Singular Matrix
While trying to calculate the inverse of a matrix, KUPLOT finds a singular matrix. After the 'read' command, check the lattice constants for values equal to zero. After the 'base' or 'rbase' command of the 'microdomain' sublevel, check the matrix given on the command line for singularity.