cavern [options] survex data file
Cavern is the Survex data processing engine.
If multiple survey data files are listed on the command line, they are processed in order from left to right. Settings are reset to their defaults before processing each file.
Cavern reads in text files containing the survey data
.svx) and outputs two files, with the extensions
.3d and .err.
By default these files are put in the current directory,
with the same base filename as the first .svx file read,
but a different extension.
You can change the directory and/or base filename using the --output
command line option.
E.g. if you process the data file entrance.svx with the command cavern entrance entrance.3d and entrance.err will be created.
Cavern also gives a range of statistics at the end of a successful run:
This file contains details of the stations and legs, and any flags associated with them.
This file contains statistics about each traverse in the survey which is part of a loop. It includes various statistics for each traverse, such as the percentage error per leg. You should study this information to determine if any parts of the survey are of lower quality or contain gross errors.
There are a number of error messages that you may get when processing data. Most of these are self explanatory, and will be caused by such problems as typing mistakes, or by your survey data not being attached to fixed points (in this situation, Survex will list some of the stations that are not connected).
Along with the error message, the filename and line number of the offending line will be printed (or the filename for errors such as `file not found'). The format of the filename and line number is that used by gcc, so if your editor can parse errors from gcc, you should be able to set it to allow you to jump to the file and line of each error.
Cavern will stop after more than 50 errors. This usually indicates something like the incorrect data order being specified. Deluging the user with error messages makes the actual problem less clear.
3dtopos(1), aven(1), cad3d(1), diffpos(1), extend(1), sorterr(1), svxedit(1)