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
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
|
<!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>survexport — 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="survexport">
<h1>survexport<a class="headerlink" href="#survexport" 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">survexport</span></code> [<cite>OPTIONS</cite>] <cite>INPUT_FILE</cite> [<cite>OUTPUT_FILE</cite>]</p>
</div></blockquote>
</section>
<section id="description">
<h2>DESCRIPTION<a class="headerlink" href="#description" title="Link to this heading">¶</a></h2>
<p>The input formats supports are all those supported by Survex’s “img”
library - Survex .3d, Survex .pos, Compass PLT and CMAP XYZ files.</p>
<p>Currently the output formats supported are CSV, DXF, EPS
(Encapsulated PostScript), GPX, HPGL for plotters, JSON, KML, Survex
POS files, and SVG.</p>
<p>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.</p>
<section id="pos-format">
<h3>POS Format<a class="headerlink" href="#pos-format" title="Link to this heading">¶</a></h3>
<p>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) <code class="docutils literal notranslate"><span class="pre">3dtopos</span></code> tool.
Since Survex 1.2.19 it can be generated by <code class="docutils literal notranslate"><span class="pre">survexport</span></code> or by <code class="docutils literal notranslate"><span class="pre">aven</span></code>’s
export feature.</p>
<p>The header line is translated to the user’s language, but always starts with
<code class="docutils literal notranslate"><span class="pre">(</span></code> and ends with <code class="docutils literal notranslate"><span class="pre">)</span></code>.</p>
<p>While not a requirement of the format, in <code class="docutils literal notranslate"><span class="pre">.pos</span></code> files created by Survex
the stations are sorted by name such that numbers occur in the correct order
(so <code class="docutils literal notranslate"><span class="pre">2</span></code> before <code class="docutils literal notranslate"><span class="pre">10</span></code>). 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:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>040.sv8
040.sv8a
040.sv8b
040.sv8c
040.sv9
040.sv10
040.sv11
40_entrance_tag
40b_entrance_tag
</pre></div>
</div>
</section>
<section id="dxf-format">
<h3>DXF Format<a class="headerlink" href="#dxf-format" title="Link to this heading">¶</a></h3>
<p>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.</p>
</section>
</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">--scale=</span></code><cite>SCALE</cite></dt><dd><p>scale (<code class="docutils literal notranslate"><span class="pre">50</span></code>, <code class="docutils literal notranslate"><span class="pre">0.02</span></code>, <code class="docutils literal notranslate"><span class="pre">1:50</span></code> and <code class="docutils literal notranslate"><span class="pre">2:100</span></code> all mean 1:50)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--bearing=</span></code><cite>BEARING</cite></dt><dd><p>bearing (<code class="docutils literal notranslate"><span class="pre">90</span></code>, <code class="docutils literal notranslate"><span class="pre">90d</span></code>, <code class="docutils literal notranslate"><span class="pre">100g</span></code> all mean 90°)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--tilt=</span></code><cite>TILT</cite></dt><dd><p>tilt (<code class="docutils literal notranslate"><span class="pre">45</span></code>, <code class="docutils literal notranslate"><span class="pre">45d</span></code>, <code class="docutils literal notranslate"><span class="pre">50g</span></code>, <code class="docutils literal notranslate"><span class="pre">100%</span></code> all mean 45°)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--plan</span></code></dt><dd><p>plan view (equivalent to <code class="docutils literal notranslate"><span class="pre">--tilt=-90</span></code>)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--elevation</span></code></dt><dd><p>elevation view (equivalent to <code class="docutils literal notranslate"><span class="pre">--tilt=0</span></code>)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--legs</span></code></dt><dd><p>underground survey legs</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--surface-legs</span></code></dt><dd><p>surface survey legs</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--splays</span></code></dt><dd><p>splay legs</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--crosses</span></code></dt><dd><p>station markers</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--station-names</span></code></dt><dd><p>station labels</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--entrances</span></code></dt><dd><p>entrances</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--fixes</span></code></dt><dd><p>fixed points</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--exports</span></code></dt><dd><p>exported stations</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--cross-sections</span></code></dt><dd><p>cross-sections</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--walls</span></code></dt><dd><p>walls</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--passages</span></code></dt><dd><p>passages</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--origin-in-centre</span></code></dt><dd><p>origin in centre</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--full-coordinates</span></code></dt><dd><p>full coordinates</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--clamp-to-ground</span></code></dt><dd><p>clamp to ground</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--defaults</span></code></dt><dd><p>include items exported by default</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-g</span></code>, <code class="docutils literal notranslate"><span class="pre">--grid</span></code>, <code class="docutils literal notranslate"><span class="pre">--grid=</span></code><cite>GRID</cite></dt><dd><p>generate grid with spacing <code class="docutils literal notranslate"><span class="pre">GRID</span></code> metres (default <code class="docutils literal notranslate"><span class="pre">100</span></code>)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-t</span></code>, <code class="docutils literal notranslate"><span class="pre">--text-height=</span></code><cite>TEXT_HEIGHT</cite></dt><dd><p>station labels text height (default <code class="docutils literal notranslate"><span class="pre">0.6</span></code>)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-m</span></code>, <code class="docutils literal notranslate"><span class="pre">--marker-size=</span></code><cite>MARKER_SIZE</cite></dt><dd><p>station marker size (default <code class="docutils literal notranslate"><span class="pre">0.8</span></code>)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--csv</span></code></dt><dd><p>produce CSV output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--dxf</span></code></dt><dd><p>produce DXF output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--eps</span></code></dt><dd><p>produce EPS output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--gpx</span></code></dt><dd><p>produce GPX output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--hpgl</span></code></dt><dd><p>produce HPGL output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--json</span></code></dt><dd><p>produce JSON output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--kml</span></code></dt><dd><p>produce KML output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--plt</span></code></dt><dd><p>produce Compass PLT output for Carto</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--pos</span></code></dt><dd><p>produce Survex POS output</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--svg</span></code></dt><dd><p>produce SVG output</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">
©1998-2025.
|
Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.1.3</a>
& <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
</div>
</body>
</html>
|
