NAME

       survexport - convert a processed survey data file to another format

SYNOPSIS

          survexport [OPTIONS] INPUT_FILE [OUTPUT_FILE]

DESCRIPTION

       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, and SVG.

       Also  survexport  can  produce  Compass  .plt  files,  which  were  primarily intended for
       importing into Carto; the principal author of Carto has sadly died and it seems  Carto  is
       no  longer actively developed, but we've left this support in place in case it is useful -
       the generated files can be used with Compass itself for example, though  they  are  rather
       crudely structured.

   POS Format
       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.  In old versions of  Survex  it  was
       produced  by  the  (now removed) 3dtopos tool.  Since Survex 1.2.19 it can be generated by
       survexport or by aven's export feature.

       The header line is translated to the user's language, but always starts with  (  and  ends
       with ).

       While  not  a  requirement of the format, in .pos files created by Survex 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 prefix as a string, then the number part as
       above, then by the suffix as a string, 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 Format
       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 currently configurable.

OPTIONS

       -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=GRID
              generate grid with spacing GRID metres (default 100)

       -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

       --pos  produce Survex POS output

       --svg  produce SVG output

       --help display short help and exit

       --version
              output version information and exit

SEE ALSO

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

COPYRIGHT

       1998-2024

                                           Aug 14, 2024                             SURVEXPORT(1)