doc/survexport.sgml

   1 <refmeta>
   2 <refentrytitle>survexport</refentrytitle>
   3 <manvolnum>1</manvolnum>
   4 </refmeta>
   5
   6 <refnamediv>
   7 <refname>survexport</refname>
   8 <refpurpose>convert a processed survey data file (such as a <Application>Survex</Application> <filename>.3d</filename> file)
   9 to another format.
  10 </refpurpose>
  11 </refnamediv>
  12
  13 <refsynopsisdiv>
  14 <cmdsynopsis>
  15 <command>survexport</command>
  16 <arg choice="opt">options</arg>
  17 <arg choice="req">.3d file</arg>
  18 <arg choice="opt">output file</arg>
  19 </cmdsynopsis>
  20 </refsynopsisdiv>
  21
  22 <refsect1><title>Description</title>
  23 <!-- FIXME: more info (opts, etc) -->
  24
  25 <para>
  26 The input formats supports are all those supported by Survex's "img"
  27 library - Survex .3d, Survex .pos, Compass PLT and CMAP XYZ files.
  28 </para>
  29
  30 <para>
  31 Currently the output formats supported are
  32 DXF, EPS (Encapsulated PostScript), GPX, HPGL for plotters, JSON, KML,
  33 Survex POS files, Skencil, and SVG.
  34 Also survexport can produce Compass .plt files, which are primarily intended
  35 for importing into Carto, but can also be used with Compass itself.
  36 </para>
  37
  38 <refsect2>
  39 <title>POS Format</title>
  40
  41 <Para>
  42 The POS format is a Survex-specific format containing a
  43 list of stations with coordinates (ordered x,y,z [East, North,
  44 Up]) and complete names.
  45 </Para>
  46
  47 <Para>
  48 The stations are sorted by name such that numbers occur in the correct order
  49 (so ``2'' before ``10'').  Numbers with a prefix and/or suffix are sorted by the
  50 number part first, so you'd get:
  51 </Para>
  52
  53 <screen>040.sv8
  54 040.sv8a
  55 040.sv8b
  56 040.sv8c
  57 040.sv9
  58 040.sv10
  59 040.sv11
  60 40_entrance_tag
  61 40b_entrance_tag</screen>
  62 </refsect2>
  63
  64 </refsect1>