mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-11-22 23:31:56 +00:00
93 lines
5.6 KiB
HTML
93 lines
5.6 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>Handbook Troggle Architecture</title>
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
|
</head>
|
|
<body><style>body { background: #fff url(/images/style/bg-system.png) repeat-x 0 0 }</style>
|
|
<h2 id="tophead">CUCC Expedition Handbook</h2>
|
|
<h1>Troggle Architecture</h1>
|
|
<style>figure {font-weight: bold; font-size: small; font-family: sans-serif;font-variant-caps: small-caps;}</style>
|
|
|
|
<h3>Troggle data architecture</h3>
|
|
<p>
|
|
The core of troggle is the data architecture: the set of tables into which all the cave survey and expo data is poured and stored. These tables are what enables us to produce a large number of different but consistent reports and views.
|
|
<div style="display: flex">
|
|
<div style="flex: 50%">
|
|
<figure>
|
|
<a href="../i/troggle-tables.jpg">
|
|
<img src="../t/troggle-tables-small.jpg" /></a>
|
|
<br><figcaption>Tables (Objects)</figcaption>
|
|
</figure>
|
|
</div>
|
|
<div style="flex: 50%">
|
|
<figure>
|
|
<a href="../i/trogpkg.jpg">
|
|
<img src="../t/trogpkg-small.jpg" /></a>
|
|
<br><figcaption>Packages</figcaption>
|
|
</figure>
|
|
</div></div>
|
|
<p>
|
|
ALSO there have been tables added to the core representation which are not anticipated in that document of this diagram, e.g. Scannedimage, Survexdirectory, Survexscansfolder, Survexscansingle, Tunnelfile, TunnelfileSurvexscansfolders, Survey. See <a href="datamodel.html">Troggle data model</a> python code (15 May 2020) and click on the Class Diagram below on the right.
|
|
<div class="onright">
|
|
<figure>
|
|
<a href="../l/trogclass-1.html"><img src="../t/trogclass-1.jpg"></a>
|
|
<br><figcaption>Class Diagram (draft)</figcaption>
|
|
</figure>
|
|
</div>
|
|
<h3>Architecture and purpose</h3>
|
|
|
|
<p>Read the proposal: "<a href="/expofiles/documents/troggle/troggle_paper.pdf" download>Troggle: a novel system for cave exploration information management</a>", by Aaron Curtis</em>. But remember that this paper is an over-ambitious proposal. Only the core data management features have been built. We have none of the "person management" features, none of the "wallet progress" stuff and only two forms in use: for entering <var>cave</var> and <var>cave entrance</var> data.
|
|
|
|
<h3>Implementation in software</h3>
|
|
<p><a href="http://www.djangoproject.com/"><img class="onright" src="https://www.djangoproject.com/m/img/badges/djangopowered126x54.gif" border="0" alt="Powered by Django." title="Powered by Django." /></a>
|
|
Troggle is written in Python (about 6,400 lines excluding comments) and is built on the Django framework. Before starting to work on Troggle it might be a good idea to run through an initial install and exploration of <a href="https://code.djangoproject.com/wiki/Tutorials">a tutorial Django project</a> to get the Django concepts bedded down - which are not at all obvious and some exist only within Django.
|
|
|
|
<p>
|
|
|
|
Django is the thing that puts the survey data in a database in a way that helps us write far less code to get it in and out again, and provides templates which make it quicker to maintain all the webpages.
|
|
See the <a href="https://docs.djangoproject.com/en/3.0/misc/design-philosophies/">django design philosophy</a> for why we chose it: while django comes with a full stack (db, request/response, URL mapping, HTML templates) the layers of the stack are independent and individually replaceable.
|
|
|
|
<p>We have to keep up to date with new rleases of django, see <a href="trogdjango.html">Upgrading Django for Troggle</a>.
|
|
|
|
|
|
<h3>Troggle parsers and input files</h3>
|
|
<div class="onright">
|
|
<figure>
|
|
<a href="https://djangobook.com/mdj2-django-structure/"><img src="mtv_drawing2.jpg"></a>
|
|
<br><figcaption>Django server and webpage (client)</figcaption>
|
|
</figure>
|
|
</div>
|
|
<p>To understand how troggle imports the data from the survex files, tunnel files, logbooks etc., see the <a href="trogimport.html">troggle import (databaseReset.py)</a> documentation.
|
|
<p>The following separate import operations are managed by the import utility <a href="trogimport.html">(databaseReset.py)</a>:
|
|
<ul>
|
|
<li>expo logbooks
|
|
<li>folk (people)
|
|
<li>wallets of notes & scans (surveyscans)
|
|
<li>cave survey data - survex files
|
|
<li>QMs - question marks
|
|
<li>drawings - tunnel & therion files
|
|
|
|
</ul>
|
|
|
|
|
|
<h3>Files generated by troggle</h3>
|
|
<p>There are only two places where this happens. This is where online forms are used to create cave entrance records and cave records. These are created in the database but also exported as files so that when troggle is rebuilt and data reimported the new cave data is there.
|
|
|
|
<h3>Helpful tools and scripts</h3>
|
|
<img class="onleft" width = "100px" src="https://mariadb.com/kb/static/images/logo-2018-black.95f5978ae14d.png">
|
|
<img class="onright" width = "80px" src="https://sqlite.org/images/sqlite370_banner.gif">
|
|
<p>The public server uses a <a href="https://mariadb.org/about/">MariaDB SQL database</a> and development is usually done using a single-user <a href="https://sqlite.org/about.html">sqlite database</a> which is a standard django option.
|
|
<p>
|
|
You will find it very useful to see what is going on if you look directly at the data in the database (just a single file in the sqlite case) and browse the data in the tables. A light-weight, simple db browser is <a href="https://sqlitebrowser.org/">DB Browser for SQLite</a>. Connecting directly the the MariaDB database with a control panel or <a href="https://www.mysql.com/products/workbench/">workbench</a> gives even more tools and documentation capabilities.
|
|
|
|
<hr />
|
|
See: <a href="datamodel.html">Troggle data model</a> in python code <br />
|
|
Return to: <a href="trogintro.html">Troggle intro</a><br />
|
|
Troggle index:
|
|
<a href="trogindex.html">Index of all troggle documents</a><br />
|
|
<hr />
|
|
</body>
|
|
</html>
|