Scroll to navigation

DUMP3D(1) Survex DUMP3D(1)

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 --rewind option is only here to allow debugging and testing the img_rewind() function.)

OPTIONS

only load the sub-survey with this prefix
rewind file and read it a second time
show survey date information (if present)
convert MOVE and LINE into LEG
display short help and exit
output version information and exit

SEE ALSO

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

COPYRIGHT

1998-2024

August 14, 2024