NAME

       cavern - process raw survey data

SYNOPSIS

       cavern [ options ] survex data file ...

DESCRIPTION

       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.

OPTIONS

       -o, --output=OUTPUT
              Sets location for output files.

       -q, --quiet
              Only show a brief summary (--quiet --quiet or -qq will display warnings and errors only).

       -s, --no-auxiliary-files
              do not create .err file.

       -w, --warnings-are-errors
              turn warnings into errors.

       --log  Send screen output to a .log file.

       -v, --3d-version
              Specify the 3d file format version to output.  By default the latest version is written,  but  you
              can  override this to produce a 3d file which can be read by software which doesn't understand the
              latest 3d file format version.  Note that any  information  which  the  specified  format  version
              didn't support will be omitted.

OUTPUT

       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  then  the  files
       entrance.3d and entrance.err will be created.

       Cavern also gives a range of statistics at the end of a successful run:

       • The highest and lowest stations and the height difference between them

       • The  total length of the survey (before and after adjustment).  This total excludes survey legs flagged
         as SURFACE, DUPLICATE, or SPLAY.

       • The number of stations and legs.  Note that a *EQUATE is counted as a leg in this statistic.

       • The East-West and  North-South  ranges,  and  the  North-most,  South-most,  East-most,  and  West-most
         stations.

       • The  number of each size of node in the network (where size is number of connections to a station) i.e.
         a one node is the end of a dead-end traverse, a two-node is a  typical  station  in  the  middle  of  a
         traverse, a three-node is a T-junction etc.

       • How long the processing took and how much CPU time was used.

   .3D - DATA DESCRIBING THE LOOP-CLOSED CENTRE LINE
       This file contains details of the stations and legs, and any flags associated with them.

   .ERR - LOOP CLOSURE STATISTICS (%AGE ERRORS, ETC)
       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.

ERROR MESSAGES

       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.

SEE ALSO

       aven(1), diffpos(1), dump3d(1), extend(1), sorterr(1), survexport(1)

                                                 09 January 2019                                       CAVERN(1)