expoweb/handbook/survey/qmentry.html

193 lines
9.7 KiB
HTML
Raw Normal View History

2020-01-03 02:56:23 +00:00
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
2022-03-19 22:10:27 +00:00
<title>Handbook - survex - QMs</title>
2020-01-03 02:56:23 +00:00
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook - New Cave - QMs</h2>
<h1>Adding QMs (Question Marks)</h1>
2020-01-03 02:56:23 +00:00
<h2>QM data and cave descriptions</h2>
<p>
This document describes how to include Question Marks (QMs) and cave descriptions in .svx files.
2020-01-03 02:56:23 +00:00
<p>This is the current list of <a href="/cave/qms/1623-290">QMs for 1623-290</a><br />
These are the current <a href="qm.html">QM naming and numbering rules</a>.
2022-12-10 16:09:19 +00:00
2020-01-03 02:56:23 +00:00
<p>There
are dedicated fields in the template.svx file for this purpose, but there has been laxness recently on filling them in.
It seems to be an unknown resource among too many expo-goers despite the manifold benefits.
<h3>Why do we want to do this?</h3>
<p>
2023-04-22 00:23:13 +01:00
We need to store Question Marks (QMs) and cave description data in an easy-to-use format for setting objectives and planning trips. As of the end of the 2022 expo, we have 1,374 QMs tracked in our records.
2020-01-03 02:56:23 +00:00
<p>When planning an expo, it is necessary to work out where leads are in each cave before
arriving in Austria to make effective use of time and equipment. The most readily
accessible place for such information is in .svx files, because this is more efficient
compared to including QMs only in survey drawings in Tunnel or writing a cave
description then putting it on the expo website.
2023-04-22 00:23:13 +01:00
<p>Survex files are a very stable place to store the data long-
2022-03-31 00:34:42 +01:00
term: there is no need to rely on a 'master file' of any kind, which can be problematic if not everyone
2020-01-03 02:56:23 +00:00
on expo has the same level of computer literacy, and requires just basic text entry to create and update
the data after a trip.
2022-03-31 00:22:05 +01:00
<h3>How it's done:</h3>
2020-01-03 02:56:23 +00:00
<p>
2022-03-31 00:22:05 +01:00
So, you've got your .svx file started (if entering new data), or located and opened (if updating a
2020-01-03 02:56:23 +00:00
previously surveyed bit of cave after checking out some QMs again), and it looks a bit like this (visual
format will change depending on your preferred text editor):
<p>
<img src="wob-svx-edit-pic.jpg" width=900>
<p>
2022-04-06 02:07:54 +01:00
If you don't understand what is in front of you here, then you need to read the <a href="newsurvex.html">survey handbook guide on svx files</a> which will lead you to the survex documentation, or ask
2020-01-03 02:56:23 +00:00
someone about basic entry of survey leg and station data into the .svx file format.
<p>
Near to the end of the text in the file, you will see a section that looks like this:
<p>
<img src="wob-svx-edit-pic2.jpg" width=900>
<p>
This is where the action is! You literally just follow the instructions in the file to create QM and cave
description data, replacing the template text with your own as you would with the cave passage data.
<p style="margin:4%">
2023-03-14 16:43:27 +00:00
<em>Technical Note:</em> The syntax for a QM includes a leading semi-colon. So it is syntactically a "comment" so far
as the survex software is concerned. But we have other software and scripts in the Expo online system which inderstand
just fine that these are QMs.
2020-01-03 02:56:23 +00:00
<p>
Here is an example from the last bit of bipedalpassage.svx in 264. Note that each QM description is all on one line.
<pre><code>;-----------
;Question Mark List ;(leave commented-out)
<em>;Serial number grade(A/B/C/D/X) nearest-station resolution-station description</em>
2020-01-03 02:56:23 +00:00
;QM1 A bipedalpassage.1 - Very good. 50m+ (?) deep pit below start of 13 bolt bipedal traverse - rather slanted, large ongoing rift glimpsed below. very good.
;QM2 A bipedalpassage.3 - Very good. 50m+ (?) deep pit below end of 13 bolt bipedal traverse. best approched via station 4 (?) and looks ok to rig. May connect to first deep pit.
;QM3 C bipedalpassage.1 - Poor c lead, across thin rock bridge over abyss (!) leads to blind aven, but small tube for thin person on left.
;QM4 A bipedalpassage.10 - Good. Ongoing big phreatic passage forms pitch dropped in Bipedal Passage4 by Ben, then continued by Mike and Elain on Aug 6th.
;QM5 C bipedalpassage.9 - Speculative - climb up needs short 5-10m rope - could be tube in roof.
;QM6 C bipedalpassage.31 - Very good location where main phreatic passages and enlarges - but far side of chamber choked. One part of choke was not accessed as needs 2m climb up to poke nose in it. A good free climber could do this or needs one bolt to be sure no way on. Very strong draft in choke! Interesting southerly trend at margin of known system
</code></pre>
<p>
The format for question mark lists is <br>
<ul>
2023-03-14 16:43:27 +00:00
<li>QM identifier,
<li><a href="qm.html">Quality Grade</a>,
<li>nearest survey station, (which should be in the same survex file)
<li>resolution survey station, initially a "-", explained in <a href="#tick">Ticking off a QM</a> below
<li>description of QM.
</ul>
2020-05-14 22:53:22 +01:00
<p>The QM numbers themselves used to be in the format <br>
<ul>
2021-12-30 14:56:05 +00:00
<li><a href="qm.html">Discoverer identifier</a>, <li>Year of discovery, <li>Cave identifier, <li>serial number.
</ul>
2022-03-19 22:10:27 +00:00
but today, with the QMs inside the survex files, the identifiers are QM1, QM2 etc.
2021-12-30 16:20:45 +00:00
<p>This format is <a href="qm.html">documented in the original QM conventions</a> page.
2022-03-19 22:10:27 +00:00
<style>figure {font-weight: bold; font-size: small; font-family: sans-serif;font-variant-caps: small-caps;}</style>
<div class="onright">
<figure>
<a href="cavedescription.html">
<img src="../t/svx-cave-descript.jpg"></a>
<figcaption style="font-variant-caps: small-caps;">
<em>Cave description in survex file (click for more)</em>
</figcaption>
</figure>
</div>
2023-03-14 16:43:27 +00:00
<h3>Cave Descriptions</h3>
2022-03-19 22:10:27 +00:00
<p>The description of the passage is written in the same way as you write QMs, but as free text without
formatting. See the single line at the bottom of the figure below and
in more detail on the <a href="cavedescription.html">Cave Description"</a> handbook page.
2023-03-14 16:43:27 +00:00
<h3 id="example">Full QMs example - initial data entry</h3>
2020-01-03 02:56:23 +00:00
<p>
2023-03-14 16:43:27 +00:00
The example below demonstrates correct and effective use of the QM list referring back to earlier elements in the svx
file. Cave descriptions are done in a similar way, see the <a href="cavedescription.html">Cave Description"</a>
handbook page.
2020-01-03 02:56:23 +00:00
<p>
<img src="wob-svx-edit-pic3.jpg" width=900>
<p>
2023-03-14 16:50:01 +00:00
Below is part of the current template file (square brackets must be removed as
real content replaces template text):</p>
<code><pre>;-----------
;Question Mark List ;(leave commented-out)
; The nearest-station is the name of the survey and station which are nearest to
; the QM. The resolution-station is either '-' to indicate that the QM hasn't
; been checked; or the name of the survey and station which push that QM. If a
; QM doesn't go anywhere, set the resolution-station to be the same as the
; nearest-station. Include any relevant details of how to find or push the QM in
; the textual description.
;Serial number grade(A/B/C/D/X) nearest-station resolution-station description
2023-03-14 16:50:01 +00:00
;[ QM1 A surveyname.3 - description of QM ]
;[ QM2 B surveyname.5 - description of QM ]
;TICKed off QMs
; in the past, if another survey existed, the resolution-station
; field was filled in, e.g.
;[ QM2 B surveyname.5 anothersurvey.7 description of QM and description of progress ]
; or we can use the trial format
;Serial number TICK date resolution description
;[QM2 TICK 2022-07-20 This is an example ticked QM]
</pre></code>
<p>
2020-01-03 02:56:23 +00:00
If these data are not entered along with the rest of the survey data, it is as if you decided not to enter
some of the actual passage data you surveyed: information is being lost and someone will have to
trawl back through all the survey data at a later time to keep it up-to-date, a very tedious task which
is a very inefficient use of time.
2023-03-14 16:43:27 +00:00
<p>Also if the person reading it hasn't been to the bit of cave (which is, like, <em>the whole point</em>, then the
data has a higher chance of being incorrect. It is not always easy to interpret Tunnel or Therion drawings correctly
with this sort of thing.
<h4 id="tick">Ticking off a QM</h4>
<p>Since 2015 we have had no generally-agreed, well-documented or widely-practiced way of recording whether a QM has been ticked-off or not.
<p>In the past, this was done by
<ol>
<li>surveying into the passage beyond the QM,
<li>creating a new survex file for that survey,
and then
<li>editing the original survex file using the name of one of those new survey stations as the "resolution-station", replacing the "-" previously there.
</ol>This meant that a QM
could only be ticked-off if there was, in fact, surveyable passage beyond it, and if it was worth surveying, and if
someone did so.
<p>In 2022 we had a proposal to add an extra line to the original survex file, now that survex files can be edited
easily on-line (and the version control happens invisibly and automatically):
<code>
QM<em>nn</em> TICK <em>date comment</em>
</code>
e.g.<code>
QM15 TICK 2022-07-20 This is a dummy ticked QM</code>
<p>as illustrated in
<a href="/cave/qms/1623-258/2015-15Aflashh2">2015-15A</a>
in <a href="/survexfile/caves-1623/258/flashhard2.svx">258/flashhard2.svx</a>. <br>
The TICKed QM appears at the end of the report <a href="/cave/qms/1623-258">/cave/qms/1623-258</a> at the bottom of the page.</p>
<p>The <var>date</var> field is sufficient to tie the tick-off event to one of a small number of logbook entries and survex files, which is where the actual exploration would be documented. If it was a rapid dead-end, or if later parties can't find it at all, then there should be just a logbook entry.
2020-01-03 02:56:23 +00:00
<h3>Programming note</h3>
<p>Better handling of historic QMs is a current, occasionally active, area of
development in our online systems. The current status is <a href="../troggle/scriptsqms.html">documented here</a>.
2020-01-03 02:56:23 +00:00
<h3>Conclusion</h3>
<p>Survey data recorded in .svx files is incomplete if there is no QM List data and
cave description data!
<hr />
2022-03-19 22:10:27 +00:00
<p>Return to "<a href="newsurvex.html">Survey handbook - survex format</a>".</p>
2020-01-03 02:56:23 +00:00
</body>
</html>