OnWorks favicon

cavern - Online in the Cloud

Run cavern in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command cavern that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



cavern — process raw survey data


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.


-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


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:

· 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

· 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

3dtopos(1), aven(1), cad3d(1), diffpos(1), extend(1), sorterr(1)


Use cavern online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    ExpressLuke GSI
    ExpressLuke GSI
    This SourceForge download page was to
    grant users to download my source built
    GSIs, based upon phhusson's great
    work. I build both Android Pie and
    Android 1...
    Download ExpressLuke GSI
  • 2
    PyQt is the Python bindings for
    Digia's Qt cross-platform
    application development framework. It
    supports Python v2 and v3 and Qt v4 and
    Qt v5. PyQt is avail...
    Download PyQt
  • 3
    Gambas3* coding tools and examples for
    use in SMB or other organizations that
    make internal programs. E.g. from
    database fields to class sourcecode with
    Download garlic3
  • 4
    Sardi is a complete restyling and
    optimisation of svg code. 6 choices for
    your applications and 10 kind of folders
    to use in your file manager. The sardi
    Download Sardi
  • 5
    LMMS Digital Audio Workstation
    LMMS Digital Audio Workstation
    LMMS is a free cross-platform software
    which allows you to produce music with
    your computer. If you like this project
    consider getting involved in the project
    Download LMMS Digital Audio Workstation
  • 6
    FreeRTOS Real Time Kernel (RTOS)
    FreeRTOS Real Time Kernel (RTOS)
    FreeRTOS is a market-leading real-time
    operating system (RTOS) for
    microcontrollers and small
    microprocessors. Distributed freely
    under the MIT open source lice...
    Download FreeRTOS Real Time Kernel (RTOS)
  • 7
    Avogadro is an advanced molecular
    editor designed for cross-platform use
    in computational chemistry, molecular
    modeling, bioinformatics, materials
    science and ...
    Download Avogadro
  • More »

Linux commands