expoweb/handbook/survey/ententryfields.html
2023-07-24 01:30:41 +03:00

135 lines
5.6 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>CUCC Expedition Handbook: Cave entry field</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Entrance entry page fields</h1>
<p>There are a lot of fields on the 'new/edit cave' page and the 'new/edit entrance' page and
some of them are a quite mysterious. This page explains what they mean. The same fields appear in each entrance_data/ xml file.</p>
<p>
Instructions on how to enter the data for new
caves and entrances, and especially how to add images/surveys so that they appear properly,
is to be found on the sequence of pages <a href="caveentry.html">starting here</a>. For entrance data, you will use the online form New Entrance whcih is a link on the cave escription page, e.g. look at the page for cave 1623-172 : <a href="/1623/172.htm">172</a> and scroll down until you see the link text "New Entrance".
</p>
<h3>Only one field is essential for Entrances</h3>
<p>There is only one essential field which must be there before the Submit button will work:
<ul>
<li><b>marking</b> e.g. Tag or Paint
</ul>
<p>See below for explanations.
<h2>List of New Entrance/Entrance_data fields</h2>
<dl>
<dt>non_public</dt>
<dd>'False' or 'True'. True if the cave should only be visible to logged-in users. Caves
are normally public, so enter 'False' unless you know otherwise.</dd>
</dl>
<dt>entrance_description</dt>
<dd>the description of the entrance itself goes here (the description of the approach to the entrance is further down). <em>HTML freeform field.</em></dd>
<dl>
<dt>explorers</dt>
<dd>Names or just 'CUCC 1978'. <em>HTML freeform field.</em></dd>
</dl>
<dt>map_description</dt>
<dd>Not very useful unless it is near a marked point on a map. <em>HTML freeform field.</em></dd>
<dt>location_description</dt>
<dd>Context in the frame of other local features. <em>HTML freeform field.</em></dd>
<dt>underground_description</dt>
<dd>the description of the entrance passage or pitch. <em>HTML freeform field.</em></dd>
<dl>
<dt>photo</dt>
<dd>Put an <img> tag in here, as for the cave description. See how images are managed for caves, and do the same thing for this entrance. <em>HTML freeform field.</em></dd>
</dl>
<dl>
<dt>marking</dt>
<dd>A dropdown: .Paint, Tag, etc.</dd>
</dl>
<dl>
<dt>marking_comment</dt>
<dd>A text field: where is the tag? <em>HTML freeform field.</em></dd>
</dl>
<dl>
<dt>Findability</dt>
<dd>Dropdown: values are Coordinates, Lost, Refinable, and To Be Confirmed </dd>
</dl>
<dl>
<dt>Findability description</dt>
<dd>Normally empty, but place for anything else that should be noted, such as info on cave maybe being a duplicate, or lost. <em>HTML freeform field.</em></dd>
</dl>
<dl>
<dt>Altitude (metres)</dt>
<dd>In old caves this will have been calculated in UTM coordinates. Enter your GPS value here (WGS84). Yes, altitudes are slightly different. This will be overwritten in due course by an altitude derived from the location and the lidar dataset.</dd>
</dl>
<dl>
<dt>Northing</dt>
<dd>calculated position in UTM</dd>
</dl>
<dl>
<dt>Easting</dt>
<dd>calculated position in UTM</dd>
</dl>
<dl>
<dt>latitude</dt>
<dd>Decimal degrees of longitude in WGS84 datum. To be entered when entrance is first found so that someone can find it again. Will be overwritten in due course by proper survey data which will be enforced to be consistent with the UTM position.</dd>
</dl>
<dl>
<dt>longitude</dt>
<dd>Decimal degrees of longitude in WGS84 datum. To be entered when entrance is first found so that someone can find it again. Will be overwritten in due course by proper survey data which will be enforced to be consistent with the UTM position.</dd>
</dl>
<dl>
<dt>tag_station</dt>
<dd>a survey station id [to be documented further - use Edit This Page!]</dd>
</dl>
<dl>
<dl>
<dt>exact_station</dt>
<dd>a survey station id [to be documented further - use Edit This Page!]</dd>
</dl>
<dl>
<dl>
<dt>other_station</dt>
<dd>a survey station id [to be documented further - use Edit This Page!]</dd>
</dl>
<dl>
<dt>other_description</dt>
<dd>[undocumented?] Filename?: the name of top-level description file for this cave, when a separate file is used. Used instead of above entrance_description field for large caves with complex descriptions. Blank if the description is in the 'underground_description' field. </dd>
</dl>
<dl>
<dt>bearings</dt>
<dd>For locating the entrance by bearings to well-known peaks - archaic.</dd>
</dl>
<dl>
<dt>url</dt>
<dd>Usually blank</dd>.
</dl>
<h4>ALternative data entry using a file</h4>
<p>
There are template files for you to fill-in when creating new caves and entrance in the online system. You will need to be on a machine which has
<a href="../computing/keyexchange.html">keys installed</a> and you will need to know how to use git.
<p>Download them:
<ul>
<li><a download href="../../templates/cave_data.html">cave_data template</a>
<li><a download href="../../templates/entrance_data.html">entrance_data template</a>
</ul>
<p>
These are actually XML files, not HTML files, using special tags which are used by the online system to create the webpages in combination with numerical survey data. Instructions are within each file.
</p>
<hr />
<p>Back to <a href="caveentry.html">Cave data entry</a>
<hr /></body>
<html>