Provided by: survex_1.4.13-2_amd64 ![bug](/img/bug.png)
![bug](/img/bug.png)
NAME
dump3d - text dump of processed survey data file
SYNOPSIS
dump3d [--survey=SURVEY] [--rewind] [--show-dates] [--legs] INPUT_FILE
DESCRIPTION
Dump out the entries in a processed survey data file - useful for debugging, and also provides a textual format which is fairly easy to parse if you want to write a simple script to pull out information from such files. Don't be mislead by the "3d" in this tool's name - it can be used to dump a file in any format the "img" library can read, so it works with Survex .3d and .pos files, Compass .plt and .plf files, CMAP .sht, .adj and .una files. If you're parsing the output in a script, you may want to use option -legs so you get a LEG item for each leg with from and to coordinates instead of each traverse being a MOVE item followed by a series of LINE items. The --show-dates option uses . as the separator between date components by default (e.g. 2024.12.01), but (since Survex 1.4.13) you can specify a different separator. If this separator is . then - is used between two dates which form a range, otherwise a space is used. For convenience, -D is provided as a short-cut for --show-dates=- which outputs dates in the ISO date format. (The --rewind option is only provided to allow debugging and testing the img_rewind() function.)
OPTIONS
-s, --survey=SURVEY only load the sub-survey with this prefix -r, --rewind rewind file and read it a second time -d, --show-dates[=SEPARATOR] show survey date information (if present) -D equivalent to --show-dates=- -l, --legs convert MOVE and LINE into LEG --help display short help and exit --version output version information and exit
SEE ALSO
aven(1), cavern(1), diffpos(1), extend(1), sorterr(1), survexport(1)
COPYRIGHT
1998-2024 Dec 01, 2024 DUMP3D(1)