File: dump3d.htm

package info (click to toggle)
survex 1.4.17-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 14,268 kB
  • sloc: ansic: 21,446; cpp: 18,495; sh: 5,401; javascript: 831; perl: 755; makefile: 610; python: 83; xml: 35
file content (157 lines) | stat: -rw-r--r-- 8,352 bytes parent folder | download 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
<!DOCTYPE html>

<html lang="en" data-content_root="./">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

    <title>dump3d &#8212; Survex 1.4.17 documentation</title>
    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d1102ebc" />
    <link rel="stylesheet" type="text/css" href="_static/alabaster.css?v=12dfc556" />
    <script src="_static/documentation_options.js?v=91e0adf2"></script>
    <script src="_static/doctools.js?v=9bcbadda"></script>
    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
    <link rel="index" title="Index" href="genindex.htm" />
    <link rel="search" title="Search" href="search.htm" />
   
  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
  

  
  

  </head><body>
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          

          <div class="body" role="main">
            
  <section id="dump3d">
<h1>dump3d<a class="headerlink" href="#dump3d" title="Link to this heading">¶</a></h1>
<section id="synopsis">
<h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Link to this heading">¶</a></h2>
<blockquote>
<div><p><code class="docutils literal notranslate"><span class="pre">dump3d</span></code> [–survey=<cite>SURVEY</cite>] [–rewind] [–show-dates] [–legs] <cite>INPUT_FILE</cite></p>
</div></blockquote>
</section>
<section id="description">
<h2>DESCRIPTION<a class="headerlink" href="#description" title="Link to this heading">¶</a></h2>
<p>Dump out the entries in a processed survey data file - useful for debugging,
and also provides a textual format which is fairly easy to parse if you want
to write a simple script to pull out information from such files.</p>
<p>Don’t be mislead by the “3d” in this tool’s name - it can be used to dump a
file in any format the “img” library can read, so it works with Survex <code class="docutils literal notranslate"><span class="pre">.3d</span></code>
and <code class="docutils literal notranslate"><span class="pre">.pos</span></code> files, Compass <code class="docutils literal notranslate"><span class="pre">.plt</span></code> and <code class="docutils literal notranslate"><span class="pre">.plf</span></code> files, CMAP <code class="docutils literal notranslate"><span class="pre">.sht</span></code>,
<code class="docutils literal notranslate"><span class="pre">.adj</span></code> and <code class="docutils literal notranslate"><span class="pre">.una</span></code> files.</p>
<p>If you’re parsing the output in a script, you may want to use option <code class="docutils literal notranslate"><span class="pre">-legs</span></code>
so you get a <code class="docutils literal notranslate"><span class="pre">LEG</span></code> item for each leg with from and to coordinates instead of
each traverse being a <code class="docutils literal notranslate"><span class="pre">MOVE</span></code> item followed by a series of <code class="docutils literal notranslate"><span class="pre">LINE</span></code> items.</p>
<p>The <code class="docutils literal notranslate"><span class="pre">--show-dates</span></code> option uses <code class="docutils literal notranslate"><span class="pre">.</span></code> as the separator between date components
by default (e.g. <code class="docutils literal notranslate"><span class="pre">2024.12.01</span></code>), but (since Survex 1.4.13) you can specify a
different separator.  If this separator is <code class="docutils literal notranslate"><span class="pre">.</span></code> then <code class="docutils literal notranslate"><span class="pre">-</span></code> is used between two
dates which form a range, otherwise a space is used.  For convenience, <code class="docutils literal notranslate"><span class="pre">-D</span></code>
is provided as a short-cut for <code class="docutils literal notranslate"><span class="pre">--show-dates=-</span></code> which outputs dates in the
ISO date format.</p>
<p>(The <code class="docutils literal notranslate"><span class="pre">--rewind</span></code> option is only provided to allow debugging and testing the
<code class="docutils literal notranslate"><span class="pre">img_rewind()</span></code> function.)</p>
</section>
<section id="options">
<h2>OPTIONS<a class="headerlink" href="#options" title="Link to this heading">¶</a></h2>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">-s</span></code>, <code class="docutils literal notranslate"><span class="pre">--survey=</span></code><cite>SURVEY</cite></dt><dd><p>only load the sub-survey with this prefix</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-r</span></code>, <code class="docutils literal notranslate"><span class="pre">--rewind</span></code></dt><dd><p>rewind file and read it a second time</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-d</span></code>, <code class="docutils literal notranslate"><span class="pre">--show-dates[=SEPARATOR]</span></code></dt><dd><p>show survey date information (if present)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-D</span></code></dt><dd><p>equivalent to –show-dates=-</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-l</span></code>, <code class="docutils literal notranslate"><span class="pre">--legs</span></code></dt><dd><p>convert MOVE and LINE into LEG</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--help</span></code></dt><dd><p>display short help and exit</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--version</span></code></dt><dd><p>output version information and exit</p>
</dd>
</dl>
</section>
</section>


          </div>
          
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="Main">
        <div class="sphinxsidebarwrapper">
<h1 class="logo"><a href="index.htm">Survex</a></h1>








<h3>Navigation</h3>
<ul>
<li class="toctree-l1"><a class="reference internal" href="intro.htm">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="getstart.htm">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="cmdline.htm">Survex Programs</a></li>
<li class="toctree-l1"><a class="reference internal" href="datafile.htm">Survex data files</a></li>
<li class="toctree-l1"><a class="reference internal" href="svxhowto.htm"><code class="docutils literal notranslate"><span class="pre">.svx</span></code> Cookbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="genhowto.htm">General: How do I?</a></li>
<li class="toctree-l1"><a class="reference internal" href="compass.htm">Larry Fish’s Compass</a></li>
<li class="toctree-l1"><a class="reference internal" href="walls.htm">David McKenzie’s Walls</a></li>
<li class="toctree-l1"><a class="reference internal" href="cmap.htm">Bob Thrun’s CMAP</a></li>
<li class="toctree-l1"><a class="reference internal" href="img.htm">Using the img library</a></li>
<li class="toctree-l1"><a class="reference internal" href="maillist.htm">Mailing List</a></li>
<li class="toctree-l1"><a class="reference internal" href="future.htm">Future Developments</a></li>
</ul>

<div class="relations">
<h3>Related Topics</h3>
<ul>
  <li><a href="index.htm">Documentation overview</a><ul>
  </ul></li>
</ul>
</div>
<search id="searchbox" style="display: none" role="search">
  <h3 id="searchlabel">Quick search</h3>
    <div class="searchformwrapper">
    <form class="search" action="search.htm" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>
    </div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>








        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="footer">
      &#169;1998-2025.
      
      |
      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.1.3</a>
      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
      
    </div>

    

    
  </body>
</html>