doc/3dtopos.sgml

   1 <refmeta>
   2 <refentrytitle>3dtopos</refentrytitle>
   3 <manvolnum>1</manvolnum>
   4 </refmeta>
   5
   6 <refnamediv>
   7 <refname>3dtopos</refname>
   8 <refpurpose>produce a <filename>.pos</filename> file from a <filename>.3d</filename> file
   9 </refpurpose>
  10 </refnamediv>
  11
  12 <refsynopsisdiv>
  13 <cmdsynopsis>
  14 <command>3dtopos</command>
  15 <arg choice="opt">options</arg>
  16 <arg choice="req">.3d file</arg>
  17 <arg choice="opt">.pos file</arg>
  18 </cmdsynopsis>
  19 </refsynopsisdiv>
  20
  21 <refsect1>
  22 <title>Description</title>
  23
  24 <Para>
  25 3dtopos takes a <filename>.3d</filename> file and produces a <filename>.pos</filename> file which contains a
  26 list of all the stations with coordinates (ordered x,y,z [East, North,
  27 Up]) and complete names.
  28 </Para>
  29
  30 <Para>
  31 The stations are sorted such that numbers occur in the correct order
  32 (so ``2'' before ``10'').  3dtopos even sorts numbers with a prefix
  33 and/or suffix, so you'd get:
  34 </Para>
  35
  36 <screen>040.sv8
  37 040.sv8a
  38 040.sv8b
  39 040.sv8c
  40 040.sv9
  41 040.sv10
  42 040.sv11
  43 40_entrance_tag
  44 40b_entrance_tag</screen>
  45
  46 <Para>
  47 You can also export <filename>.pos</filename> files from aven in versions 1.2.19 and later.
  48 </Para>
  49
  50 </refsect1>