Difference between revisions of "QGIS/ARK Grid"

From ARK
Jump to: navigation, search
(Project Wizard)
(ARK Grid)
 
(22 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
A grid wizard allows you to create grids from two known points, or from a known origin and baseline. Interactive tools are provided to convert between local coordinates and map coordinates.
 
A grid wizard allows you to create grids from two known points, or from a known origin and baseline. Interactive tools are provided to convert between local coordinates and map coordinates.
  
[[File:ark_grid.png|center|ARK Grid - Panel]]
+
[[File:ark_grid.png|center|link=|ARK Grid - Panel]]
  
== Project Wizard ==
+
For details on installation, support, licensing, and development, please see the main [[QGIS|ARK QGIS plugins page]]
  
[[File:grid_icon.png|center|ARK Grid - Logo]]
+
== Settings Wizard ==
  
 +
To use ''ARK Grid'' click on the ''ARK Grid'' icon in the main toolbar.
  
[[File:grid_wizard1.png|center|ARK Grid - Project Wizard Page 1]]
+
[[File:grid_icon.png|center|link=|ARK Grid - Logo]]
  
  
[[File:grid_wizard2.png|center|ARK Grid - Project Wizard Page 2]]
+
If you have not run ''ARK Grid'' before then the ''Settings Wizard'' will be run to set up the required grid layers. Your chosen settings will be written into your current QGIS project, you must save your project after the wizard has run otherwise your settings will be lost. If you do not save your settings then the wizard will run again and you will be able to setup where your layers are already saved.
  
 +
[[File:grid_wizard1.png|center|link=|ARK Grid - Project Wizard Page 1]]
  
[[File:grid_wizard3.png|center|ARK Grid - Project Wizard Page 3]]
 
  
 +
Choose where your project home folder is located. If your QGIS project already has a project home folder set then this will be shown as the default folder. The ''ARK Grid'' layers will be saved in the Project Folder in a subfolder 'vector/grid'.
  
[[File:grid_layers.png|center|ARK Grid - New Layers]]
+
[[File:grid_wizard2.png|center|link=|ARK Grid - Project Wizard Page 2]]
 +
 
 +
 
 +
Choose what you want to name the grid layers and layer group, recommended default names are provided. You must have a grid point layer to use for the calculations, but the line and polygon layers are optional.
 +
 
 +
[[File:grid_wizard3.png|center|link=|ARK Grid - Project Wizard Page 3]]
 +
 
 +
 
 +
On clicking Done the required folders and files will be created if they do not already exist. Existing files will '''never''' be overwritten. The layers will then be added to the project ''Layers Panel'' and the ''ARK Grid Panel'' will be displayed. Only the ''Create New Grid'' tool will be enabled at this stage.
 +
 
 +
[[File:grid_layers.png|center|link=|ARK Grid - New Layers]]
 +
 
 +
[[File:grid_panel_new.png|center|link=|ARK Grid - New Panel]]
  
 
== New Grid Wizard ==
 
== New Grid Wizard ==
  
[[File:grid_panel_new.png|center|ARK Grid - New Panel]]
+
To create a new grid, click on the ''Create New Grid'' tool.
 +
 
 +
[[File:grid_new_icon.png|center|link=|ARK Grid - Create New Grid Icon]]
 +
 
 +
 
 +
[[File:grid_wizard_new1.png|center|link=|ARK Grid - New Grid Wizard Page 1]]
 +
 
 +
 
 +
[[File:grid_wizard_new2.png|center|link=|ARK Grid - New Grid Wizard Page 2]]
 +
 
 +
 
 +
[[File:grid_wizard_new3.png|center|link=|ARK Grid - New Grid Wizard Page 3]]
 +
 
 +
 
 +
[[File:grid_wizard_new4.png|center|link=|ARK Grid - New Grid Wizard Page 4]]
 +
 
 +
 
 +
[[File:grid_new.png|800px|center|link=|ARK Grid - New Grid]]
 +
 
 +
 
 +
== Grid Tools ==
 +
 
 +
Once you have created a valid grid, all the ''Grid Tools'' will be enabled.
 +
 
 +
[[File:grid_panel_full.png|center|link=|ARK Grid - Grid Panel]]
 +
 
 +
 
 +
; Current Grid Dropdown
 +
: If you create more than one grid, you can switch between grids using the grid selection dropdown box. Only the selected grid is displayed and used in calculations.
 +
 
 +
[[File:grid_grid_combo.png|center|link=|ARK Grid - Choose Grid Combo]]
 +
 
 +
 
 +
; Map Point Entry
 +
: The ''Map Point'' input boxes display the currently calculated Map Point. You can manually enter a Map Point and the Local Point will be automatically updated.
 +
 
 +
[[File:grid_map_entry.png|center|link=|ARK Grid - Map Point Entry]]
 +
 
 +
 
 +
; Local Point Entry
 +
: The ''Local Point'' input boxes display the currently calculated Local Point. You can manually enter a Local Point and the Map Point will be automatically updated.
 +
 
 +
[[File:grid_local_entry.png|center|link=|ARK Grid - Local Point Entry]]
  
  
[[File:grid_wizard_new1.png|center|ARK Grid - New Grid Wizard Page 1]]
+
; [[File:grid_tool_icon.png|link=|ARK Grid - Identify Grid Coordinates Tool]] Identify Grid Coordinates Tool
 +
: The ''Identify Grid Coordinates'' tool allows you to click on the map and have the Map Point and Local Point coordinates displayed for the point clicked on.
  
  
[[File:grid_wizard_new2.png|center|ARK Grid - New Grid Wizard Page 2]]
+
; [[File:grid_pan_icon.png|link=|ARK Grid - Pan Map Tool]] Pan Map Tool
 +
: The ''Pan Map'' tool will pan the map to the currently entered Map Point.
  
  
[[File:grid_wizard_new3.png|center|ARK Grid - New Grid Wizard Page 3]]
+
; [[File:grid_paste_icon.png|link=|ARK Grid - Paste Map Point Tool]] Paste Map Point Tool
 +
: The ''Paste Map Point'' tool will paste a Map Point in WKT format from the clipboard. This can be used to copy a point from a layer in QGIS.
  
  
[[File:grid_wizard_new4.png|center|ARK Grid - New Grid Wizard Page 4]]
+
; [[File:grid_point_icon.png|link=|ARK Grid - Add Point Tool]] Add Point Tool
 +
: The ''Add Point'' tool adds the current Map Point to the currently selected layer if it is a vector point layer in editing mode.
  
  
[[File:grid_new.png|800px|center|ARK Grid - New Grid]]
+
; [[File:grid_update_icon.png|link=|ARK Grid - Update Layer Coordinates Tool]] Update Layer Coordinates Tool
 +
: The ''Update Layer Coordinates'' tool shows a dialog to let you update a point vector layer to either add the local coordinates as attribute fields or to set the map point from local coordinate attribute fields.
  
  
[[File:grid_panel_full.png|center|ARK Grid - Grid Panel]]
+
; [[File:grid_settings_icon.png|link=|ARK Grid - Run Settings Wizard Tool]] Run Settings Wizard Tool
 +
: The ''Run Settings Wizard'' tool will run the settings wizard.
  
== Licence ==
 
  
All L ~ P : Archaeology plugins are developed under the GPL2 licence, the same as QGIS itself and all plugins in the main QGIS repository. The GPL allows you to freely use and modify the plugin as you wish, provided you share any improvements you distribute back with the community. Share and share alike, it's only fair.
+
; [[File:grid_copy_icon.png|link=|ARK Grid - Copy Point Tool]] Copy Point Tool
 +
: The ''Copy Point'' tool will copy the Map Point or Local Point to the clipboard in WKT format.
  
== Development and Support ==
 
  
Development of ''ARK Grid'' is hosted on GitHub at https://github.com/lparchaeology/ArkGrid.
+
== Layer Styles ==
  
You can open an issue at https://github.com/lparchaeology/ArkGrid/issues, or email ark@lparchaeology.com.
+
The plugin ships with a default set of style files for the grid layers. If you wish to modify the styles, simply save your modified style files into your grid folder with the same names as your grid layers.

Latest revision as of 10:13, 10 August 2016

ARK Grid

A QGIS Plugin to create and work with local site grids as commonly used in archaeology.

A grid wizard allows you to create grids from two known points, or from a known origin and baseline. Interactive tools are provided to convert between local coordinates and map coordinates.

ARK Grid - Panel

For details on installation, support, licensing, and development, please see the main ARK QGIS plugins page

Settings Wizard

To use ARK Grid click on the ARK Grid icon in the main toolbar.

ARK Grid - Logo


If you have not run ARK Grid before then the Settings Wizard will be run to set up the required grid layers. Your chosen settings will be written into your current QGIS project, you must save your project after the wizard has run otherwise your settings will be lost. If you do not save your settings then the wizard will run again and you will be able to setup where your layers are already saved.

ARK Grid - Project Wizard Page 1


Choose where your project home folder is located. If your QGIS project already has a project home folder set then this will be shown as the default folder. The ARK Grid layers will be saved in the Project Folder in a subfolder 'vector/grid'.

ARK Grid - Project Wizard Page 2


Choose what you want to name the grid layers and layer group, recommended default names are provided. You must have a grid point layer to use for the calculations, but the line and polygon layers are optional.

ARK Grid - Project Wizard Page 3


On clicking Done the required folders and files will be created if they do not already exist. Existing files will never be overwritten. The layers will then be added to the project Layers Panel and the ARK Grid Panel will be displayed. Only the Create New Grid tool will be enabled at this stage.

ARK Grid - New Layers
ARK Grid - New Panel

New Grid Wizard

To create a new grid, click on the Create New Grid tool.

ARK Grid - Create New Grid Icon


ARK Grid - New Grid Wizard Page 1


ARK Grid - New Grid Wizard Page 2


ARK Grid - New Grid Wizard Page 3


ARK Grid - New Grid Wizard Page 4


ARK Grid - New Grid


Grid Tools

Once you have created a valid grid, all the Grid Tools will be enabled.

ARK Grid - Grid Panel


Current Grid Dropdown
If you create more than one grid, you can switch between grids using the grid selection dropdown box. Only the selected grid is displayed and used in calculations.
ARK Grid - Choose Grid Combo


Map Point Entry
The Map Point input boxes display the currently calculated Map Point. You can manually enter a Map Point and the Local Point will be automatically updated.
ARK Grid - Map Point Entry


Local Point Entry
The Local Point input boxes display the currently calculated Local Point. You can manually enter a Local Point and the Map Point will be automatically updated.
ARK Grid - Local Point Entry


ARK Grid - Identify Grid Coordinates Tool Identify Grid Coordinates Tool
The Identify Grid Coordinates tool allows you to click on the map and have the Map Point and Local Point coordinates displayed for the point clicked on.


ARK Grid - Pan Map Tool Pan Map Tool
The Pan Map tool will pan the map to the currently entered Map Point.


ARK Grid - Paste Map Point Tool Paste Map Point Tool
The Paste Map Point tool will paste a Map Point in WKT format from the clipboard. This can be used to copy a point from a layer in QGIS.


ARK Grid - Add Point Tool Add Point Tool
The Add Point tool adds the current Map Point to the currently selected layer if it is a vector point layer in editing mode.


ARK Grid - Update Layer Coordinates Tool Update Layer Coordinates Tool
The Update Layer Coordinates tool shows a dialog to let you update a point vector layer to either add the local coordinates as attribute fields or to set the map point from local coordinate attribute fields.


ARK Grid - Run Settings Wizard Tool Run Settings Wizard Tool
The Run Settings Wizard tool will run the settings wizard.


ARK Grid - Copy Point Tool Copy Point Tool
The Copy Point tool will copy the Map Point or Local Point to the clipboard in WKT format.


Layer Styles

The plugin ships with a default set of style files for the grid layers. If you wish to modify the styles, simply save your modified style files into your grid folder with the same names as your grid layers.