|
= 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>
= == Running the Tool == = ▼TheIn QGIS, the tool can be found in the TUFLOW Plugin toolbar, or via the QGIStop dropdown menu '''options Plugins >> TUFLOW >> Editing >> Increment Selected Layer '''. <br><br> ▼
[[File: TUFLOW_plugin_increment_layer.png]]<br>
<br>
Example 'Increment Selected Layer' dialog:<br>
▲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_tooliconIncrement_Layer_01a.PNGpng]]<br>
[[File:QGIS TUFLOW Increment 03.png]]
<br>
The componentsparameters are described below.:
<ol>
<li> '''Source Layer:''' - dropDrop box for selecting the layer to be incremented. This defaults to the current layer currently selected in the layerQGIS controlLayers panel.
<li> '''Output Folder:''' The location for the folder to be saved into. This defaults to the folder location where the current file is saved and is updated if the 'Source Layer' dropbox is changed.
<li> '''Keep source formatting''' - ''Depcrecated'' - this option is no longer available. The source formatting is now always retained (it also no longer creates a .QML file). ▼<li> '''Output FolderFilename:''' - The locationoutput forfile, the foldertool towill beattempt savedto into.guess a Thisfilename defaultsby toincrementing the locationcurrent offilename by 1. For example the currentsource filelayer andwith isname '2d_bc_M10_001_L' will guess '2d_bc_M10_00'''2'''_L'. This will be updated if the '''Source Layer''' dropbox is changed.
<li> '''Move Source Layer to Superseded Folder:''' This option will move the source layer to a new folder call 'SS' (superseded) once the new incremented layer has been created. This is intended to help users keep their GIS files tidy, with only current layers being present.
<li> '''Output Filename''' - The output file, the tool will attempt to guess a filename by incrementing the current filename by 1. For example the source layer with name '''2d_code_M01_001_R''' will guess '''2d_code_M01_002_R'''. This will be updated if the '''Source Layer''' dropbox is changed.
<li> '''MoveRemove/Keep Source Layer toin Superseded FolderWorkspace:''' - This option will movedetermine whether the original source layer to ais newremoved folder call 'SS' (superseded) oncefrom the newworkspace incrementedor layernot. hasIt beenis created.possible Thisto isuse intendedthe option to help'Keep usersSource keepLayer theirin GISWorkspace' filesand tidy,'Move withSource onlyLayer currentto layersSuperseded beingFolder' presenttogether.
<li> '''Remove/Keep Source Layer in Workspace''' - This option will determine whether the original source layer is removed from the workspace or not. It is possible to use the option to keep the source layer in the workspace and "Move Source Layer to Superseded Folder" together.
</ol>
▲<li> :'' Note:'' The 'Keep source formatting' '' - ''Depcrecated'' - this option is no longer available. The source formatting is now always retained (it also no longer creates a .QML file).
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>
=== Working with GPKG==GeoPackage =
:''Available since v3.3''<br>
If the source layer is in a GeoPackage (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]]
[[File: Increment_Layer_02a.png]]<br>
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 savesSaves 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 allowsAllows 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 savesSaves 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.<Brbr>
==== 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 willautomatically tryprovided andan automaticallyincremented name (that the user can edit) incrementfor 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 optionsoption 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 arewhether to copy, increment, or discard. TheA given layer will be copied if it is checked on., The layerit will be incremented if is checked on and new name is provided in the right column., Aand a given layer will discarded (i.e. not copied) if the layer is checked off. The tool will automatically incrementgive thean incremented name of the layer selected in the dropdown box. The tooland will automatically update the datasource of any open layers in QGIS if required. TheTo optionincrement tomultiple movelayers supersededwithin the same GPKG, it is filespossible to amanually newedit separatethe folderfilename and/orof keepany layer in the oldincremented layersthe openGPKG iswithin availablethe for'Incremented thisLayer' optioncolumn.<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.<br>
[[File: increment_layer_spatial_database_preserve_database.PNG]]<Br>
[[File: Increment_Layer_03a.png]]<Br>
== Save Layer Out Into Superseded Folder ==
* '''Increment Layer Only''' - this will only save the individual layer from the GPKG database into a new or existing GPKG database. The tool will attempt to increment the name of both the GPKG database and layer when the layer is first selected.
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>
* '''Increment Layer and Preserve Database''' - This option will give the user the ability to determine which layers from the existing GPKG database they would like to keep and/or increment into a new GPKG database. The database can be a new or existing GPKG database. The tool will automatically try and increment the output database and layer names when the layer is first selected.
** Checked layers will be copied to the new database
** Layer names can be incremented (or given a new name) by providing one under the "Incremented Layer" column in the table. Otherwise if the "Incremented Layer" cell is blank, the layer will be copied with the same name.
: [[File: increment_layer_spatial_database_preserve_database.PNG]]
<br>
If the user has the '''File Management''' plugin installed, an option to increment the active layer is also available. This simply renames the layer inside the GPKG (no copying is done in this step) and allows the usual workflow of incrementing names to be used with this approach. The File Management plugin is required as this plugin has solved the problem of renaming a layer that is actively open in QGIS.<br>
[[File: Increment_Layer_04a.png]]<br>
'''Example 1 - Shapefile'''<Br> ▼[[File: increment_layer_example.gif]]
<br>
▲'''=== Example 1 - Shapefile '''<Br> ===
{{Video|name=Animation_Increment_Layer_eg_SHP_01a.mp4|width=1184}}
<br>
'''Example 2 - GPKG'''<Br>
=== Example 2 - GeoPackage ===
[[File: increment_layer_example_gpkg.gif]]
{{Video|name=Animation_Increment_Layer_eg_GPKG_01a.mp4|width=1184}}
<Br>
<br>
{{Tips Navigation
|uplink=[[TUFLOW_QGIS_Plugin#Usage| Back to TUFLOW QGIS Plugin Main Page]]
|