From d3e71eabdee6f9d7f6f1d522810932e6cf097c8e Mon Sep 17 00:00:00 2001 From: Philip Sargent Date: Wed, 8 Aug 2018 14:17:03 +0200 Subject: [PATCH] documenting wallet process --- handbook/survey/getin.htm | 35 ++------ handbook/survey/newcave.html | 158 ++++++++++++++++++++++++++++++++++ handbook/survey/pdanotes.html | 23 +++++ 3 files changed, 188 insertions(+), 28 deletions(-) create mode 100644 handbook/survey/newcave.html create mode 100644 handbook/survey/pdanotes.html diff --git a/handbook/survey/getin.htm b/handbook/survey/getin.htm index 6e092168e..5cb510887 100644 --- a/handbook/survey/getin.htm +++ b/handbook/survey/getin.htm @@ -1,43 +1,22 @@ - - CUCC Expo Surveying Handbook: Entering data + + +

CUCC Expo Surveying Handbook

+

From muddy book to Survex plot

+ +
-

Tony Rooke entering data

+

Tony Rooke entering data in days gone by

-

CUCC Expo Surveying Handbook

-

Base Camp: from muddy book to Survex plot

-

The original notes and sketches should be filed in a clearly marked -envelope - don't take them caving again and don't leave them lying around to -be "Gössered"!

- -

The notes (all of them, including dates, personnel, calibration, LRUD, -station details, etc.) should be filed away in a numbered wallet in the current -surveys file. You might have to include a transcription 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.

- - - -

The data should be typed into whichever computer is being used for the -survey, again including all the notes, including station details and passage -names (and make a backup copy to a floppy or another machine). It is -absolutely essential that you also fill in details of which survey -folder the notes are in, with index numbers.

Survex has its own documentation for the format of the data, though the template file and a look at someone else's data will quickly make this diff --git a/handbook/survey/newcave.html b/handbook/survey/newcave.html new file mode 100644 index 000000000..4a59f91aa --- /dev/null +++ b/handbook/survey/newcave.html @@ -0,0 +1,158 @@ + + +Handbook - Doing a new cave + + + +

CUCC Expedition Handbook - New Cave

+

Creating a new cave in the online system

+ +

Great, I have discovered a new cave...

+

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

+

Process

+

After 40 years or so, we have a well-defined process which you will need to learn. + +

+

and either later or at the same time, you will be doing these other tasks +

+

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 familair +the overall process, look at the PDA additional notes. + +

Starting a new wallet

+
    +
  1. 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*. +
  2. The wallet has a paper sticky label on it with the wallet-identifier, +e.g. 2018#22, already printed on the label. +
  3. Write the date and the names of the people on the trip on the label. +
  4. Tick whether your trip was a surface or a cave trip. +
  5. Write the name of the cave (with number if you know it), e.g. "264 Balkon" +
  6. Write the area in the cave you did your surveying, e.g. "mongol rally"
    +
  7. Now turn to the index sheets at the front of the folder, +and fill in the line (e.g. 2018#22) for your wallet +
      +
    • "264 mongol rally" +
    • date of trip +
    • people who were on it +
    • then there are a lot of tick boxes. The explanations for these will come later. +
    +
  8. 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. +
+ +

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

The original notes and sketches should be filed in the clearly marked +wallet - don't take them caving again and don't leave them lying around to +be "Gössered"!

+ +

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

+ + + +

Scan the notes into the online wallet

+ +

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

+/expofiles/surveyscans/2018/2018#22/
+
+

This is where the scanned copies of the survey notes are kept. +

If your initial backup photos of your notes were poor quality, use the +scanner in the potato hut to make better copies. + +

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

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#22 it is: +

+/home/expo/expofiles/surveyscans/2018/2018#22/
+
+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 documented for uploading your expo photographs. 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. + +

Typing in the survey data in survex format

+

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

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

Survex cave data belongs in the repository "loser", e.g. +loser "caves-1623/264/mongolrally.svx". +

If you have never worked with the distributed version control system before, +then you will be using the expo laptop to create the .svx file and +you will put it in the folder +

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

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

+ +

Running survex to create a centre-line

+

to be documented + +

Transcribing and re-scanning your sketches

+

to be documented + +

Using tunnel for final survey production

+

to be documented + +

Tunnel only produces plan surveys, but they are very pretty. + +

+ + + + diff --git a/handbook/survey/pdanotes.html b/handbook/survey/pdanotes.html new file mode 100644 index 000000000..9feb201b0 --- /dev/null +++ b/handbook/survey/pdanotes.html @@ -0,0 +1,23 @@ + + +Survey Handbook + + + +

CUCC Expedition Survey Handbook

+

PDA additional notes

+

This is where you learn how to use a PDA with the CUCC expo survey process instead of using pencil and notebook. +

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

+ + + +