.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SURVEXPORT" "1" "16 March 2022" "" ""

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

\fBsurvexport\fR [ \fBoptions\fR ] \fB\&.3d file\fR [ \fBoutput file\fR ]

.SH "OPTIONS"
.PP
\fB-s, --survey=SURVEY\fR only load the sub-survey with this prefix
.PP
\fB--scale=SCALE\fR scale (50, 0.02, 1:50 and 2:100 all mean 1:50)
.PP
\fB--bearing=BEARING\fR bearing (90, 90d, 100g all mean 90°)
.PP
\fB--tilt=TILT\fR tilt (45, 45d, 50g, 100% all mean 45°)
.PP
\fB--plan \fR plan view (equivalent to --tilt=-90)
.PP
\fB--elevation\fR elevation view (equivalent to --tilt=0)
.PP
\fB--legs \fR underground survey legs
.PP
\fB--surface-legs\fR surface survey legs
.PP
\fB--splays \fR splay legs
.PP
\fB--crosses \fR station markers
.PP
\fB--station-names \fR station labels
.PP
\fB--entrances \fR entrances
.PP
\fB--fixes \fR  fixed points
.PP
\fB--exports\fR exported stations
.PP
\fB--cross-sections\fR cross-sections
.PP
\fB--walls  \fR walls
.PP
\fB--passages \fR passages
.PP
\fB--origin-in-centre\fR origin in centre
.PP
\fB--full-coordinates\fR full coordinates
.PP
\fB--clamp-to-ground\fR clamp to ground
.PP
\fB--defaults\fR include items exported by default
.PP
\fB-g, --grid[=GRID]\fR generate grid (default 100m)
.PP
\fB-t, --text-height=TEXT-HEIGHT\fR station labels text height (default 0.6)
.PP
\fB-m, --marker-size=MARKER-SIZE\fR station marker size (default 0.8)
.PP
\fB--csv \fR produce CSV output
.PP
\fB--dxf \fR produce DXF output
.PP
\fB--eps \fR produce EPS output
.PP
\fB--gpx \fR produce GPX output
.PP
\fB--hpgl \fR produce HPGL output
.PP
\fB--json \fR produce JSON output
.PP
\fB--kml \fR produce KML output
.PP
\fB--plt \fR produce Compass PLT output for Carto
.PP
\fB--skencil\fR produce Skencil output
.PP
\fB--pos\fR produce Survex POS output
.PP
\fB--svg\fR produce SVG output
.PP
\fB--help\fR display short help and exit
.PP
\fB--version\fR output version information and exit
.SH "DESCRIPTION"
.PP
The input formats supports are all those supported by Survex's "img"
library - Survex .3d, Survex .pos, Compass PLT and CMAP XYZ files.
.PP
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.
.SS "POS FORMAT"
.PP
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.
.PP
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:

.nf
040.sv8
040.sv8a
040.sv8b
040.sv8c
040.sv9
040.sv10
040.sv11
40_entrance_tag
40b_entrance_tag
.fi
.SS "DXF EXPORT"
.PP
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.
.SH "SEE ALSO"
.PP
\fBaven\fR(1),
\fBcavern\fR(1),
\fBdiffpos\fR(1),
\fBdump3d\fR(1),
\fBextend\fR(1),
\fBsorterr\fR(1)