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
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
|
<!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>General: How do I? — 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="next" title="Larry Fish’s Compass" href="compass.htm" />
<link rel="prev" title=".svx Cookbook" href="svxhowto.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="general-how-do-i">
<h1>General: How do I?<a class="headerlink" href="#general-how-do-i" title="Link to this heading">¶</a></h1>
<section id="create-a-new-survey">
<h2>Create a new survey<a class="headerlink" href="#create-a-new-survey" title="Link to this heading">¶</a></h2>
<p>You create a text file containing the relevant survey data, using a text
editor, and save it with a suitable name with a <code class="docutils literal notranslate"><span class="pre">.svx</span></code> extension. The easiest
way is to look at some of the example data and use that as a template. Nearly
all surveys will need a bit of basic info as well as the survey data itself:
e.g. the date (<code class="docutils literal notranslate"><span class="pre">*date</span></code>), comments about where, what cave, a name for the
survey (using <code class="docutils literal notranslate"><span class="pre">*begin</span></code> and <code class="docutils literal notranslate"><span class="pre">*end</span></code>), instrument error corrections, etc. Here
is a typical survey file:</p>
<p>All the lines starting with <code class="docutils literal notranslate"><span class="pre">;</span></code> are comments, which are ignored by Survex.
You can also see the use of <code class="docutils literal notranslate"><span class="pre">DOWN</span></code> for plumbs, and <code class="docutils literal notranslate"><span class="pre">*calibrate</span> <span class="pre">tape</span></code> for
dealing with a tape length error (in this case the end of the tape had fallen
off so measurements were made from the 20cm point).</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>*equate chaos.1 triassic.pt3.8
*equate chaos.2 triassic.pt3.9
*begin chaos
*title "Bottomless Pit of Eternal Chaos to Redemption pitch"
*date 1996.07.11
*team "Nick Proctor" compass clino tape
*team "Anthony Day" notes pictures tape
*instrument compass "CUCC 2"
*instrument clino "CUCC 2"
;Calibration: Cairn-Rock 071 072 071, -22 -22 -22
; Rock-Cairn 252 251 252, +21 +21 +21
;Calibration at 161d entrance from cairn near entrance to
;prominent rock edge lower down. This is different from
;calibration used for thighs survey of 5 July 1996
*export 1 2
;Tape is 20cm too short
*calibrate tape +0.2
1 2 9.48 208 +08
2 3 9.30 179 -23
3 4 2.17 057 +09
5 4 10.13 263 +78
5 6 2.10 171 -73
7 6 7.93 291 +75
*begin
*calibrate tape 0
8 7 35.64 262 +86 ;true length measured for this leg
*end
8 9 24.90 - DOWN
10 9 8.61 031 -43
10 11 2.53 008 -34
11 12 2.70 286 -20
13 12 5.36 135 +23
14 13 1.52 119 -12
15 14 2.00 036 +13
16 15 2.10 103 +12
17 16 1.40 068 -07
17 18 1.53 285 -42
19 18 5.20 057 -36
19 20 2.41 161 -67
20 21 27.47 - DOWN
21 22 9.30 192 -29
*end chaos
</pre></div>
</div>
</section>
<section id="organise-my-surveys">
<h2>Organise my surveys<a class="headerlink" href="#organise-my-surveys" title="Link to this heading">¶</a></h2>
<p>This is actually a large subject. There are many ways you can
organise your data using Survex. Take a look at the example
dataset for some ideas of ways to go about it.</p>
<section id="fixed-points-control-points">
<h3>Fixed Points (Control Points)<a class="headerlink" href="#fixed-points-control-points" title="Link to this heading">¶</a></h3>
<p>The <code class="docutils literal notranslate"><span class="pre">*fix</span></code> command is used to specify fixed points (also know as
control points). See the description of this command in the
“Cavern Commands” section of this manual.</p>
</section>
<section id="more-than-one-survey-per-trip">
<h3>More than one survey per trip<a class="headerlink" href="#more-than-one-survey-per-trip" title="Link to this heading">¶</a></h3>
<p>Suppose you have two separate bits of surveying which were done
on the same trip. So the calibration details, etc. are the same
for both, but you want to give a different survey name to the
two sections. This is easily achieved like so:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>*begin
*calibrate compass 1.0
*calibrate clino 0.5
*begin altroute
; first survey
*end altroute
*begin faraway
; second survey
*end faraway
*end
</pre></div>
</div>
</section>
</section>
<section id="add-surface-topography">
<h2>Add surface topography<a class="headerlink" href="#add-surface-topography" title="Link to this heading">¶</a></h2>
<p>Survex 1.2.18 added support for loading terrain data and rendering
it as a transparent surface. Currently the main documentation for
this is maintained as a <a class="reference external" href="https://trac.survex.com/wiki/TerrainData">wiki
page</a> as this allows
us to update it between releases.</p>
<p>This supports loading data in the HGT format that NASA offers SRTM
data in. The SRTM data provides terrain data on a 1 arc-second
grid (approximately 30m) for most of the world.</p>
</section>
<section id="overlay-a-grid">
<h2>Overlay a grid<a class="headerlink" href="#overlay-a-grid" title="Link to this heading">¶</a></h2>
<p>Aven is able to display a grid, but this functionality isn’t
currently available in printouts. You can achieve a similar effect
for now by creating a <code class="docutils literal notranslate"><span class="pre">.svx</span></code> file where the survey legs form a
grid.</p>
<p>If you want to do this, we suggest fixing points at the end of
each grid line and using the <code class="docutils literal notranslate"><span class="pre">NOSURVEY</span></code> data style to add
effectively elastic legs between these fixed points. This is
simpler to generate than generating fake tape/compass/clino legs
and is very fast for cavern to process.
Some tips for doing this</p>
<p>Here’s a small example of a 500mx500m grid with lines 100m apart:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>*fix 0W 000 000 0
*fix 1W 000 100 0
*fix 2W 000 200 0
*fix 3W 000 300 0
*fix 4W 000 400 0
*fix 5W 000 500 0
*fix 0E 500 000 0
*fix 1E 500 100 0
*fix 2E 500 200 0
*fix 3E 500 300 0
*fix 4E 500 400 0
*fix 5E 500 500 0
*fix 0S 000 000 0
*fix 1S 100 000 0
*fix 2S 200 000 0
*fix 3S 300 000 0
*fix 4S 400 000 0
*fix 5S 500 000 0
*fix 0N 000 500 0
*fix 1N 100 500 0
*fix 2N 200 500 0
*fix 3N 300 500 0
*fix 4N 400 500 0
*fix 5N 500 500 0
*data nosurvey from to
0W 0E
1W 1E
2W 2E
3W 3E
4W 4E
5W 5E
0S 0N
1S 1N
2S 2N
3S 3N
4S 4N
5S 5N
</pre></div>
</div>
</section>
<section id="import-data-from-other-programs">
<h2>Import data from other programs<a class="headerlink" href="#import-data-from-other-programs" title="Link to this heading">¶</a></h2>
<p>Survex supports a number of features to help with importing
existing data.</p>
<p>Unprocessed survey data in Compass or Walls format can be processed
directly, and mixed datasets are support to aid combining data from
different projects using different software. This also can help if
you want to migrate data into Survex from another format as you can
leave the existing data in its original format and just use Survex
native format for new data, or if you prefer to convert everything
to Survex native format it can be done in phases.</p>
<p>Processed survey data in Compass or CMAP formats can be viewed in
<code class="docutils literal notranslate"><span class="pre">aven</span></code> and used with any Survex command line tool which takes
processed survey data.</p>
<p>For data in formats without explicit support, you may be able to read the data
by renaming the file to have a <code class="docutils literal notranslate"><span class="pre">.svx</span></code> extension and adding a few Survex
commands at the start of the file to set things up so Survex can read the data
which follows. For example, you can specify the ordering of items on a
line using <code class="docutils literal notranslate"><span class="pre">*data</span></code> (see Survex Keywords above), and you can specify
the characters used to mean different things using <code class="docutils literal notranslate"><span class="pre">*set</span></code> (see
Survex Keywords above).</p>
<p>The <code class="docutils literal notranslate"><span class="pre">ignore</span></code> and <code class="docutils literal notranslate"><span class="pre">ignoreall</span></code> items in the <code class="docutils literal notranslate"><span class="pre">*data</span></code> command are often
particularly useful, e.g. if you have a dataset with LRUD info or
comments on the ends of lines.</p>
</section>
<section id="see-errors-and-warnings-that-have-gone-off-the-screen">
<h2>See errors and warnings that have gone off the screen<a class="headerlink" href="#see-errors-and-warnings-that-have-gone-off-the-screen" title="Link to this heading">¶</a></h2>
<p>When you run Survex it will process the specified survey data
files in order, reporting any warnings and errors. If there are no
errors, the output files are written and various statistics about
the survey are displayed. If there are a lot of warnings or
errors, they can scroll off the screen and it’s not always
possible to scroll back to read them.</p>
<p>The easiest way to see all the text is to use <code class="docutils literal notranslate"><span class="pre">cavern</span> <span class="pre">--log</span></code> to
redirect output to a <code class="docutils literal notranslate"><span class="pre">.log</span></code> file, which you can then inspect
with a text editor.</p>
</section>
<section id="create-an-extended-elevation">
<h2>Create an Extended Elevation<a class="headerlink" href="#create-an-extended-elevation" title="Link to this heading">¶</a></h2>
<p>You can create a simple extended elevation from <code class="docutils literal notranslate"><span class="pre">aven</span></code>, using the
<code class="docutils literal notranslate"><span class="pre">File->Extended</span> <span class="pre">Elevation...</span></code> menu option. This takes the currently
loaded survey file and “flattens” it.</p>
<p>Behind the scenes this runs the <code class="docutils literal notranslate"><span class="pre">extend</span></code> command-line program. This program
offers more powerful features, such as being able to control which way legs are
folded and where loops are broken, but currently these features are only
accessible from the command line (the intention is to allow them to be used
from <code class="docutils literal notranslate"><span class="pre">aven</span></code> in the future).</p>
</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 class="current">
<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 current"><a class="current reference internal" href="#">General: How do I?</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#create-a-new-survey">Create a new survey</a></li>
<li class="toctree-l2"><a class="reference internal" href="#organise-my-surveys">Organise my surveys</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#fixed-points-control-points">Fixed Points (Control Points)</a></li>
<li class="toctree-l3"><a class="reference internal" href="#more-than-one-survey-per-trip">More than one survey per trip</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#add-surface-topography">Add surface topography</a></li>
<li class="toctree-l2"><a class="reference internal" href="#overlay-a-grid">Overlay a grid</a></li>
<li class="toctree-l2"><a class="reference internal" href="#import-data-from-other-programs">Import data from other programs</a></li>
<li class="toctree-l2"><a class="reference internal" href="#see-errors-and-warnings-that-have-gone-off-the-screen">See errors and warnings that have gone off the screen</a></li>
<li class="toctree-l2"><a class="reference internal" href="#create-an-extended-elevation">Create an Extended Elevation</a></li>
</ul>
</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>
<li>Previous: <a href="svxhowto.htm" title="previous chapter"><code class="docutils literal notranslate"><span class="pre">.svx</span></code> Cookbook</a></li>
<li>Next: <a href="compass.htm" title="next chapter">Larry Fish’s Compass</a></li>
</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>
|
