Rename cad3d to survexport
[survex.git] / doc / diffpos.sgml
blobad48ccb778ad33b5286c57463e11372496afaa6e
1 <refmeta>
2 <refentrytitle>diffpos</refentrytitle>
3 <manvolnum>1</manvolnum>
4 </refmeta>
6 <refnamediv>
7 <refname>diffpos</refname>
8 <refpurpose>compare the contents of two <filename>.3d</filename> files
9 </refpurpose>
10 </refnamediv>
12 <refsynopsisdiv>
13 <cmdsynopsis>
14 <command>diffpos</command>
15 <arg choice="req">.3d file</arg>
16 <arg choice="req">.3d file</arg>
17 <arg choice="opt">threshold</arg>
18 </cmdsynopsis>
19 </refsynopsisdiv>
21 <refsect1><title>Description</title>
23 <Para>
24 Diffpos reports stations which
25 are in one file but not the other, and also stations which have moved
26 by more than a specified threshold distance in X, Y, or Z. The
27 threshold distance is given in metres and defaults to 0.01m if not
28 specified.
29 </Para>
31 <Para>
32 For backward compatibility diffpos will also read the
33 <filename>.pos</filename> files produced by earlier versions of cavern, by
34 the (now removed) 3dtopos tool, by survexport, or by aven's export feature
35 (requires 1.2.19 or later).
36 </Para>
38 </refsect1>