|Previous| | |Contents| | |Next|

# Listing caves

When surveying caves in some large area, you often need to generate an up to date list of all caves in that area. In therion dataset, "cave" can be defined in several ways, depending on the level of cave survey.

If you have just surveyed entrance station (e.g. using GPS or standard surveying methods), all you need to do is to assign `entrance` flag using

    station cave-1 "Unsurveyed cave" entrance

If there is some explored passage behind this entrance, but you did not survey it properly, you should add also `continuation` flag and `explored` flag followed by explored length. Explored but unsurveyed passage lengths are also part of summary statistics.

    station cave-2 "Unsurveyed but explored" entrance \
            continuation explored 80m

If you have properly surveyed some cave, its data are usually in some `survey` structure. Survey becomes a cave, if it has main entrance station specified using `-entrance` option. Example:

    survey small_cave -title "Tunnel cave" -entrance 0

If survey contains survey data, but it has no main entrance specified, it is not considered as a cave, just as data organization unit and thus not present in the cave list. Only surveys containing some caves (i.e. entrance stations or surveys with main entrance defined) are present in the final cave list table.

After caves in your data have been properly defined, you can generate table using

    export cave-list -o caves.html

Resulting table looks like this

Title | Length | Depth | Explored | Altitude
--- | --- | --- | --- | ---
Tunnel cave | 25 | 7 |  | 1244.000
Unsurveyed cave |  |  |  | 1234.000
Unsurveyed but explored |  |  | 80 | 1256.000

|Previous| | |Contents| | |Next|