forked from lachlangrose/GeoTrace
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathinstructions.html
36 lines (35 loc) · 2.5 KB
/
instructions.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<!DOCTYPE html>
<html>
<body>
<h1>Installing Dependencies</h1>
<p>It looks like your are missing a required dependency for GeoTrace! GeoTrace uses Numpy, Matplotlib, mplstereonet and scikit-image, so you will need to make sure these are installed for your python distribution. QGis should come bundled with Numpy and Matplotlib. The other packages can be installed using pip.</p>
<h2>Windows</h2>
<p>Installing mplstereonet and scikit-image on Windows can be a little tricky, as skimage contains uncompiled c-code. The following instructions should work in most cases however:</p>
<ol>
<li>Open the start menu and search for OSGeo4W Shell. Right-click on it and select Run as administrator. This tool gives you access to the qGIS version of python</li>
<li>Check pip (a python package manager) is up to date with the following: python -m pip install --upgrade setuptools</li>
<li>Install mplstereonet first, using the following command: python -m pip install mplstereonet</li>
<li>Download precompiled 32 bit python wheels for cython and scikit-image 2.7 (otherwise you need to install a c-compiler) from:</li>
<ul>
<li> http://www.lfd.uci.edu/~gohlke/pythonlibs/#cython</li>
<li> http://www.lfd.uci.edu/~gohlke/pythonlibs/#scikit-image</li>
</ul>
<li>Navigate the console to the directory containing these downloaded wheels: cd C:/DirectoryName/Wheels</li>
<li>Install each package using pip: python -m pip install Cython-0.26-cp27-cp27m-win32.whl and python -m pip install scikit_image-0.13.0-cp27-cp27m-win32.whl</li>
</ol>
<p>Assuming these all installed correctly, you should now be set to use the plugin after you restart QGIS<p>
<h2>Linux/OXS</h2>
<p>Linux and OSX should be much simpler because they have a working C compiler.</p>
<ol>
<li>Open a terminal window 'ctrl+alt+t'</li>
<li>Install mplstereonet first, using the following command: sudo pip install mplstereonet</li>
<li>Install scikit-image using the following command: 'sudo pip install scikit-image'</li>
</ol>
<h2>Further Reading and Citation</h2>
<p>If you found this tool useful, please cite <i>Thiele et al., 2017</i>. The publication also contains a more detailed description of the methods employed by this plugin.</p>
<p>
<i>Thiele, S. T., Grose, L., Samsu, A., Micklethwaite, S., Vollgger, S. A., and Cruden, A. R.: Rapid, semi-automatic fracture and contact mapping for point clouds, images and geophysical data, Solid Earth, 8, 1241-1253, https://doi.org/10.5194/se-8-1241-2017, 2017</i>
</p>
<p></p><p></p>
</body>
</html>