2020-02-28 16:18:54 +00:00
<!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.
2020-03-02 12:51:18 +00:00
< 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 / >
2020-03-01 15:47:10 +00:00
<!-- Yes we need some proper context - marking here, breadcrumb trails or something.
Maybe a colour scheme for just this sequence of pages
-->
2020-03-02 12:51:18 +00:00
< 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 >
2021-05-07 20:12:47 +01:00
- < a href = "ententry.html" > 7< / a >
- < a href = "cavedescription.html" > 8< / a >
< / div >
2020-02-28 16:18:54 +00:00
< h2 > Process< / h2 >
2020-03-01 20:18:46 +00:00
< 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 >
2020-02-28 16:18:54 +00:00
2020-08-03 01:22:45 +01:00
< 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
2021-04-11 19:22:24 +01:00
be somewhat confident of the name (the 'surveytrip' id) you will be using. Instructions are
2020-08-03 01:22:45 +01:00
< 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 >
2021-04-11 19:22:24 +01:00
< 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 >
2020-02-28 16:18:54 +00:00
< h3 id = "survexformat" > Typing in the survey data in survex format< / h3 >
2020-03-01 20:18:46 +00:00
2020-02-28 16:18:54 +00:00
2020-08-03 01:22:45 +01:00
2020-02-28 16:18:54 +00:00
< 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 >
2020-03-01 23:17:02 +00:00
/home/expo/loser/caves-{area}/{cave}/{surveytripid}.svx
< / pre >
example:
< pre >
2020-02-28 16:18:54 +00:00
/home/expo/loser/caves-1623/264/mongolrally.svx
< / pre >
and tell someone nerdy when you have finished and they will
2020-04-11 17:46:18 +01:00
ensure that it is < em > saved, committed, < / em > and< em > pushed< / em > appropriately to the :loser: repo.
2020-02-28 16:18:54 +00:00
< p > If you have several parts of the cave surveyed on one trip, create several distinct .svx files.
< ul >
2020-05-10 18:01:14 +01:00
< li > < a href = "/expofiles/documents/surveying/survex-guide.pdf" > How to create a survex file< / a > - PDF - Brendan's guide.
2020-02-28 16:18:54 +00:00
< 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
2021-04-11 19:22:24 +01:00
< li > < font color = red > [tunnel software docm.]< / font > < a href = "/expofiles/tunnelwiki/wiki/pages/File_Formats.html" > Survex data files< / a > - introduction and explanation
2020-02-28 16:18:54 +00:00
< / ul >
2020-03-01 23:17:02 +00:00
< 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.
2020-02-28 16:18:54 +00:00
< 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 >
2021-04-11 19:22:24 +01:00
< li > < a href = "../survexhistory96.htm" > History of Survex (1996)< / a > < / li >
2020-02-28 16:18:54 +00:00
< / ul >
2020-04-26 21:41:21 +01:00
< p > [Nerds: survex cave data belongs in the < a href = "../computing/repos.html" > repository< / a > :loser: so e.g.
2020-04-11 17:46:18 +01:00
:loser:/caves-1623/264/mongolrally.svx". We are assuming that normal users have never
2020-02-28 16:18:54 +00:00
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 > .]
2021-12-30 14:56:05 +00:00
< h3 > < a id = "tickqm" > Entering the QM data< / a > < / h3 >
2020-02-28 16:18:54 +00:00
< p >
2020-03-01 17:46:05 +00:00
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 >
2022-03-19 22:10:27 +00:00
[from < a href = "/survexfile/caves-1623/2017-cucc-24/couldashouldawoulda_to_bathdodgersbypass.svx" > < em > couldashouldawoulda_to_bathdodgersbypass.svx< / em > < / a > ]
2020-03-01 17:46:05 +00:00
< / p >
< p >
Note that the description is often written as one long line. Use the word-wrap capability in your editor
2022-03-19 22:10:27 +00:00
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.
2022-03-20 00:31:49 +00:00
< 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 >
2020-02-28 16:18:54 +00:00
2020-08-03 01:22:45 +01:00
< h3 > < a id = "onlinesvx" > Using the direct online system< / a > < / h3 >
2021-04-11 19:22:24 +01:00
< 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.
2020-08-03 01:22:45 +01:00
< 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 >
2021-04-11 19:22:24 +01:00
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.
2020-08-03 01:22:45 +01:00
< pre >
2021-04-11 19:22:24 +01:00
< a href = "/survexfile/caves-1623/2050-BH-03/easybimble.svx" > /survexfile/caves-1623/2050-BH-03/easybimble.svx< / a >
2020-08-03 01:22:45 +01:00
< / pre >
2021-04-11 19:22:24 +01:00
and a survex-file editing page will open, pre-populated with an example template
2020-08-03 01:22:45 +01:00
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 >
2023-03-05 20:22:43 +00:00
- If you try to save before editing out the [square brackets] stuff then you will get a message
< pre > Error: remove all []s from the text.
Everything inside [] are only template guidance.
All [] must be edited out and replaced with real data before you can save this file.
2020-08-03 01:22:45 +01:00
< / pre > below the editing window.
< br >
2022-03-19 22:10:27 +00:00
- 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
2023-03-05 20:22:43 +00:00
server. It is also being automatically registered in the version control system. So don't worry about losing data. A super-git-nerd can always recover it (not a job for an ordinary nerd though).
2022-03-19 22:10:27 +00:00
< 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 > .
2020-08-03 01:22:45 +01:00
< 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 >
2021-04-11 19:22:24 +01:00
< a href = "/survexfile/caves-1623/2050-BH-03/murderalley/killerclimb/easybimble.svx" > survexfile/caves-1623/2050-BH-03/murderalley/killerclimb/easybimble.svx< / a >
2020-08-03 01:22:45 +01:00
< / 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.
2020-03-01 17:46:05 +00:00
< 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 > .
2020-02-28 16:18:54 +00:00
< hr / >
< / body >
< / html >
