expoweb/handbook/survey/newcave.html

<html>
<head>
<title>Handbook - Doing a new cave</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook -  New Cave</h2>
<h1>Creating a new cave in the online system</h1>

<h2>Great, I have discovered a new cave...</h2>
<p>So, you have staggered off the plateau with a fist-full of notes and surveys, 
and you want to let the world know of your massive discovery.
<ul>
<li>If you have not yet learned how to record your prospecting and survey 
your leads, read the <a href="../look4.htm">prospecting introduction</a> and
<a href="../survey/index.htm">survey handbook</a> which tells you how to record 
survey information in your waterproof notebook. But first you should read the
<a href="/expofiles/presentations/cave_surveying_20130626.pdf">
Cave Surveying training course slidepack</a>.

<li>This page outlines the rest of the process. Each part of it is documented separately.
</ul>
<h2>Process</h2>
<p>After 40 years or so, we have a well-defined process which you will need to learn. 
Read <em>all</em> this list first, then follow 
the instructions section by section which tell you how to
actually do these things.

<ul>
<li>Write up your trip in the <a href="../logbooks.html">logbook</a><br><br>
<li>Put notes in a new wallet
<li>Scan the notes (see <a href="#onlinew">below</a> for the filenames to use and <a href="#scan">how to use the scanner</a>)
<li>Type in survey data (in the right place in the file system) in <a href="#survexformat">survex format</a>.<br>
(This includes passage descriptions and open leads known as QMs: Question Marks).
<li>Run survex to create a centre-line printout
<li>Transcribe your sketches onto centre-line paper
<li>Scan your centre-lined sketches
<li>Use tunnel to digitise your centre-line sketches
</ul>
<p>and either later or at the same time, you will be doing these other tasks
<ul>
<li>Create a new folder in the file system for the wallet data 
<li>Create a new folder in the file system for the survex data 
<li>Create a "new cave entry" for the guidebook description 
<li>Write the <b>full cave description</b> into the correct html files. <br>
(This will mean copying the passage descriptions from the survex files.)
<li>Update the index tick boxes on paper: as your wallet progresses through this process
<li>Update the online record of those tick boxes
<li>Regenerate the <a href="http://expo.survex.com/expofiles/surveyscans/2018/">list of outstanding survey tasks</a> for everyone
</ul>
<p>This documentation assumes that you have recorded your survey data in 
a  waterproof paper notebook. If instead you are using a PDA to record the survey readings
digitally for your first cave, don't. Use the paper process first, then when you are familiar 
the overall process, look at the <a href="pdanotes.html">PDA additional notes</a>.

<h3 id="newwallet">Starting a new wallet</h3>
<ol>
<li>Put all your written notes into the next empty "wallet": 
(a transparent folder/envelope) in this year's lever-arch file labelled 
e.g. "Expo Survey 2018" in the potato hut*.
<li>The wallet has a paper sticky label on it with the wallet-identifier, 
e.g. <b>2018#22</b>, already printed on the label.
<li>Write the date and the names of the people on the trip on the label.
<li>Tick whether your trip was a surface or a cave trip.
<li>Write the name of the cave  (with number if you know it), e.g. "264 Balkon"
<li>Write the area in the cave you did your surveying, e.g. "mongol rally"<br>
<li>Now turn to the index sheets at the front of the folder, 
and fill in the line (e.g. 2018#22) for your wallet
<ul>
<li>"264 mongol rally"
<li>date of trip
<li>people who were on it
<li>then there are a lot of tick boxes. The explanations for these will come later.
</ul>
<p align=center>
<a href="2017-wallet-coverlist.jpg" border=1><img src="2017-wallet-coverlist.jpg" width=50%></a>
<br>
<em>Image of wallet index sheet - click for larger image</em>
</p>
<li>Now, if you have not done it immediately after you left the cave,
photograph all the pages of survey notes with your phone. 
Get one or more of the people also on the trip to do this too.
</ol>

<p>* As people spend longer and longer at top camp, we may establish 
a wallet file at top camp
too, with pre-allocated numbers.

<p>The original notes and sketches should be filed in the clearly marked
wallet. Rip them out of the notebook, don't take them caving again and <em>don't leave them lying around to
be "G&ouml;ssered"!</em></p>

<p>The notes (all of them, including dates, personnel, calibration, LRUD,
station details, etc.) should be filed away in the wallet in the current year's
surveys file. You should include a transcription on a sheet of paper if they are illegible
(to other people; if you can't read them yourself, go back and do the survey
again!). Even if you do this, never throw away the original notes.</p>

<!-- Original text: ...copied onto a fresh page of the Survey Book
while everyone's memory is still fresh (this helps if something is only
marginally legible). This should be proof checked by someone else. Current
survey books are divided into "Kaninchenh&ouml;hle" (usually referred to as
"KH Survey book") and "surface stuff and other caves" (usually referred to as
"notKH survey book"). There should be an index page at the front, which you
should also fill in so that people can find your survey again.</p>-->

<h3 id="onlinew">Scan the notes into the online wallet</h3>

<p>Each wallet has a corresponding folder in the online system where a record is kept
of what information is in the wallet and where the corresponding survey data is filed:
<pre>
/expofiles/surveyscans/2018/2018#22/
</pre>


<p>This is where the scanned (or photographed) copies of the survey notes are kept.
<p id="scan">To use the scanner attached to the <em>expo laptop</em>, select the "Simple Scan" 
icon from the vertical menu of icons which you get by clicking on 
"Activities" in the top lefthand corner of the screen. 

<p style="margin-left:20px">[ Normal people should skip this, <br>&nbsp;
but nerds need to look here 
for the <a href="onlinewallet.html">online wallet maintenance process</a> ]. 

<p>If your initial backup photos of your notes were poor quality, use the 
scanner in the potato hut to make better copies. Scan to JPEG format as .jpg files.
<p>Name the scanned pages "<em>notes-1.jpg</em>, or perferably <em>notes-cavepassagename.jpg</em>" etc. This is important as a script detects whether these files exist
(with names beginning "notes.." and "elev..") and if you name them something else it will hassle you unnecessarily.

<p>[ Note to maintainers: do not rename these files even if they have been created with the wrong names. 
They are permanently referred to by the tunnel/therion/troggle system !]

<p>Scanned survey notes are voluminous and so are not kept in the version control system. Instead it is all kept
in the file bucket "expofiles" on the expo server in Cambridge.
<p>You will be using the expo laptop to do the scanning 
and you will put all the scan files in the folder for your wallet, e.g. for 2018#19 it is:
<pre>
/home/expo/expofiles/surveyscans/2018/2018#19/
</pre>
and tell someone nerdy when you have finished and they will 
ensure that it is copied to the expo server. 
[ If you want to do this yourself, or are using your own laptop, then learn how to use Filezilla
- as <a href="../uploading.html">documented for uploading your expo photographs</a>. The correct folder
on the expo server is the same as that on the expo laptop- because we set up the expo laptop to be like that.
But <em>only copy files to the server that you created yourself and which live in your own wallet folder</em> ]

<h3 id="runsurvex">Storing your electronic survey files</h3>
<p>If you used a PDA instead of making notes on paper, you need to store your .topo files in the right place.

<p>If you using the expo laptop you can put the .topo files in a special "X" folder for your virtual 
wallet, as there is no physical wallet, 
e.g. for 2018#X16 it would be:
<pre>
/home/expo/expofiles/surveyscans/2018/2018#X16/
</pre>
and tell someone nerdy when you have finished and they will 
ensure that it is copied from the <em>expo laptop</em> to the expo server. 

<p>[ If all else fails, use the "Upload your photos" documented process and store 
the .topo files where you would have stored your .jpg photo files. Otherwise you can email all the .topo files
to a friendly nerd who will put them in the right place. ]
<p><em>to be further documented - probably in a separate page</em>

<h3 id="survexformat">Typing in the survey data in survex format</h3>
<p>[This has been described in several places and we are in the process of consolidating 
the documentation and getting rid of out of date notes.]

<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-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.
<p>If you have several parts of the cave surveyed on one trip, create several distinct .svx files.
<ul>
<li><a href="how_to_make_a_survex_file.pdf">How to make a survex file</a> - PDF
<li><a href="getin.htm">From muddy book to survex plot</a> - the survex file format (to be revised)
<li><a href="https://survex.com/docs/manual/svxhowto.htm">Contents of .svx files</a> - How do I? [docm.]
<li><a href="https://survex.com/docs/manual/genhowto.htm">How do I Create a new survey</a> - example with several surveys joined  [docm.]
<li><a href="https://survex.com/docs/manual/datafile.htm">Survex data files</a> - all the sections and keywords explained [docm.]
</ul>

<p>Once you have created the .svx file yo will rn survex to generate a centre line, transcribe your sketches onto that paper, scan it again and then digitise into tunnel or therion.

<ul>
<li><a href="drawup.htm">Drawing up your survey</a> - incomplete and a bit out of date
<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>
</ul>

<p>[Nerds: survex cave data belongs in the repository "loser", 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 whcih is why we are only 
telling them to use the <em>expo laptop</em>.] 


<h3 id="runsurvex">Running survex to create a centre-line</h3>
<p><em>to be documented</em>


<h3>Transcribing and re-scanning your sketches</h3>
<p><em>to be documented</em> See <a href="drawup.htm">drawing up the sketches</a>.
<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:
<pre>
/home/expo/expofiles/surveyscans/2018/2018#19/
</pre>

<h3>Using tunnel (or therion) for final survey production</h3>
<p><em>to be documented</em>
<ul>
<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 should 
be uploaded to the version control repository //tunneldata//.

<h3>Interim rigging guide</h3>
<p>The logbook is the place where we record the rigging of caves as we discover them.
<p>When a cave is derigged, 
a good way of getting the rope lengths for your rigging guide is to 
leave the knots in ropes removed  so they can
be <b>measured</b>, but these days our caves are a bit deep 
and complicated for this to be feasible. 
Although a good survey and details of the belays
can be used to estimate the length of rope needed, this is no substitute for
measuring how much rope it actually took to rig.</p>

<h3>Guidebook description and final rigging guide</h3>

<p>This is the last thing to do - typically after all exploration has been finished for the summer. 
The rigging guide sections will have been written into the logbook, and the passage descriptions will
have been written into the survex files, with more lyrical descriptions written into the logbook for each trip.
<p><em>to be documented</em>

<p>Write a <b>passage descriptions</b> by copying and extending the descriptions
given in all the component .svx files. 
<p>This should be detailed enough to be
followed by someone in the cave who hasn't been there before, and should
include all passage names, lengths of pitches and climbs, compass directions
when this makes left/right/ahead clearer. If your passage is a connection
it is worth while writing descriptions from both directions. 

<p>In
written descriptions, underline passage names the first time they are
mentioned, or when they are "defined".</p>

<p>
You will type this description, and pass it on to someone more nerdy who
will file it in the right place. This will involve "creating a new cave" using the <a href="../troggle-ish.html">troggle</a> system.
<p><em>to be documented</em>


<p>Complementing the passage description in vertical bits is a <b>Rigging
Guide</b>. This is usually easiest to do as a sketch, but include notes to
ensure that all bolts can be found again and any deviations and natural belays recognised.


<p><em>to be completed</em>

<hr />

<ul id="links">
<li><a href="../index.htm">Expedition Handbook</a>
<li><a href="index.htm">Survey Handbook</a>
</ul>
</body>
</html>
documenting wallet process 2018-08-08 13:17:03 +01:00			`<html>`
			`<head>`
			`<title>Handbook - Doing a new cave</title>`
			`<link rel="stylesheet" type="text/css" href="../../css/main2.css" />`
			`</head>`
			`<body>`
			`<h2 id="tophead">CUCC Expedition Handbook - New Cave</h2>`
			`<h1>Creating a new cave in the online system</h1>`

			`<h2>Great, I have discovered a new cave...</h2>`
			`<p>So, you have staggered off the plateau with a fist-full of notes and surveys,`
			`and you want to let the world know of your massive discovery.`
			`<ul>`
			`<li>If you have not yet learned how to record your prospecting and survey`
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`your leads, read the <a href="../look4.htm">prospecting introduction</a> and`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<a href="../survey/index.htm">survey handbook</a> which tells you how to record`
online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00			`survey information in your waterproof notebook. But first you should read the`
			`<a href="/expofiles/presentations/cave_surveying_20130626.pdf">`
			`Cave Surveying training course slidepack</a>.`

documenting wallet process 2018-08-08 13:17:03 +01:00			`<li>This page outlines the rest of the process. Each part of it is documented separately.`
			`</ul>`
			`<h2>Process</h2>`
more updates 2018-08-17 16:46:09 +01:00			`<p>After 40 years or so, we have a well-defined process which you will need to learn.`
			`Read <em>all</em> this list first, then follow`
			`the instructions section by section which tell you how to`
			`actually do these things.`
documenting wallet process 2018-08-08 13:17:03 +01:00
			`<ul>`
knitting in docmn for writing logbook entries, fixing old survey methods 2018-08-09 10:31:45 +01:00			`<li>Write up your trip in the <a href="../logbooks.html">logbook</a><br><br>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<li>Put notes in a new wallet`
more updates 2018-08-17 16:46:09 +01:00			`<li>Scan the notes (see <a href="#onlinew">below</a> for the filenames to use and <a href="#scan">how to use the scanner</a>)`
			`<li>Type in survey data (in the right place in the file system) in <a href="#survexformat">survex format</a>.<br>`
survex file and finishing survey page 2018-08-10 13:08:59 +01:00			`(This includes passage descriptions and open leads known as QMs: Question Marks).`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<li>Run survex to create a centre-line printout`
			`<li>Transcribe your sketches onto centre-line paper`
			`<li>Scan your centre-lined sketches`
			`<li>Use tunnel to digitise your centre-line sketches`
			`</ul>`
			`<p>and either later or at the same time, you will be doing these other tasks`
			`<ul>`
			`<li>Create a new folder in the file system for the wallet data`
			`<li>Create a new folder in the file system for the survex data`
more updates 2018-08-17 16:46:09 +01:00			`<li>Create a "new cave entry" for the guidebook description`
survex file and finishing survey page 2018-08-10 13:08:59 +01:00			`<li>Write the <b>full cave description</b> into the correct html files. <br>`
			`(This will mean copying the passage descriptions from the survex files.)`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<li>Update the index tick boxes on paper: as your wallet progresses through this process`
			`<li>Update the online record of those tick boxes`
Updatin the wallets.py documentaiton 2019-03-03 00:44:31 +00:00			`<li>Regenerate the <a href="http://expo.survex.com/expofiles/surveyscans/2018/">list of outstanding survey tasks</a> for everyone`
documenting wallet process 2018-08-08 13:17:03 +01:00			`</ul>`
			`<p>This documentation assumes that you have recorded your survey data in`
			`a waterproof paper notebook. If instead you are using a PDA to record the survey readings`
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`digitally for your first cave, don't. Use the paper process first, then when you are familiar`
documenting wallet process 2018-08-08 13:17:03 +01:00			`the overall process, look at the <a href="pdanotes.html">PDA additional notes</a>.`

fixing bad links 2018-08-09 21:09:16 +01:00			`<h3 id="newwallet">Starting a new wallet</h3>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<ol>`
			`<li>Put all your written notes into the next empty "wallet":`
			`(a transparent folder/envelope) in this year's lever-arch file labelled`
			`e.g. "Expo Survey 2018" in the potato hut*.`
			`<li>The wallet has a paper sticky label on it with the wallet-identifier,`
			`e.g. <b>2018#22</b>, already printed on the label.`
			`<li>Write the date and the names of the people on the trip on the label.`
			`<li>Tick whether your trip was a surface or a cave trip.`
			`<li>Write the name of the cave (with number if you know it), e.g. "264 Balkon"`
			`<li>Write the area in the cave you did your surveying, e.g. "mongol rally"<br>`
			`<li>Now turn to the index sheets at the front of the folder,`
			`and fill in the line (e.g. 2018#22) for your wallet`
			`<ul>`
			`<li>"264 mongol rally"`
			`<li>date of trip`
			`<li>people who were on it`
			`<li>then there are a lot of tick boxes. The explanations for these will come later.`
			`</ul>`
wallet index page example 2019-12-16 15:01:32 +00:00			`<p align=center>`
			`<a href="2017-wallet-coverlist.jpg" border=1><img src="2017-wallet-coverlist.jpg" width=50%></a>`
			`<br>`
			`<em>Image of wallet index sheet - click for larger image</em>`
			`</p>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<li>Now, if you have not done it immediately after you left the cave,`
			`photograph all the pages of survey notes with your phone.`
			`Get one or more of the people also on the trip to do this too.`
			`</ol>`

fixing bad links 2018-08-09 21:09:16 +01:00			`<p>* As people spend longer and longer at top camp, we may establish`
			`a wallet file at top camp`
documenting wallet process 2018-08-08 13:17:03 +01:00			`too, with pre-allocated numbers.`

			`<p>The original notes and sketches should be filed in the clearly marked`
survex file creation 2018-08-08 20:37:08 +01:00			`wallet. Rip them out of the notebook, don't take them caving again and <em>don't leave them lying around to`
documenting wallet process 2018-08-08 13:17:03 +01:00			`be "Gössered"!</em></p>`

			`<p>The notes (all of them, including dates, personnel, calibration, LRUD,`
			`station details, etc.) should be filed away in the wallet in the current year's`
survex file creation 2018-08-08 20:37:08 +01:00			`surveys file. You should include a transcription on a sheet of paper if they are illegible`
documenting wallet process 2018-08-08 13:17:03 +01:00			`(to other people; if you can't read them yourself, go back and do the survey`
			`again!). Even if you do this, never throw away the original notes.</p>`

			`<!-- Original text: ...copied onto a fresh page of the Survey Book`
			`while everyone's memory is still fresh (this helps if something is only`
			`marginally legible). This should be proof checked by someone else. Current`
			`survey books are divided into "Kaninchenhöhle" (usually referred to as`
			`"KH Survey book") and "surface stuff and other caves" (usually referred to as`
			`"notKH survey book"). There should be an index page at the front, which you`
			`should also fill in so that people can find your survey again.</p>-->`

documenting online wallets and make.py 2018-08-15 21:44:24 +01:00			`<h3 id="onlinew">Scan the notes into the online wallet</h3>`
documenting wallet process 2018-08-08 13:17:03 +01:00
			`<p>Each wallet has a corresponding folder in the online system where a record is kept`
			`of what information is in the wallet and where the corresponding survey data is filed:`
			`<pre>`
			`/expofiles/surveyscans/2018/2018#22/`
			`</pre>`
online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00

			`<p>This is where the scanned (or photographed) copies of the survey notes are kept.`
more updates 2018-08-17 16:46:09 +01:00			`<p id="scan">To use the scanner attached to the <em>expo laptop</em>, select the "Simple Scan"`
			`icon from the vertical menu of icons which you get by clicking on`
			`"Activities" in the top lefthand corner of the screen.`
online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00
more updates 2018-08-17 16:46:09 +01:00			`<p style="margin-left:20px">[ Normal people should skip this, <br> `
			`but nerds need to look here`
			`for the <a href="onlinewallet.html">online wallet maintenance process</a> ].`
online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00
documenting wallet process 2018-08-08 13:17:03 +01:00			`<p>If your initial backup photos of your notes were poor quality, use the`
survex file creation 2018-08-08 20:37:08 +01:00			`scanner in the potato hut to make better copies. Scan to JPEG format as .jpg files.`
filenaming maintenance note added to instructions 2019-07-13 09:52:41 +01:00			`<p>Name the scanned pages "<em>notes-1.jpg</em>, or perferably <em>notes-cavepassagename.jpg</em>" etc. This is important as a script detects whether these files exist`
			`(with names beginning "notes.." and "elev..") and if you name them something else it will hassle you unnecessarily.`

			`<p>[ Note to maintainers: do not rename these files even if they have been created with the wrong names.`
			`They are permanently referred to by the tunnel/therion/troggle system !]`
documenting wallet process 2018-08-08 13:17:03 +01:00
			`<p>Scanned survey notes are voluminous and so are not kept in the version control system. Instead it is all kept`
			`in the file bucket "expofiles" on the expo server in Cambridge.`
			`<p>You will be using the expo laptop to do the scanning`
survex file creation 2018-08-08 20:37:08 +01:00			`and you will put all the scan files in the folder for your wallet, e.g. for 2018#19 it is:`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<pre>`
survex file creation 2018-08-08 20:37:08 +01:00			`/home/expo/expofiles/surveyscans/2018/2018#19/`
documenting wallet process 2018-08-08 13:17:03 +01:00			`</pre>`
			`and tell someone nerdy when you have finished and they will`
			`ensure that it is copied to the expo server.`
more updates 2018-08-17 16:46:09 +01:00			`[ If you want to do this yourself, or are using your own laptop, then learn how to use Filezilla`
documenting wallet process 2018-08-08 13:17:03 +01:00			`- as <a href="../uploading.html">documented for uploading your expo photographs</a>. The correct folder`
documenting online wallets and make.py 2018-08-15 21:44:24 +01:00			`on the expo server is the same as that on the expo laptop- because we set up the expo laptop to be like that.`
more updates 2018-08-17 16:46:09 +01:00			`But <em>only copy files to the server that you created yourself and which live in your own wallet folder</em> ]`
docm improvements 2018-08-11 16:54:55 +01:00
			`<h3 id="runsurvex">Storing your electronic survey files</h3>`
			`<p>If you used a PDA instead of making notes on paper, you need to store your .topo files in the right place.`

			`<p>If you using the expo laptop you can put the .topo files in a special "X" folder for your virtual`
			`wallet, as there is no physical wallet,`
			`e.g. for 2018#X16 it would be:`
			`<pre>`
			`/home/expo/expofiles/surveyscans/2018/2018#X16/`
			`</pre>`
			`and tell someone nerdy when you have finished and they will`
			`ensure that it is copied from the <em>expo laptop</em> to the expo server.`

more updates 2018-08-17 16:46:09 +01:00			`<p>[ If all else fails, use the "Upload your photos" documented process and store`
docm improvements 2018-08-11 16:54:55 +01:00			`the .topo files where you would have stored your .jpg photo files. Otherwise you can email all the .topo files`
more updates 2018-08-17 16:46:09 +01:00			`to a friendly nerd who will put them in the right place. ]`
docm improvements 2018-08-11 16:54:55 +01:00			`<p><em>to be further documented - probably in a separate page</em>`
documenting wallet process 2018-08-08 13:17:03 +01:00
fixing bad links 2018-08-09 21:09:16 +01:00			`<h3 id="survexformat">Typing in the survey data in survex format</h3>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<p>[This has been described in several places and we are in the process of consolidating`
			`the documentation and getting rid of out of date notes.]`

			`<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.`

online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00			`New users will be using the expo laptop to create the .svx file and`
documenting wallet process 2018-08-08 13:17:03 +01:00			`you will put it in the folder`
			`<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.`
			`<p>If you have several parts of the cave surveyed on one trip, create several distinct .svx files.`
			`<ul>`
survex file creation 2018-08-08 20:37:08 +01:00			`<li><a href="how_to_make_a_survex_file.pdf">How to make a survex file</a> - PDF`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<li><a href="getin.htm">From muddy book to survex plot</a> - the survex file format (to be revised)`
Links to Survex manual into the handbook - radical idea. 2019-12-06 00:47:38 +00:00			`<li><a href="https://survex.com/docs/manual/svxhowto.htm">Contents of .svx files</a> - How do I? [docm.]`
			`<li><a href="https://survex.com/docs/manual/genhowto.htm">How do I Create a new survey</a> - example with several surveys joined [docm.]`
			`<li><a href="https://survex.com/docs/manual/datafile.htm">Survex data files</a> - all the sections and keywords explained [docm.]`
			`</ul>`

			`<p>Once you have created the .svx file yo will rn survex to generate a centre line, transcribe your sketches onto that paper, scan it again and then digitise into tunnel or therion.`

			`<ul>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<li><a href="drawup.htm">Drawing up your survey</a> - incomplete and a bit out of date`
			`<li><a href="athome.htm">Back in the UK</a> - not really part of the process`
online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00			`<li><a href="/expofiles/presentations/cave_surveying_20130626.pdf">Cave Surveying - training course slidepack</a>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`</ul>`

online wallet - nerd instrucitons 2018-08-14 16:16:49 +01:00			`<p>[Nerds: survex cave data belongs in the repository "loser", 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 whcih is why we are only`
			`telling them to use the <em>expo laptop</em>.]`


fixing bad links 2018-08-09 21:09:16 +01:00			`<h3 id="runsurvex">Running survex to create a centre-line</h3>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<p><em>to be documented</em>`

docm improvements 2018-08-11 16:54:55 +01:00

documenting wallet process 2018-08-08 13:17:03 +01:00			`<h3>Transcribing and re-scanning your sketches</h3>`
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`<p><em>to be documented</em> See <a href="drawup.htm">drawing up the sketches</a>.`
			`<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:`
			`<pre>`
			`/home/expo/expofiles/surveyscans/2018/2018#19/`
			`</pre>`
documenting wallet process 2018-08-08 13:17:03 +01:00
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`<h3>Using tunnel (or therion) for final survey production</h3>`
documenting wallet process 2018-08-08 13:17:03 +01:00			`<p><em>to be documented</em>`
survex file creation 2018-08-08 20:37:08 +01:00			`<ul>`
			`<li><a href="/expofiles/tunnelwiki/wiki/pages/Tunnel.html">Tunnel tutorial</a> - a wiki of examples and tutorials`
			`</ul>`
documenting wallet process 2018-08-08 13:17:03 +01:00
			`<p>Tunnel only produces plan surveys, but they are very pretty.`

documenting online wallets and make.py 2018-08-15 21:44:24 +01:00			`<p>The tunnel (or therion) files should NOT stored in the same folder as the scanned notes. They should`
			`be uploaded to the version control repository //tunneldata//.`
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00
more updates 2018-08-17 16:46:09 +01:00			`<h3>Interim rigging guide</h3>`
			`<p>The logbook is the place where we record the rigging of caves as we discover them.`
			`<p>When a cave is derigged,`
			`a good way of getting the rope lengths for your rigging guide is to`
			`leave the knots in ropes removed so they can`
			`be <b>measured</b>, but these days our caves are a bit deep`
			`and complicated for this to be feasible.`
			`Although a good survey and details of the belays`
			`can be used to estimate the length of rope needed, this is no substitute for`
			`measuring how much rope it actually took to rig.</p>`

			`<h3>Guidebook description and final rigging guide</h3>`

			`<p>This is the last thing to do - typically after all exploration has been finished for the summer.`
			`The rigging guide sections will have been written into the logbook, and the passage descriptions will`
			`have been written into the survex files, with more lyrical descriptions written into the logbook for each trip.`
			`<p><em>to be documented</em>`
fixing bad links 2018-08-09 21:09:16 +01:00
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`<p>Write a <b>passage descriptions</b> by copying and extending the descriptions`
			`given in all the component .svx files.`
			`<p>This should be detailed enough to be`
fixing bad links 2018-08-09 21:09:16 +01:00			`followed by someone in the cave who hasn't been there before, and should`
			`include all passage names, lengths of pitches and climbs, compass directions`
			`when this makes left/right/ahead clearer. If your passage is a connection`
			`it is worth while writing descriptions from both directions.`
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00
			`<p>In`
fixing bad links 2018-08-09 21:09:16 +01:00			`written descriptions, underline passage names the first time they are`
			`mentioned, or when they are "defined".</p>`

fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`<p>`
			`You will type this description, and pass it on to someone more nerdy who`
Making every mention of troggle link to the description of what it is 2019-02-25 22:16:43 +00:00			`will file it in the right place. This will involve "creating a new cave" using the <a href="../troggle-ish.html">troggle</a> system.`
fixing bad link and extra bit 2018-08-11 20:22:17 +01:00			`<p><em>to be documented</em>`


fixing bad links 2018-08-09 21:09:16 +01:00			`<p>Complementing the passage description in vertical bits is a <b>Rigging`
			`Guide</b>. This is usually easiest to do as a sketch, but include notes to`
			`ensure that all bolts can be found again and any deviations and natural belays recognised.`
more updates 2018-08-17 16:46:09 +01:00
fixing bad links 2018-08-09 21:09:16 +01:00
			`<p><em>to be completed</em>`

documenting wallet process 2018-08-08 13:17:03 +01:00			`<hr />`

			`<ul id="links">`
			`<li><a href="../index.htm">Expedition Handbook</a>`
			`<li><a href="index.htm">Survey Handbook</a>`
			`</ul>`
			`</body>`
			`</html>`