expoweb/handbook/survey/ententryfields.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.
  
  <h3>Names of identifiers and files</h3>
<p>Always use <b>lower case</b> in names of caves, despite what you might see in historical data. 
<p>So a new cave would be 2023-zz-01 and its entrances would be 2023-zz-01a, 2023-zz-01b and 2023-zz-01c. 
<p>This is to prevent confusion between Windows and Linux machines, and unintentional deletion of data.
  
<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. It has to be in a format similar to this: "1623.p204e" (for the 'e' entrance to cave 1623-204)</dd>
  </dl>
  <dl>
   <dl>
    <dt>exact_station</dt>
    <dd>a survey station id. It has to be in a format similar to this: "1623.p204e" (for the 'e' entrance to cave 1623-204)[to be documented further - use Edit This Page!]</dd>
  </dl>
  <dl>
   <dl>
    <dt>other_station</dt>
    <dd>a survey station id.It has to be in a format similar to this: "1623.p204e" (for the 'e' entrance to cave 1623-204)  [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>
entrance data entry 2021-05-07 20:45:25 +01:00			`<!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`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`some of them are a quite mysterious. This page explains what they mean. The same fields appear in each entrance_data/ xml file.</p>`
entrance data entry 2021-05-07 20:45:25 +01:00			`<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,`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`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".`
entrance data entry 2021-05-07 20:45:25 +01:00			`</p>`

form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00
entrance data entry 2021-05-07 20:45:25 +01:00			`<h3>Only one field is essential for Entrances</h3>`
one one required field - online edit of handbook/survey/ententryfields.html 2023-07-23 23:28:51 +01:00			`<p>There is only one essential field which must be there before the Submit button will work:`
entrance data entry 2021-05-07 20:45:25 +01:00
			`<ul>`
			`<li><b>marking</b> e.g. Tag or Paint`
			`</ul>`
			`<p>See below for explanations.`
lower case - online edit of handbook/survey/ententryfields.html 2023-07-24 15:20:19 +01:00
			`<h3>Names of identifiers and files</h3>`
			`<p>Always use <b>lower case</b> in names of caves, despite what you might see in historical data.`
			`<p>So a new cave would be 2023-zz-01 and its entrances would be 2023-zz-01a, 2023-zz-01b and 2023-zz-01c.`
			`<p>This is to prevent confusion between Windows and Linux machines, and unintentional deletion of data.`

Fix mistakes and checking cave & entrance stuff works 2022-10-11 18:31:46 +01:00			`<h2>List of New Entrance/Entrance_data fields</h2>`
entrance data entry 2021-05-07 20:45:25 +01:00			`<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>`
formatting 2023-07-23 23:30:41 +01:00			`<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>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00
entrance data entry 2021-05-07 20:45:25 +01:00
			`<dl>`
			`<dt>explorers</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<dd>Names or just 'CUCC 1978'. <em>HTML freeform field.</em></dd>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00
entrance data entry 2021-05-07 20:45:25 +01:00			`<dt>map_description</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<dd>Not very useful unless it is near a marked point on a map. <em>HTML freeform field.</em></dd>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00
entrance data entry 2021-05-07 20:45:25 +01:00			`<dt>location_description</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<dd>Context in the frame of other local features. <em>HTML freeform field.</em></dd>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00
			`<dt>underground_description</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<dd>the description of the entrance passage or pitch. <em>HTML freeform field.</em></dd>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00
entrance data entry 2021-05-07 20:45:25 +01:00			`<dl>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<dt>photo</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<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>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
			`<dt>marking</dt>`
			`<dd>A dropdown: .Paint, Tag, etc.</dd>`
			`</dl>`
			`<dl>`
			`<dt>marking_comment</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<dd>A text field: where is the tag? <em>HTML freeform field.</em></dd>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
			`<dt>Findability</dt>`
			`<dd>Dropdown: values are Coordinates, Lost, Refinable, and To Be Confirmed </dd>`
			`</dl>`
			`<dl>`
			`<dt>Findability description</dt>`
formatting 2023-07-23 23:30:41 +01:00			`<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>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
			`<dt>Altitude (metres)</dt>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<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>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</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>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<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>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<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>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
			`<dt>tag_station</dt>`
format for tags added - online edit of handbook/survey/ententryfields.html 2023-07-25 20:31:53 +01:00			`<dd>a survey station id. It has to be in a format similar to this: "1623.p204e" (for the 'e' entrance to cave 1623-204)</dd>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
			`<dl>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<dt>exact_station</dt>`
format for tags added - online edit of handbook/survey/ententryfields.html 2023-07-25 20:31:53 +01:00			`<dd>a survey station id. It has to be in a format similar to this: "1623.p204e" (for the 'e' entrance to cave 1623-204)[to be documented further - use Edit This Page!]</dd>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</dl>`
			`<dl>`
			`<dl>`
			`<dt>other_station</dt>`
format for tags added - online edit of handbook/survey/ententryfields.html 2023-07-25 20:31:53 +01:00			`<dd>a survey station id.It has to be in a format similar to this: "1623.p204e" (for the 'e' entrance to cave 1623-204) [to be documented further - use Edit This Page!]</dd>`
entrance data entry 2021-05-07 20:45:25 +01:00			`</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>`

form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<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>`
entrance data entry 2021-05-07 20:45:25 +01:00			`<hr />`
			`<p>Back to <a href="caveentry.html">Cave data entry</a>`
form not file process - online edit of handbook/survey/ententryfields.html 2023-07-23 23:27:22 +01:00			`<hr /></body>`
entrance data entry 2021-05-07 20:45:25 +01:00			`<html>`