-
Notifications
You must be signed in to change notification settings - Fork 11
/
index.html
132 lines (124 loc) · 12.5 KB
/
index.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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<head>
<style>
body {
font:13.34px helvetica,arial,freesans,clean,sans-serif;
color:black;
line-height:1.4em;
background-color: #F8F8F8;
padding: 0.7em;
}
pre {
margin:1em 0;
font-size:12px;
background-color:#eee;
border:1px solid #ddd;
padding:5px;
line-height:1.5em;
color:#444;
overflow:auto;
-webkit-box-shadow:rgba(0,0,0,0.07) 0 1px 2px inset;
-webkit-border-radius:3px;
-moz-border-radius:3px;border-radius:3px;
}
pre code {
padding:0;
font-size:12px;
background-color:#eee;
border:none;
}
code {
font-size:12px;
background-color:#f8f8ff;
color:#444;
padding:0 .2em;
border:1px solid #dedede;
}
</style>
</head>
<body>
<h1 id="qgis-Geoscience-plugin">QGIS Geoscience Plugin</h1>
<em>Roland Hill</em>
<br>
<em>Your name here! - Please contribute and make this a better, more comprehensive geoscience tool.</em>
<p>Geoscience is offered 'as is' in the hope that it will be useful. No warranty is offered for its suitability for task.</p>
<p><strong><em>Geoscience</em></strong> has the following tools available from the Geoscience menu or accessible from the Geoscience toolbar.</p>
<ul>
<li><img src="icon/DrillSection.png" /> <strong>Drill Hole Tools: </strong> Desurvey holes, project drill hole traces to surface with and without down hole data, generate & display sections. </li>
<li><img src="icon/ReverseLine.png" /> <strong>Vector Tools: </strong> Reverse the direction of lines.</li>
<li><img src="icon/BlackTransparent.png" /> <strong>Raster Tools: </strong> Transparent black or white pixels.</li>
</ul>
<p><strong>Contents</strong></p>
<ul>
<li><a href="#drill-tools">Drill Hole Tools</a></li>
<ul>
<li><a href="#drill-desurvey"><img src="icon/Desurvey.png"/>Desurvey Data</a></li>
<li><a href="#drill-trace"><img src="icon/DrillPlan.png"/>Downhole Data</a></li>
<li><a href="#drill-structure"><img src="icon/DrillStructure.png"/>Downhole structure calculations</a></li>
<li><a href="#drill-section"><img src="icon/DrillSection.png"/>Section Manager</a></li>
</ul>
<li><a href="#vector-tools">Vector Tools</a></li>
<ul>
<li><a href="#reverse-line"><img src="icon/ReverseLine.png"/>Reverse Line Direction.</a> - This is needed when using non-symmetric line symbology (eg normal faults). </li>
</ul>
<li><a href="#raster-tools">Raster Tools</a></li>
<ul>
<li><a href="#transparent-white"><img src="icon/WhiteTransparent.png"/>Transparent White</a> for all selected images</li>
<li><a href="#transparent-black"><img src="icon/BlackTransparent.png"/>Transparent Black</a> for all selected images</li>
</ul>
</ul>
<h2 id="drill-tools"><a name="drill-tools"></a> <img src="icon/DrillSection.png" /> Drill Tools</h2>
<p> Note: There are collar, survey and assay csv files, plus a raster DEM in the <em>testdata</em> directory under the plugin installation directory in case you just want to test the dril hole functions of Geoscience. Some of the holes in these files aren't particularly realistic because they are used for testing unusual situations. (Hint, open the DEM raster first to set the CRS).</p>
<p>Tools to display drill holes, down hole data and sections in QGIS. This includes de-surveying the holes using collar azimuth and dip and/or survey data. Prior to using Drill Tools you need to open the collar, survey (optional) and down hole data (optional) tables in QGIS. You can use any format supported by QGIS including shapefiles, MapInfo Tab files or CSV files (Note: Geoscience doesn't support database layers yet. If your data is in a database, first export your layers as Geopackage, Shapefile etc). To open data using CSV, use the existing Delimited Text tool <img src="doc/csv.png" />.</p>
<p><b>Drill Tools will only work with projected coordinate systems (ie not latitude and longitude)</b></p>
<p>Geoscience will create new layers with names based on the original file names. It's suggested to give your original files short, simple names (eg. Collar.shp, Assay.csv etc). Once Geoscience has created a file name then you shouldn't change it because Geoscience might not be able to identify the file again.</p>
<p>The workflow to display the surface projection of drill traces follows. You will also need to do this if you want to display sections.
<ol>
<li>Open the <b>Collar</b> layer. If using the Delimited Text tool in QGIS, select <b>Point Geometry</b> and the appropriate columns for Easting and Northing, followed by the Coordinate Reference System.</li>
<li>(Optional) Open the <b>Survey</b> layer. If using the Delimited Text tool in QGIS, select <b>No Geometry</b> to just import the data columns.</li>
<li>(Optional) Open the <b>Down hole data</b> layers. You can use multiple layers (eg. lithology and assay) and if you are using the Delimited Text tool in QGIS, select <b>No Geometry</b> to just import the data columns.</li>
<li>Choose <em>Geoscience -> Drilling -> Desurvey Data</em> or click the <img src="icon/Desurvey.png" /> button on the toolbar. Select the appropriate fields. Note that all fields will be guessed by Geoscience if sensible names have been used. Choose the <b>Desurvey Length</b>. Drill holes will be reconstructed using straight line segments of this length. Click OK and a new layer is created and loaded in QGIS. You can now see the surface projection of drill holes.</li>
<li>Choose <em>Geoscience -> Drilling -> Downhole Data</em> or click the <img src="icon/DrillPlan.png" /> button on the toolbar. Choose the source Downhole Data layer and the appropriate attribute fields. Again, these are chosen automatically if sensible names are used. Check all the attribute fields that you want to include in the downhole data layer to be created. <b>You also need to provide a brief descriptive name</b> to be appended to the layer name (a default is provided).</li>
<li>The downhole trace layer is created and loaded into QGIS with each row containing one line segment for each interval from the source. You then need to Symbolise the new layer to display the attributes as you desire.</li>
</ol>
<h2 id="sections"><a name="sections"></a>Sections</h2>
<p>Sections are generated by defining start and end coordinates, a width and which layers to include in the section. Sections will be transformed to a new coordinate system based on distance along the section from the start point and the real elevation as calculated in the <b>Desurvey</b> stage. This means that your sections are displayed on the same map canvas as the rest of your data. Usually this will be in a different part of space to your normal, plan-based spatial data and won't be a problem. If your regular data uses coordinates near 0E, 0N, then you might want to move it all to a single group in the Layer Tree so that you can switch it on and off easily. Sections will be placed in their own group automatically.</p>
<p>Geoscience will store all the metadata required to recreate a section in your QGIS Project file. Generated section layers are only <b>Memory Layers</b> and will be lost when QGIS is closed, however they can easily be regenerated when you open your project again. Similarly, you can remove sections from the Layer Tree and then regenerate them later. The only way to delete sections permanently is via the Section Manager.</p>
<p>The <b>Section Manager</b> displays all sections in the box on the left. You can double click sections in the box to display them. Also, the <b>Section</b> layer tree group is set as mutually exclusive, so you can switch between sections by clicking their groups on and off.</p>
<p>You can <b>Recreate</b> or <b>Delete</b> multiple sections by selecting their check boxes first. When you recreate a section, Geoscience will replace any existing empty Memory Layers already in the section's group in the layer tree.</p>
<p>Geoscience will create a top level Group called <em>Sections</em>. All sections you create will be placed under this in their own Group so that you can switch all the section layers on and off together.</p>
<p>Sections are normal QGIS layers. You can use any of the Symbology, labelling tools etc as normal. You can also create a Layout to produced scaled and annotated plots.</p>
<p>Geoscience will generate three grids and a border with every section. These are placed in a <b>Decorations</b> group so that they can be toggled on and off together. The three grids show where lines of Easting, Northing and Elevation cross the section line. If your section is close to west-east or south-north then one of the grids will be turned off by default. You can turn any of the three grids or border on or off independently.</p>
<p>To generate and display sections.
<ol>
<li>When a section is created, Geoscience copies the style from your down hole data layers to the new section. You should therefore make sure that you are happy with your down hole data styles before generating sections. Note that you can change the down hole data style later, then regenerate the sections to update the section styles if required, but better to get it right the first time.</li>
<li>Open the <b>Section Manager</b> by choosing <em>Geoscience -> Drilling -> Section Manager</em> or click the <img src="icon/DrillSection.png" /> button on the toolbar.</li>
<li>Type in your desired <b>section width</b>.</li>
<li>You have three options to create a section:
<ul>
<li><b>Map Canvas</b> - Use the mouse to draw a section line on the map canvas.</li>
<li><b>West-East</b> - Type in the Northing plus start and end Easting for the section.</li>
<li><b>South-North</b> - Type in the Easting plus start and end Northing for the section.</li>
</ul>
</li>
<li>If Map Canvas is chosen, you then click and drag a section to define the end points. Geoscience will display a moving box of defined section width to assist you. Your section is defined when you release the mouse button.</li>
<li>Once a Map Canvas section is defined, or when you choose to define an orthogonal section, a dialog will ask you to select which vector and raster layers you want to include and choose a name for the section. Check the boxes next to the desired levels then click OK. Note that only vector layers with 3D coordinates and single band raster layers are displayed.</li>
<li>It may take some time to generate the section depending on how many drill holes you have. Once completer, a new drill hole will be added to the Section Manager, a new group containing your section is added to the Layer Tree and the Map Canvas will zoom to your new section. (see Sections for more information)</li>
</ol>
<h2 id="section_interp"><a name="section_interp"></a>Section Interpretation</h2>
<p>You can use QGIS' standard tools to interpret on sections. Create a new vector layer and place it in under the section group with the rest of the layers. This way it will be turned on and off with all the automatically generated layers. When you save your QGIS Project, your interpretation layers will be saved with it. When you re-open your Project and recreate your sections, the Geoscience layers will replace the empty place-holders and your section will be returned to the way you left it.</p>
<p>Don't delete your section in the Section Manager if you have custom interpretation layers. If you do, then you will need to make the section again and move the features from your interpretation layer to match the section.</p>
<h2 id="vector-tools"><a name="vector-tools"></a> <img src="icon/ReverseLine.png" /> Vector Tools</h2>
<ul>
<li id="reverse-line"><img src="icon/ReverseLine.png"/>Reverses the order of all the nodes in the selected line features, in effect reversing the direction of the line. This is necessary when using asymmetric line styles such as reverse and normal fault symbols. Note that the layer must be editable before using the tool.</li>
</ul>
<h2 id="raster-tools"><a name="raster-tools"></a> <img src="icon/BlackTransparent.png" /> Raster Tools</h2>
<ul>
<li id="transparent-white"><img src="icon/WhiteTransparent.png"/>Sets the transparent colour to <b>white</b> for all the raster images selected in the project tree. To use, first select all the rasters you wish to process using control and shift left clicks, then choose this menu entry or toolbar button. Ideal for image sets such as EM channels or hyperspectral images.</li>
<li id="transparent-black"><img src="icon/BlackTransparent.png"/>Sets the transparent colour to <b>black</b> for all the raster images selected in the project tree. To use, first select all the rasters you wish to process using control and shift left clicks, then choose this menu entry or toolbar button. Ideal for image sets such as EM channels or hyperspectral images.</li>
</ul>
<p>
© Roland Hill 2018
<br>
Released under GPL license.
</p>
</body>