expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2026-02-25 13:45:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

handbook edits & fixes

Browse Source
This commit is contained in:
Philip Sargent
2021-04-11 19:22:24 +01:00
parent 210baed0ac
commit 228b44fe0e
8 changed files with 104 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

72
handbook/survey/drawup.htm
View File

@@ -40,45 +40,61 @@ survex format</a> , run
<a href="https://survex.com/docs/manual/aven.htm">aven</a> (the GUI interface - installed when you installed survex) and print out a centre-line plan.
<p>OK if this is your first time doing this, you need to go through the
<a href="usingsurvex.html">"How to use survex" training procedure</a>.
<a href="newsurvex.html">"How to use survex" training procedure</a>.
<h3 id="runsurvex">Running survex to create a centre-line</h3>
<p><em>to be documented</em>
<h3 id="rescan">Transcribing and re-scanning your sketches</h3>
<p>The files of your scanned and re-scanned sketches should be stored in the same folder
as the scanned notes, i.e. (for wallet #19) you would put them in:
<tt>
/home/expo/expofiles/surveyscans/2018/2018#19/
</tt>
(but this is not where you will put your finished drawings.)
<h3 id="therion">Using tunnel or therion for final survey production</h3>
<p>Use aven to print out the centre lines of the passages. Now you will have to decide whether to use Tunnel or Therion. Expo has a polciy decision on this: if it is an entirely new disconnected cave, then use Therion. If it is a passage in a cave where previously we used Tunnel, then use Tunnel. See also <a href="/expofiles/tunnelwiki/wiki/pages/Other_Cave_Software.html">Comparison of Tunnel to Other Cave Software</a>.
<p>
<div class="onright">
<figure>
<a href="/expofiles/tunnelwiki/wiki/pages/Tracing_the_Image.html">
<img src="sketch6.gif" ></a>
<figcaption style="font-variant-caps: small-caps;">
<em>Tracing the image - click for tutorial</em>
</figcaption>
</figure>
</div>
<ul>
<li><a href="/expofiles/documents/surveying/tunnel-guide.pdf">How to use Tunnel</a> - PDF - Brendan's guide.
<li><a href="/expofiles/documents/surveying/tunnel-loefflerCP35-only.pdf">Guide to using Tunnel</a> - PDF - David Loeffler's documentation.
<li><a href="/expofiles/tunnelwiki/wiki/pages/Tunnel.html">Tunnel tutorial</a> - a wiki of examples and tutorials
</ul>
<p>Tunnel only produces plan surveys, but they are very pretty.
<p>The tunnel (or therion) files should NOT stored in the same folder as the scanned notes. They will eventually
be uploaded to the version control repository
<var><a href="../computing/repos.html">drawings</a></var>
but for a first attempt store them on the <em>expo laptop</em> in <var>/home/expo/drawings/{cavenumber}</var>.
Look at what is in there already and ask someone whcih directory to put them in. It will probably be a folder like this:
<tt>
/home/expo/drawings/264-and-258/toimport/
</tt>
<p>Take the printed centre lines and redraw the survey round it, working from
Take the printed centre lines on paper and redraw the survey round it, working from
the original sketches as if this was to be the final published survey. You
can "invent" details like boulders in boulder-strewn passage, but otherwise,
draw only what was recorded faithfully in the cave. If this makes your
drawing look bad - record more next time! If things really are unclear,
consider taking a copy of this drawing back into the cave to clarify it.</p>
<p>Now scan your sketch, transfer the file to the <em>expo laptop</em> and open it in Tunnel (or Therion).
Using a mouse on the screen within Tunnel (or Therion), you will then trace over the image and thus create a vector drawing of the cave.
Very detailed instructions for doing this in Tunnel are in <a href="/expofiles/tunnelwiki/wiki/pages/File_Formats.html#Raw_Sketch_Data">Tunnel Wiki: Raw Sketch Data</a>
<h3 id="filescans">Filing your sketches</h3>
<p>The files of your scanned and re-scanned sketches should be stored in the same folder
as the scanned notes, i.e. (for wallet #19, for expo 2018) you would put them in:
<tt>
/home/expo/expofiles/surveyscans/2018/2018#19/
</tt>
(but this is not where you will put your finished Tunnel or Therion vector files.)
<h3 id="therion">Using tunnel or therion for final survey production</h3>
<ul>
<li><a href="/expofiles/documents/surveying/Tunnel_Guide.pdf">How to use Tunnel</a> - PDF - Brendan's guide.
<li><a href="/expofiles/documents/surveying/tunnel-loefflerCP35-only.pdf">Guide to using Tunnel</a> - PDF - David Loeffler's documentation.
<li><a href="/expofiles/tunnelwiki/wiki/pages/Tunnel.html#Tutorial">Tunnel tutorial</a> - an advanced tutorial with many examples
</ul>
<p>Tunnel only produces plan surveys, but they are very pretty.
<p>The tunnel (or therion) vector files should NOT stored in the same folder as the scanned notes. They will eventually
be uploaded to the version control repository
<var><a href="../computing/repos.html">drawings</a></var>
but for a first attempt store them on the <em>expo laptop</em> in <var>/home/expo/drawings/{cavenumber}</var>.
Look at what is in there already and ask someone which directory to put them in. It will probably be a folder like this:
<tt>
/home/expo/drawings/264-and-258/toimport/
</tt>
<h3>Guidebook description</h3>

25
handbook/survey/newsurvex.html
View File

@@ -35,10 +35,20 @@ This page outlines step 3 of the survey production process. Each step is documen
<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 surveytripid) you will be using. Instructions are
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&uuml;ckenh&ouml;hle, Martin Green 14/8/2000</em>
</figcaption>
</figure>
</div>
<h3 id="survexformat">Typing in the survey data in survex format</h3>
@@ -65,6 +75,7 @@ ensure that it is <em>saved, committed, </em>and<em> pushed</em> appropriately t
<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
@@ -75,7 +86,7 @@ scan it again and then use that scanned image to digitise passage layout into tu
<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="../survexhiustory96.htm">History of Survex (1996)</a></li>
<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.
@@ -116,6 +127,7 @@ straighforward p10.
</p>
<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
@@ -124,11 +136,12 @@ open a web browser on the equivalent page
<pre>
http://expo.suvex.com/survexfile/caves-{area}/{cave}/{surveytripid}.svx
</pre>
e.g.
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-CUCC-01/easybimble.svx">/survexfile/caves-1623/2050-CUCC-01/easybimble.svx</a>
<a href="/survexfile/caves-1623/2050-BH-03/easybimble.svx">/survexfile/caves-1623/2050-BH-03/easybimble.svx</a>
</pre>
and a suvex-file editing page will open, pre-populated with an example template
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].
@@ -172,7 +185,7 @@ typing up your notes.
<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-CUCC-01/murderalley/killerclimb/easybimble.svx">survexfile/caves-1623/2050-CUCC-01/murderalley/killerclimb/easybimble.svx</a>
<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.

BIN
handbook/survey/notex.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 39 KiB

BIN
handbook/survey/sketch6.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 10 KiB

32
handbook/survey/usingsurvex.html
View File

@@ -1,32 +0,0 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Handbook placeholder page</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Placeholder</h1>
<p>This is not the page you were hoping for.
<p>This will be replaced with the information you want as soon as someone gets around to writing it. Why not find out how to do this yourself ?
<hr />
<div id="menu">
<ul id="links">
<li><a href="../index.htm">Expedition Handbook</a>
<ul>
<li><a href="../rig/rigit.html">Rigging guide</a></li>
<li><a href="../survey/index.htm">Surveying guide</a></li>
<li><a href="../look4.htm">Prospecting guide</a></li>
<li><a href="../rescue.htm">Rescue guide</a></li>
</ul></li>
<li><a href="../../infodx.htm">Main index</a></li>
<li><a href="../../index.htm">Expo Home</a></li>
<li><a href="https://camcaving.uk">CUCC Home</a></li>
</ul>
</div>
</body>
</html>