mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-11-26 09:11:59 +00:00
118 lines
8.4 KiB
HTML
118 lines
8.4 KiB
HTML
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
||
|
|
<title>CUCC Expedition Handbook: Programmers manual</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<h2 id="tophead">CUCC Expedition Handbook - Your laptop</h2>
|
||
|
|
|
||
|
|
<h1>Setting up an Expo laptop</h1>
|
||
|
|
|
||
|
|
<h3>Operating Systems</h3>
|
||
|
|
<ul>
|
||
|
|
<li>The quickest way to get a complete setup is to use a <b>Debian Linux laptop</b>.
|
||
|
|
<br>
|
||
|
|
The <i>expo laptop</i> uses <a href="https://www.debian.org/intro/about">Debian</a> with the <a href="https://computingforgeeks.com/how-to-install-cinnamon-desktop-environment-on-debian/">Cinnamon</a> interface, but pretty much any Linux system works fine. This handbook does assume that you are using apt - the Debian package manager - which is good for all Debian-derived Linuxes such as <a href="https://ubuntu.com/">Ubuntu</a>. Old, slow machines without much memory can be very effective with <a href="https://xubuntu.org/">Xubuntu/xfce</a>.
|
||
|
|
|
||
|
|
<li>Windows machines can do everything needed, but some useful software has no Windows version and you will need to find your own equivalents. There are also dangerous 'gotchas' to look out for because the file-naming system is different. Do use Linux instead if you can.
|
||
|
|
|
||
|
|
<li>WSL: the Windows Subsystem for Linux. The first release of this didn't do the ssh key exchange process easily. The <a href="https://docs.microsoft.com/en-us/windows/wsl/install-win10">2019 WSL2 release</a> includes a complete Linux kernel. If you want to use this, then please do - and write the handbook documentation too. But beware, it can work in <a href="https://docs.microsoft.com/en-us/windows/wsl/wsl2-index">two different modes</a> which behave differently.
|
||
|
|
|
||
|
|
<li>Mac users will need to use the Linux documentation as a guide and work it all out for themselves.
|
||
|
|
|
||
|
|
<li>Android phone apps can be very handy too.
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h3>Software</h3>
|
||
|
|
<p>Long-standing Expo policy is to retain absolute control of all software and all data. So we use <a href="https://en.wikipedia.org/wiki/Free_and_open-source_software">FOSS software</a> and we store data in text files not in a database. You can use other software on your own machine if it is format-compatible and exports data in the formats we want, but all the recommended software here is open source and please don't install proprietary software on the '<em>expo laptop</em>'.
|
||
|
|
<p>The list of software:
|
||
|
|
<ul>
|
||
|
|
<li>mercurial
|
||
|
|
<li>git
|
||
|
|
<li>TortoiseHg
|
||
|
|
<li>scp and ftp GUI software, such as <a href="../fzconfig.html">Filezilla</a> - with a configuration file to get to the expo server
|
||
|
|
<li><a href="https://tortoisegit.org/support/faq/#prerequisites">TortoiseGit</a> - GUI interface to git. Optional.
|
||
|
|
<li>Survex, including the Aven visualisation tool.
|
||
|
|
<li><a href="https://github.com/CaveSurveying/tunnelx">Tunnel</a>: a Java 2.5D cave drawing program surveys based on Survex-compatible data which can also read PocketTopo files. (Generally called 'tunnel' even though the project and executable is actually 'tunnelx'.)
|
||
|
|
<li><a href="https://therion.speleo.sk/">therion.speleo.sk/</a>Therion - Therion processes survey data and generates maps or 3D models of caves.
|
||
|
|
<li><a href="https://www.qgis.org/en/site/">QGIS</a> - A Free and Open Source Geographic Information System
|
||
|
|
<li><a href="https://activityworkshop.net/software/gpsprune/development.html">GPSprune</a> - to edit GPS tracks in GPX files. Just download the .jar file.
|
||
|
|
<li><a href="https://www.java.com/en/">java</a> - needed to run GPSprune
|
||
|
|
<li><a href="https://sourceforge.net/projects/viking/">Viking</a> - an alternative to GPSprune. The <a href="https://github.com/viking-gps/viking">code</a> is on github.
|
||
|
|
<li>python, if you are extending troggle or the scripts in expoweb/noinfo/ - already installed on Linux
|
||
|
|
<li>python packages you will want to install: [<em>not yet documented</em>]
|
||
|
|
</ul>
|
||
|
|
<p>Nearly all the Austrian survey has beeen produced using Tunnel but we are moving to Therion for new caves because Therion does elevations properly and Tunnel never will.
|
||
|
|
|
||
|
|
<p>For Windows users only:
|
||
|
|
<ul>
|
||
|
|
<li><a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html">PuTTY</a> including pagent. Version 0.73 was released on 2019-09-29. You need this to generate and to use ssh keys on Windows.
|
||
|
|
<li><a href="https://gitforwindows.org/">Git for Windows</a>
|
||
|
|
<li><a href="https://www.python.org/downloads/windows/">python for windows</a>. We are using python 2.7 not 3.8.
|
||
|
|
<li>WinScp can be used instead of Filezilla, see
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>For Android phones:
|
||
|
|
<ul>
|
||
|
|
<li><a href="ftpusage.html">FTP using Cx_File_Explorer</a> (this is probably out of date)
|
||
|
|
<li><a href="https://www.termius.com/">Terminus</a> - command line ssh to login to the expo server.
|
||
|
|
<li>OsmAnd - GPS app. See separate pages on using GPS software
|
||
|
|
<li><a href="../uploading.html#android">andftp</a> app
|
||
|
|
<li><a href="https://sites.google.com/site/speleoapps/home">TopoDroid</a> makes cave surveys with the DistoX.
|
||
|
|
<li><a href="https://sites.google.com/site/speleoapps/home">Cave3D</a> is a Therion 3D viewer.
|
||
|
|
<li><a href="https://sites.google.com/site/speleoapps/home">ThManager</a> organizes single surveys, exported by TopoDroid, into Therion projects encoded by Therion "thconfig" files.
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
<h3>Logins to external systems</h3>
|
||
|
|
<ul>
|
||
|
|
<li><a href="https://github.com/join">Github</a> - create your own github account if you don't have one already.
|
||
|
|
<li><a href="https://bitbucket.org/product/">Bitbucket</a> - create an account to help develop tunnel.
|
||
|
|
<li><a href="https://trac.survex.com/wiki">Trac issue tracker and wiki</a> for survex
|
||
|
|
<li><a href="https://launchpad.net/">Launchpad</a> - create an account to help develop survex.
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>Bug lists and open issues are discussed on the github <a href="https://github.com/CaveSurveying/CUCCexposurveyissues/issues">CaveSurveying/CUCCexposurveyissues/issues</a> issue list so you will need to subscribe to the Cave Surveying Group on github to participate.
|
||
|
|
|
||
|
|
<p><a href="https://github.com/CaveSurveying/CUCCexposurveyissues/wiki/Expo-tunnel-workflows">github.com/CaveSurveying/CUCCexposurveyissues/wiki/Expo-tunnel-workflows</a> is a wiki on github discussing workflows to generate centerlines, GEOTIFF and QGIS integration.
|
||
|
|
|
||
|
|
<p><a href="https://launchpad.net/survex">launchpad.net/survex</a> - the main Survex development system.
|
||
|
|
|
||
|
|
|
||
|
|
<h3>Configuration</h3>
|
||
|
|
|
||
|
|
You need to do the
|
||
|
|
<a href="computing/keyexchange.html">key exchange</a> process - which you can only do entirely on your own if
|
||
|
|
you have access to the <i>expo laptop</i> to upload and install the public key generated by your laptop.
|
||
|
|
|
||
|
|
<p>On a Windows machine you will need to configure pageant (the putty authentication agent)
|
||
|
|
to <a href="https://blog.shvetsov.com/2010/03/making-pageant-automatically-load-keys.html">run at startup to load your key</a>. Note that you are loading your <em>private</em> key, the .ppk file, into pageant and that this key never leaves your laptop.
|
||
|
|
|
||
|
|
<p>When using Windows please be <a href="http://expo.survex.com/handbook/survey/getin.htm#filenames">excessively careful when naming files and survex names</a>.
|
||
|
|
|
||
|
|
<p>The handbook has extensive documentation on when and where it is necessary to use scp and ftp to manage large files in 'expofiles'. See <a href="../upload-expert.html">Experts: Uploading files</a>, a href="../uploading.html">Uploading files</a> and <a href="../gpxupload.html">Uploading GPS tracks</a>. Only machines which have done the key exchange process can do scp, ftp or rsync.
|
||
|
|
|
||
|
|
<h3>Learning how to use this software</h3>
|
||
|
|
<img src="/expofiles/tunnelwiki/wiki/images/6/65/Banner204.png" align="right" width=100>
|
||
|
|
<p>For Survex, Tunnel and Therion, see the <a href="http://expo.survex.com/handbook/survey/">Expo Surveying Handbook</a>.
|
||
|
|
|
||
|
|
<p><em>For installing Survex, Tunnel etc. see <a href="../getsurvex.html">this page</a> which will be merged in here eventually.
|
||
|
|
|
||
|
|
<p><a href="http://expo.survex.com/expofiles/tunnelwiki/wiki/pages/Tunnel.html">The Tunnel tutorial</a> - installation notes and a wiki of examples and tutorials
|
||
|
|
<p><a href="https://bitbucket.org/goatchurch/tunnelx/src/default/">bitbucket.org/goatchurch/tunnelx</a> - documentation and source code in the bitbucket repository system.
|
||
|
|
|
||
|
|
<p>Quick <a href="qstart-hg.html">reminders for using mercurial</a> at the command line.
|
||
|
|
<p>Full instructions for <a href="../tortoise/tortoise-win.htm">installing TortoiseHg and PuTTy on Windows</a>
|
||
|
|
<hr />
|
||
|
|
|
||
|
|
<div id="menu">
|
||
|
|
<ul id="links">
|
||
|
|
<li><a href="../index.htm">Handbook</a>
|
||
|
|
|
||
|
|
<li><a href="../../infodx.htm">Main index</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|