From 30e1e7864ea177aa20d70922579b7376ed64264a Mon Sep 17 00:00:00 2001 From: Philip Sargent Date: Sat, 22 Jul 2023 23:56:35 +0300 Subject: [PATCH] very significantly rearranged instructions on creating survex files --- handbook/survey/newsurvex.html | 237 ++++++++++++++++++--------------- 1 file changed, 132 insertions(+), 105 deletions(-) diff --git a/handbook/survey/newsurvex.html b/handbook/survey/newsurvex.html index af2674e7c..23d66c3ff 100644 --- a/handbook/survey/newsurvex.html +++ b/handbook/survey/newsurvex.html @@ -28,136 +28,66 @@ This page outlines step 3 of the survey production process. Each step is documen - 8

Process

-

In principle you do not need any software other than a text editor to create a survex file. +

You do not need any software to create a survex file. You can do it using the online editor in your web browser. So you do not need to have installed survex on your laptop at this point.

+

Once you used the online system, which tries to give useful feedback, you can type up survex files using a text editor. +

If using a digital survey device, initially cut and paste the surve data from an exported file into the online survex editor form. -

Two ways to type in survex data

- -
+ +
-Typical raw survex data - 'bidet' in Steinbrückenhöhle, Martin Green 14/8/2000 +Typical raw survex data - 'bidet' in Steinbrückenhöhle, Martin Green 2000-08-14
Click to see in online editor.
-

Typing in the survey data in survex format

- - - -

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 using the online form, not by editing a text file with a text editor. - -

The Right Place

-The new survex data will live in the folder -
-/home/expo/loser/caves-{area}/{cave}/{surveytripid}.svx
-
-example: -
-/home/expo/loser/caves-1623/264/mongolrally.svx
-
-and tell someone nerdy when you have finished and they will -ensure that it is saved, committed, and pushed appropriately to the :loser: repo. -

If you have several parts of the cave surveyed on one trip, create several distinct .svx files. +

Two ways to type in survex data

-

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

- -

[Nerds: survex cave data belongs in the repository :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 expo laptop.] - -

Entering the QM data

-

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

-

- Read this separate description about - entering the QM data into a survex file. -

- -

Entering the cave description in the survex file

-

The last part of the survex file is a description of the passage surveyed. Remember - that this is intended to be read by people - who have not been to that bit of the cave themselves - -;------------
-;Cave description ;(leave commented-out)
-; 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. - -[from couldashouldawoulda_to_bathdodgersbypass.svx] -

-

- 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 Cave Description" handbook page which also describes eventual HTML publication. - -

-
- - -
-Wolfhöhle raw survey data 1983 - Austrian mud (click to enlarge) -
-
-
- -

Using the direct online system

-

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

Having confirmed the right name to use for your cave, including whether it is in area 1623 or 1626, e.g. +

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

You will be over-writing a template file with lots of comments and optional examples in square brackets, +but first you need to find the right place for everything. + +

The right place

+

Having confirmed the right name to use for your passage and your cave, including whether it is in area 1623 or 1626, +the survex file will eventaully be in e.g. 

-caves-1623/2050-cucc-01/easybimble.svx
+caves-1623/2050-BH-03/easybimble.svx
-open a web browser on the equivalent page +The way to start is to open a web browser on the equivalent page 
 http://expo.survex.com/survexfile/caves-{area}/{cave}/{surveytripid}.svx
-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 +where {area} will be 1623 or 1626, and for a new discovery, {cave} will be something like 2050-BH-03 if it is the third cave disovered by Dr. Bunsen Honeydew on the 2050 expo, e.g. 
 /survexfile/caves-1623/2050-BH-03/easybimble.svx
-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. -

You can save your work by pressing the "Save this edited svx file" button, but it +Before you click on that link, you need to make sure that you are logged in. In the top-right of troggle-generated pages there is a menu item "Log in", if +all your browser pages are handbook pages, click here to get to the log in page. The username is "expo" and the password +is the usual cavey:beery one which is written up on the whiteboard in the potato hut. +

+Now click that link /survexfile/caves-1623/2050-BH-03/easybimble.svx and a survex-file editing page will open, pre-populated with an example template +for survex data. +

Most of the template data you will delete and replace. Edit this template and type in your own data. OK, so if you have never typed +a survex file before, go to this section below on this page. + +

If you have several parts of the cave surveyed on one trip, create several distinct .svx files. + +

You can save your work by pressing the "Save this edited svx file" button below the edit box, but it will refuse to save until you have hand-edited out all the template material in [square brackets].

As you edit it, you can press the "Differences between edited and saved versions of this file" and the differences which @@ -216,6 +146,103 @@ URL bar e.g. 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. + + + +

Typing in the survey data with a text editor

+ +

The survey data typed up must include all the notes, including station details and passage +names. A simple copy of the export from a digital device will not do. We need names, dates and description. Make a backup copy to another machine or USB stick as soon as you have typed it in. +

+New users will be using the online form to create the .svx file , not by editing a text file with a text editor, +so don't confuse newcomers by showing them how you (an expert, of course) do it. + +

+The new survex data will live in the folder on the expo laptop: +

+/home/expo/loser/caves-{area}/{cave}/{surveytripid}.svx
+
+example: +
+/home/expo/loser/caves-1623/264/mongolrally.svx
+
+and tell someone nerdy when you have finished and they will +ensure that it is saved, committed, and pushed appropriately to the :loser: repo. All of which is automatic if you +use the online form. + + +

What goes in a survex file

+ + +

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

+ +

[Nerds: survex cave data belongs in the repository :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 +telling them to use the online form.] + +

Entering the QM data

+

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

+

+ Read this separate description about + entering the QM data into a survex file. +

+ +

Entering the cave description in the survex file

+

The last part of the survex file is a description of the passage surveyed. Remember + that this is intended to be read by people + who have not been to that bit of the cave themselves + +;------------
+;Cave description ;(leave commented-out)
+; 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. + +[from couldashouldawoulda_to_bathdodgersbypass.svx] +

+

+ 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 Cave Description" handbook page which also describes eventual HTML publication. + +

+
+ + +
+Wolfhöhle raw survey data 1983 - Austrian mud (click to enlarge) +
+
+
+ + + +

Back to the previous page in this sequence Creating a new survey wallet.