QGIS TUFLOW Increment Layer: Difference between revisions

Content deleted Content added
No edit summary
Line 1:
= Introduction =
This tool takes the active layer (as selected in the layer control) and saves a copy of this with a new filename. By default the currently open file will be closed and the new version opened, however there is the option to keep both versions open in the workspace. The new layer will adopt the same styling as the old layer.<br>
 
<br>
=== Running the Tool== =
The tool can be found in the TUFLOW Plugin toolbar, or via the QGIS menu '''Plugins >> TUFLOW >> Editing >> Increment Selected Layer'''.<br><br>
[[File: increment_layer_toolicon.PNG]]<br>
Line 17 ⟶ 18:
The tool also checks if an existing file with the name and location specified already exists, if so, a warning will appear alerting the user. If the existing layer is open in QGIS (or another GIS program) the tool will produce an error.
<br>
<Brbr>
 
=== Working with GPKG== =
''Available since v3.3''<br>
If the source layer is a GPKG, the user will be given additional options:<Br>
'''Note:''' <bu>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder|Save layer out into superseded folder]]</bu> is available since v3.7.0.25''<br>
: [[File: increment_layer_spatial_database_options.PNG]]
A summary of the options is described below and more details are given further on:
* '''<u>[[QGIS_TUFLOW_Increment_Layer#Increment_Layer_Only|Increment Layer Only]]</u>''' - this only saves the individual layer from the GPKG database into a new or existing GPKG database. Other layers in the GPKG will not be copied.
* '''<u>[[QGIS_TUFLOW_Increment_Layer#Increment_Layer_and_Preserve_Database|Increment Layer and Preserve Database]]</u>''' - this option allows the user to increment or copy multiple layers from the same GPKG into a new or existing GPKG.
* '''<u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder|Save Layer Out Into Superseded Folder]]</u>''' - this saves the currently selected layer into a new location but does not open it in QGIS. This option allows users to use centralised databases without having to increment the entire database each time. The user saves the superseded layer into a new location for posterity and continues to work with the layer in the centralised database.<Br>
 
==== Increment Layer Only== ==
This option saves the layer selected in the dropbox into a new or existing GPKG. Other layers in the GPKG will not be copied or incremented in the process. The tool automatically provided an incremented name (that the user can edit) for the output database and layer name when the layer is selected in the dropdown box. The ability to move the old layer to the superseded folder and/or keep the old layer open is available for this increment option.
 
==== Increment Layer and Preserve Database== ==
This options gives the user the ability to copy or increment multiple layers from the same GPKG. All layers in the GPKG will be listed for the user to decide what to do with: the options are to copy, increment, or discard. A given layer will be copied if it is checked on, it will be incremented if is checked on and new name is provided in the right column, and a given layer will discarded (i.e. not copied) if the layer is checked off. The tool will automatically give an incremented name of the layer selected in the dropdown box and will automatically update the datasource of any open layers in QGIS if required. To increment multiple layers within the same GPKG, it is possible to manually edit the filename of any layer in the incremented the GPKG within the 'Incremented Layer' column.
<br> The option to move superseded files to a new separate folder and/or keep the old layers open is available for this increment option.
Line 38 ⟶ 40:
[[File: increment_layer_spatial_database_preserve_database.PNG]]<Br>
 
=== Save Layer Out Into Superseded Folder= ==
The option saves the layer selected in the dropdown box into a new location (called a superseded folder by the tool) and keeps the current layer open in QGIS. This option allows users to use a centralised database without having to increment the entire database each time. The user saves the superseded layer in a new location for posterity and continues to work the layer in the centralised database. The user is given the option to let the tool automatically supersede the layer or customise the supersede location. The automatic option will save the layer into a folder called 'ss' in the same location as the GPKG (each layer will be given a new GPKG with the same name as the layer).<br>
<Br>
Line 45 ⟶ 47:
<Br>
 
=== Examples== =
'''Example 1 - Shapefile'''<Br>
[[File: increment_layer_example.gif]]
Line 53 ⟶ 55:
[[File: increment_layer_example_gpkg.gif]]
<Br>
 
<br>
 
{{Tips Navigation
|uplink=[[TUFLOW_QGIS_Plugin#Usage| Back to TUFLOW QGIS Plugin Main Page]]