next up previous contents
Next: Matrix class troubles Up: Trouble shooting Previous: Trouble shooting   Contents

General problems

In Tables B.1 and B.2 a number of possible problems and their solutions is given.


Table B.1: Troubleshooting #1
Problem Solution
   
Function FFT not found while linking You have no Veclib library. Change define statements in Makefile. (Run the install script that generates the Makefile again.) Consider adding a (library) routine for FFT to doris, since the internal one is not optimized speedwise.
   
Compilation fails due to int16 problem with var arg in ioroutines.c Change code in ioroutines.c, routine checkrequest, from int16 to int. (e.g. int16 N = va_arg(arglist, int16) $ ->$ int N = va_arg(arglist, int); This happened with redhat 7.0, but not sure if Doris still functions completely correct; It should have no influence on the computations, only on user friendlyness, i.e., warnings if Doris thinks certain steps should not be run.)
   
Compilation fails because compiler cannot find include files Change include files in source (e.g. $ \char93 include <cctype>$ to $ \char93 include <ctype.h>$). Particularly older compilers do not know of the new standard (e.g., cctype).
   
Compilation fails due to strptime (Redhat 7.0?) Remove comment before DEF8 in the Makefile. (i.e.: DEF8 = -D__NO_STRPTIME). (Remove object files with command "make clean" not required). Compile again with command "make".
   
Run script doesn't work at all Check first line of run script. There the interpreter (an executable program) is specified, for example !/bin/ksh. Does this program exist? (test with command: "which ksh"). For redhat 7.0, who doesn't include it in the distribution for some strange reason, search the internet for a public domain ksh (korn shell). (search at "www.google.com" on "+pdksh +download") Is the location correct? (make a symbolic link as root)
   


Table B.2: Troubleshooting #2
Problem Solution
   
Run script doesn't work properly Path not set to bindir (try if command "doris -v" returns version number) or GMT is not installed. Or directory not writable (chmod).
   
Run script: editing option doesn't work properly/not to my liking Use the environment variable EDITOR to specify your preferred editor, for csh, include in your startup file .cshrc for example a line "setenv EDITOR vi"
   
Run script: viewing option doesn't work properly/not to my liking Use the environment variable PAGER to specify your preferred viewer, for csh, include in your startup file .cshrc for example a line "setenv EDITOR vi"
   
Doris crashes at getting the Delft orbits Is getorb installed? Check location of orbdir (Doris input card). Obtain the system command Doris parses from the stdout INFO, repeat it from the command line.
   
Doris gets zero correlation in FINE coregistration. Is path to files correct (in master.res, slave.res)? Compile a debug version of doris and run that to find out what goes wrong.
   
Doris cannot generate postscript while coregistration. Is GMT installed? Check script from prompt by using command that is written as INFO to stdout. Consider using NOPLOT options in Doris input.
   
Script plotoffsets or plotcpm does not work. Read the help by typing plotoffsets at the prompt. View the script in an editor, try to detect the error. adding -x to the first line of the script should echo all commands before execution. Run it without the background option. What awk are you using? We use gawk actually, but it should be standard POSIX. What is the correct syntax for tail? ("-n +6" or "-n+6" or "+6", the tail commands have been removed from the new version)?
   
Doris leaves temporary files in the working directory. This should not happen, but sometimes these files are not removed. If Doris exits normally, these files can be savely removed. If Doris exits with an error, sometimes these files can be used to repair the result files.
   
What is this file CPM_data after FINE coregistration? This ascii file is used to generate plots with GMT.
   
Doris crashes on reading input. Try to find out with the debug version of Doris where it exactly goes wrong. Some cards with optional ON OFF options need one of these specified on some systems.


next up previous contents
Next: Matrix class troubles Up: Trouble shooting Previous: Trouble shooting   Contents
Leijen 2009-04-14