mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-11-25 16:52:00 +00:00
227 lines
11 KiB
HTML
227 lines
11 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>Handbook - Starting a new Survex file</title>
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
|
</head>
|
|
<body>
|
|
<h2 id="tophead">CUCC Expedition Handbook - New Survex file</h2>
|
|
<h1>Creating a new survex file</h1>
|
|
|
|
<h2>Great, I have discovered a new cave...</h2>
|
|
<p>If you have not come to this page from the sequence starting at <a href="newcave.html">Starting a New Cave"</a> then go and read that first.
|
|
|
|
<div style="width:100%;height:50px;background:#C8E1E2" align="center">
|
|
This page outlines step 3 of the survey production process. Each step is documented separately.<br />
|
|
<!-- Yes we need some proper context-marking here, breadcrumb trails or something.
|
|
Maybe a colour scheme for just this sequence of pages
|
|
-->
|
|
<a href="newcave.html">1</a>
|
|
- <a href="newwallet.html">2</a>
|
|
- <a href="newsurvex.html">3</a>
|
|
- <a href="drawup.htm">4</a>
|
|
- <a href="newrig.html">5</a>
|
|
- <a href="caveentry.html">6</a>
|
|
- <a href="ententry.html">7</a>
|
|
- <a href="cavedescription.html">8</a>
|
|
</div>
|
|
<h2>Process</h2>
|
|
<p>In principle you do not need any software other than a text editor to create a survex file.
|
|
So you do not need to have installed survex on your laptop at this point.
|
|
</p>
|
|
|
|
<h4 >Two ways to type in survex data</h3>
|
|
<ul>
|
|
<li>Either you can create a new file and use a text-editor on the <em>expo laptop</em>, as described immediately below,
|
|
<li>Or you can use the online system using a web browser from any computer anywhere. This is much, much easier. To do this you need to
|
|
be somewhat confident of the name (the 'surveytrip' id) you will be using. Instructions are
|
|
<a href="#onlinesvx">at the bottom of this page</a>. <br>[This capability has been broken for many years. It is now fully restored in 2020.]
|
|
</ul>
|
|
|
|
<div class="onleft">
|
|
<figure>
|
|
<a href="/survexfile/caves-1623/204/midlevel/110_bidet.svx">
|
|
<img src="notex.jpg" width="700px"></a>
|
|
<figcaption style="font-variant-caps: small-caps;">
|
|
<em>Typical raw survex data - 'bidet' in Steinbrückenhöhle, Martin Green 14/8/2000</em>
|
|
</figcaption>
|
|
</figure>
|
|
</div>
|
|
|
|
<h3 id="survexformat">Typing in the survey data in survex format</h3>
|
|
|
|
|
|
|
|
<p>The survey data typed up must include all the notes, including station details and passage
|
|
names. Make a backup copy to another machine or USB stick as soon as you have typed it in.
|
|
|
|
New users will be using the expo laptop to create the .svx file and
|
|
you will put it in the folder
|
|
<pre>
|
|
/home/expo/loser/caves-{area}/{cave}/{surveytripid}.svx
|
|
</pre>
|
|
example:
|
|
<pre>
|
|
/home/expo/loser/caves-1623/264/mongolrally.svx
|
|
</pre>
|
|
and tell someone nerdy when you have finished and they will
|
|
ensure that it is <em>saved, committed, </em>and<em> pushed</em> appropriately to the :loser: repo.
|
|
<p>If you have several parts of the cave surveyed on one trip, create several distinct .svx files.
|
|
<ul>
|
|
<li><a href="/expofiles/documents/surveying/survex-guide.pdf">How to create a survex file</a> - PDF - Brendan's guide.
|
|
<li><a href="getin.htm">From muddy book to survex plot</a> - the survex file format (to be revised)
|
|
<li><a href="qmentry.html">How to add QM data and cave descriptions</a> - and why this is vital
|
|
<li><font color=red>[survex software docm.]</font> <a href="https://survex.com/docs/manual/svxhowto.htm">Contents of .svx files</a> - How do I?
|
|
<li><font color=red>[survex software docm.]</font> <a href="https://survex.com/docs/manual/genhowto.htm">How do I Create a new survey</a> - example with several surveys joined
|
|
<li><font color=red>[survex software docm.]</font> <a href="https://survex.com/docs/manual/datafile.htm">Survex data files</a> - all the sections and keywords explained
|
|
<li><font color=red>[tunnel software docm.]</font> <a href="/expofiles/tunnelwiki/wiki/pages/File_Formats.html">Survex data files</a> - introduction and explanation
|
|
</ul>
|
|
|
|
<p>Once you have created the .svx file you will run survex to check that your format is correct without typos
|
|
and to generate a centre line. Then you will print the survey line,
|
|
manually transcribe your sketches from the wallet notes onto that paper,
|
|
scan it again and then use that scanned image to digitise passage layout into tunnel or therion.
|
|
|
|
<ul>
|
|
<li><a href="athome.htm">Back in the UK</a> - not really part of the process
|
|
<li><a href="/expofiles/presentations/cave_surveying_20130626.pdf">Cave Surveying - training course slidepack</a>
|
|
<li><a href="../survexhistory96.htm">History of Survex (1996)</a></li>
|
|
</ul>
|
|
|
|
<p>[Nerds: survex cave data belongs in the <a href="../computing/repos.html">repository</a> :loser: so e.g.
|
|
:loser:/caves-1623/264/mongolrally.svx". We are assuming that normal users have never
|
|
worked with an distributed version control system at this point which is why we are only
|
|
telling them to use the <em>expo laptop</em>.]
|
|
|
|
<h3><a id="tickqm">Entering the QM data</a></h3>
|
|
<p>
|
|
QMs are the unexplored leads, they are Question Marks because we don't
|
|
know where they go to. There is a specific format for recording them in survex files.
|
|
</p>
|
|
<p>
|
|
Read this <a href="qmentry.html">separate description</a> about
|
|
entering the QM data into a survex file.
|
|
</p>
|
|
|
|
<h3><a id="tickingoff">Entering the cave description in the survex file</a></h3>
|
|
<p>The last part of the survex file is a description of the passage surveyed. Remember
|
|
that this is intended to be read by people
|
|
<em>who have not been to that bit of the cave themselves</em>
|
|
<code>
|
|
;------------<br />
|
|
;Cave description ;(leave commented-out)<br />
|
|
; See 2017 description for details of GSH up to the 'p50'.
|
|
Briefly, on the way to couldashouldawoulda a 22 m entrance crawl from the
|
|
surface leads to a climb down and a junction. Left leads to easy c
|
|
rawling passage for a short distance, then another junction where
|
|
traversing over a shallow hole and down a stooping-height sandy
|
|
passage to a sharp left turn and a sandy, easy 'squeeze' leading to a
|
|
straighforward p10.
|
|
</code>
|
|
[from <a href="/survexfile/caves-1623/2017-cucc-24/couldashouldawoulda_to_bathdodgersbypass.svx"><em>couldashouldawoulda_to_bathdodgersbypass.svx</em></a>]
|
|
</p>
|
|
<p>
|
|
Note that the description is often written as one long line. Use the word-wrap capability in your editor
|
|
to make it easier for yourself.
|
|
See more detail in the <a href="cavedescription.html">Cave Description"</a> handbook page which also describes eventual HTML publication.
|
|
|
|
<div >
|
|
<figure>
|
|
<a href="../i/wolfhohle_1983-08-08.jpg">
|
|
<img src="../t/wolfhohle_1983-08-08.jpg" ></a>
|
|
<figcaption style="font-variant-caps: small-caps;">
|
|
Wolfhöhle raw survey data 1983 - Austrian mud (click to enlarge)
|
|
</figcaption>
|
|
</figure>
|
|
</div>
|
|
|
|
|
|
<h3><a id="onlinesvx">Using the direct online system</a></h3>
|
|
<p>This is where you type up the hand-scrawled notes directly into a a web browser, creating a new online survex file automatically in the right place on the online system.
|
|
<p>Having confirmed the right name to use for your cave, including whether it is in area 1623 or 1626, e.g.
|
|
<pre>
|
|
caves-1623/2050-cucc-01/easybimble.svx
|
|
</pre>
|
|
open a web browser on the equivalent page
|
|
<pre>
|
|
http://expo.suvex.com/survexfile/caves-{area}/{cave}/{surveytripid}.svx
|
|
</pre>
|
|
where {area} will be 1623 or 1626, and for a new discovery, {cave} will be something like 2050-BH-01 if it is the third cave disovered by
|
|
Dr. Bunsen Honeydew on the 2050 expo, e.g.
|
|
<pre>
|
|
<a href="/survexfile/caves-1623/2050-BH-03/easybimble.svx">/survexfile/caves-1623/2050-BH-03/easybimble.svx</a>
|
|
</pre>
|
|
and a survex-file editing page will open, pre-populated with an example template
|
|
for survex data, most of which you will delete and replace. Edit this template and type in your own data.
|
|
<p>You can save your work by pressing the "Save this edited svx file" button, but it
|
|
will refuse to save until you have hand-edited out all the template material in [square brackets].
|
|
<p>As you edit it, you can
|
|
press the "Differences between edited and saved versions of this file" and the differences which
|
|
comprise your recent typing will be listed below the edit window.
|
|
<p>Before you finish typing, use the third button "Run 'cavern' on this file".
|
|
<br>
|
|
- If you haven't yet removed all the [square brackets] stuff, nothing will happen except a message
|
|
<pre> SAVE FILE FIRST</pre>
|
|
below the edit window.
|
|
<br>
|
|
- If you try to save before editing out the [square brackets] stuff then you wil get a message
|
|
<pre> Error: remove all []s from the text. They are only template guidance.
|
|
</pre> below the editing window.
|
|
<br>
|
|
- But if you have done all that, then survex will process your new survex file and tell you interesting things about
|
|
your survey data below the editing window. ('<a href="https://survex.com/docs/manual/cavern.htm">cavern</a>' is the
|
|
survex engine which we use to process survex files.)
|
|
|
|
<p style="margin:4%">
|
|
<em>Technical Note:</em> When the survex file is saved, it is being saved to the permanent store on the expo file
|
|
server. It is also being automatically registered in the version control system [or will be, if Philip & Wookey get
|
|
their act together March 2022]. So don't worry about losing data. A super-nerd can always recover it (not a job for an ordinary nerd though).
|
|
|
|
<h4>Understanding the messages</h4>
|
|
<p>You may see a number of error messages below the editing window: <em>read them and understand them</em>. If you
|
|
don't understand them, <em>ask someone</em>.
|
|
|
|
<p>So using the online system gives you a very, very easy way of syntax-checking your data entry and
|
|
typing up your notes.
|
|
|
|
<p>The output you get from 'cavern' will look like this (yes this really does take less than 0.01s):
|
|
<pre>
|
|
LOGMESSAGES
|
|
Survey contains 21 survey stations, joined by 23 legs.
|
|
There are 3 loops.
|
|
Total length of survey legs = 305.80m ( 305.79m adjusted)
|
|
Total plan length of survey legs = 253.09m
|
|
Total vertical length of survey legs = 125.24m
|
|
Vertical range = 44.74m (from galactica.1 at 0.35m to galactica.20 at -44.39m)
|
|
North-South range = 99.31m (from galactica.19 at 28.14m to galactica.12 at -71.17m)
|
|
East-West range = 53.27m (from galactica.1 at 1.12m to galactica.9 at -52.15m)
|
|
3 1-nodes.
|
|
13 2-nodes.
|
|
3 3-nodes.
|
|
2 4-nodes.
|
|
CPU time used 0.00s
|
|
</pre>
|
|
<h4>Folders and subfolders</h4>
|
|
<p>If you have a complex cave like 204 or 161 with many separate exploration zones then you can put subfolder names in the
|
|
URL bar e.g.
|
|
<pre>
|
|
<a href="/survexfile/caves-1623/2050-BH-03/murderalley/killerclimb/easybimble.svx">survexfile/caves-1623/2050-BH-03/murderalley/killerclimb/easybimble.svx</a>
|
|
</pre>
|
|
and the intermediate directories will be created on the server if they don't already exist. This is in addition to
|
|
the directory name which is also the name of your new cave being created automatically.
|
|
|
|
<hr />
|
|
<p>Back to the previous page in this sequence
|
|
<a href="newwallet.html">Creating a new survey wallet</a>.
|
|
<br />Now go the the next page in this sequence <a href="drawup.htm">Drawing up your survey</a>.
|
|
|
|
|
|
|
|
<hr />
|
|
|
|
|
|
</body>
|
|
</html>
|