DOKK / manpages / debian 12 / survex-aven / survexport.1.en
SURVEXPORT(1) SURVEXPORT(1)

survexport - convert a processed survey data file (such as a Survex .3d file)to another format.

survexport [ options ] .3d file [ output file ]

-s, --survey=SURVEY only load the sub-survey with this prefix

--scale=SCALE scale (50, 0.02, 1:50 and 2:100 all mean 1:50)

--bearing=BEARING bearing (90, 90d, 100g all mean 90°)

--tilt=TILT tilt (45, 45d, 50g, 100% all mean 45°)

--plan plan view (equivalent to --tilt=-90)

--elevation elevation view (equivalent to --tilt=0)

--legs underground survey legs

--surface-legs surface survey legs

--splays splay legs

--crosses station markers

--station-names station labels

--entrances entrances

--fixes fixed points

--exports exported stations

--cross-sections cross-sections

--walls walls

--passages passages

--origin-in-centre origin in centre

--full-coordinates full coordinates

--clamp-to-ground clamp to ground

--defaults include items exported by default

-g, --grid[=GRID] generate grid (default 100m)

-t, --text-height=TEXT-HEIGHT station labels text height (default 0.6)

-m, --marker-size=MARKER-SIZE station marker size (default 0.8)

--csv produce CSV output

--dxf produce DXF output

--eps produce EPS output

--gpx produce GPX output

--hpgl produce HPGL output

--json produce JSON output

--kml produce KML output

--plt produce Compass PLT output for Carto

--skencil produce Skencil output

--pos produce Survex POS output

--svg produce SVG output

--help display short help and exit

--version output version information and exit

The input formats supports are all those supported by Survex's "img" library - Survex .3d, Survex .pos, Compass PLT and CMAP XYZ files.

Currently the output formats supported are CSV, DXF, EPS (Encapsulated PostScript), GPX, HPGL for plotters, JSON, KML, Survex POS files, Skencil, and SVG. Also survexport can produce Compass .plt files, which are primarily intended for importing into Carto, but can also be used with Compass itself.

The POS format is a Survex-specific format containing a list of stations with coordinates (ordered x,y,z [East, North, Up]) and complete names.

The stations are sorted by name such that numbers occur in the correct order (so ``2'' before ``10''). Numbers with a prefix and/or suffix are sorted by the number part first, so you'd get:

040.sv8
040.sv8a
040.sv8b
040.sv8c
040.sv9
040.sv10
040.sv11
40_entrance_tag
40b_entrance_tag

DXF export separates Splays, Surface legs, Surface points, survey legs, and survey stations onto separate layers. Splays will export dotted, and surface legs dashed. This is not configurable.

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

16 March 2022