QGIS TUFLOW Increment Layer - Revision history

Emilie Nielsen: /* Examples */

2024-08-27T00:34:31Z

Examples

← Older revision		Revision as of 10:34, 27 August 2024
Line 54:		Line 54:
	= Examples =		= Examples =
	=== Example 1 - Shapefile ===		=== Example 1 - Shapefile ===
	{{Video\|name=~~Animation_Increment_Layer_eg_GPKG_01a~~.mp4\|width=1184}}		{{Video\|name=Animation_Increment_Layer_eg_SHP_01a.mp4\|width=1184}}
	<br>		<br>

	=== Example 2 - GeoPackage ===		=== Example 2 - GeoPackage ===
	{{Video\|name=~~Animation_Increment_Layer_eg_SHP_01a~~.mp4\|width=1184}}		{{Video\|name=Animation_Increment_Layer_eg_GPKG_01a.mp4\|width=1184}}
	<Br>		<Br>

Emilie Nielsen at 00:33, 27 August 2024

2024-08-27T00:33:45Z

← Older revision		Revision as of 10:33, 27 August 2024
Line 5:		Line 5:
	In QGIS, the tool can be found in the TUFLOW Plugin toolbar, or via the top dropdown menu options Plugins >> TUFLOW >> Editing >> Increment Selected Layer.<br>		In QGIS, the tool can be found in the TUFLOW Plugin toolbar, or via the top dropdown menu options Plugins >> TUFLOW >> Editing >> Increment Selected Layer.<br>

	[[File: ~~increment_layer_toolicon~~.~~PNG~~]]<br>		[[File: TUFLOW_plugin_increment_layer.png]]<br>
	<br>		<br>
	Example 'Increment Selected Layer' dialog:<br>		Example 'Increment Selected Layer' dialog:<br>

	[[File:~~QGIS~~ ~~TUFLOW Increment 03~~.png]]<br>		[[File: Increment_Layer_01a.png]]<br>
	<br>		<br>
	The parameters are described below:		The parameters are described below:
Line 28:		Line 28:
	:'''Note:''' <u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save layer out into superseded folder]]</u> is available since v3.7.0.25<br>		:'''Note:''' <u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save layer out into superseded folder]]</u> is available since v3.7.0.25<br>

	[[File: ~~increment_layer_spatial_database_options~~.~~PNG~~]]<br>		[[File: Increment_Layer_02a.png]]<br>
	<br>		<br>
	A summary of the options is described below and more details are given further on:		A summary of the options is described below and more details are given further on:
Line 42:		Line 42:
	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>		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 ==		== Save Layer Out Into Superseded Folder ==
Line 49:		Line 49:
	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>		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_spatial_database_ss_layer~~.~~PNG~~]]<br>		[[File: Increment_Layer_04a.png]]<br>
	<br>		<br>

	= Examples =		= Examples =
	=== Example 1 - Shapefile ===		=== Example 1 - Shapefile ===
			{{Video\|name=Animation_Increment_Layer_eg_GPKG_01a.mp4\|width=1184}}


	[[File: increment_layer_example.gif]]
	<br>
	<br>		<br>

	=== Example 2 - GeoPackage ===		=== Example 2 - GeoPackage ===
			{{Video\|name=Animation_Increment_Layer_eg_SHP_01a.mp4\|width=1184}}



	[[File: increment_layer_example_gpkg.gif]]
	<Br>		<Br>

Emilie Nielsen: /* Working with GPKG */

2024-08-26T23:57:40Z

Working with GPKG

← Older revision		Revision as of 09:57, 27 August 2024
Line 23:		Line 23:
	<br>		<br>

	= Working with ~~GPKG~~ =		= Working with GeoPackage =
	:''Available since v3.3''<br>		:''Available since v3.3''<br>
	If the source layer is a GPKG, the user will be given additional options:<Br>		If the source layer is in a GeoPackage (GPKG), the user will be given additional options:<Br>
	:'''Note:''' <u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save layer out into superseded folder]]</u> is available since v3.7.0.25<br>		:'''Note:''' <u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save layer out into superseded folder]]</u> is available since v3.7.0.25<br>

Emilie Nielsen: /* Examples */

2024-08-26T23:57:03Z

Examples

← Older revision		Revision as of 09:57, 27 August 2024
Line 53:		Line 53:

	= Examples =		= Examples =
	~~'''~~Example 1 - Shapefile~~'''<Br>~~		=== Example 1 - Shapefile ===


	[[File: increment_layer_example.gif]]		[[File: increment_layer_example.gif]]
	<br>		<br>
	<br>		<br>

	'''Example 2 - GPKG'''<Br>
			=== Example 2 - GeoPackage ===



	[[File: increment_layer_example_gpkg.gif]]		[[File: increment_layer_example_gpkg.gif]]
	<Br>		<Br>

Emilie Nielsen: /* Working with GPKG */

2024-08-26T23:55:57Z

Working with GPKG

Emilie Nielsen: /* Running the Tool */

2024-08-26T23:42:19Z

Running the Tool

← Older revision		Revision as of 09:42, 27 August 2024
Line 15:		Line 15:
	<li> '''Source Layer:''' Drop box for selecting the layer to be incremented. This defaults to the layer currently selected in the QGIS Layers panel.		<li> '''Source Layer:''' Drop box for selecting the layer to be incremented. This defaults to the layer currently selected in the QGIS Layers 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> '''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> '''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> '''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_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> '''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> '''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 Source Layer in Workspace' and 'Move Source Layer to Superseded Folder' together.		<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 Source Layer in Workspace' and 'Move Source Layer to Superseded Folder' together.

Emilie Nielsen: /* Running the Tool */

2024-08-26T23:38:15Z

Running the Tool

← Older revision		Revision as of 09:38, 27 August 2024
Line 14:		Line 14:
	<ol>		<ol>
	<li> '''Source Layer:''' Drop box for selecting the layer to be incremented. This defaults to the layer currently selected in the QGIS Layers panel.		<li> '''Source Layer:''' Drop box for selecting the layer to be incremented. This defaults to the layer currently selected in the QGIS Layers panel.
⚫	~~<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 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> '''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> '''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> '''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.
Line 20:		Line 19:
	<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 Source Layer in Workspace' and 'Move Source Layer to Superseded Folder' together.		<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 Source Layer in Workspace' and 'Move Source Layer to Superseded Folder' together.
	</ol>		</ol>
		⚫	:''Note:'' The 'Keep source formatting' 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.		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>		<br>

Emilie Nielsen: /* Working with GPKG */

2024-08-26T06:37:05Z

Working with GPKG

Emilie Nielsen: /* Running the Tool */

2024-08-26T06:33:59Z

Running the Tool

← Older revision		Revision as of 16:33, 26 August 2024
Line 21:		Line 21:
	</ol>		</ol>
	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.		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>
	<br>		<br>

Emilie Nielsen: /* Running the Tool */

2024-08-26T06:33:49Z

Running the Tool

← Older revision		Revision as of 16:33, 26 August 2024
Line 4:		Line 4:
	= Running the Tool =		= Running the Tool =
	In QGIS, the tool can be found in the TUFLOW Plugin toolbar, or via the top dropdown menu options Plugins >> TUFLOW >> Editing >> Increment Selected Layer.<br>		In QGIS, the tool can be found in the TUFLOW Plugin toolbar, or via the top dropdown menu options Plugins >> TUFLOW >> Editing >> Increment Selected Layer.<br>

	<br>
	[[File: increment_layer_toolicon.PNG]]<br>		[[File: increment_layer_toolicon.PNG]]<br>
	<br>		<br>
	Example 'Increment Selected Layer' dialog:<br>		Example 'Increment Selected Layer' dialog:<br>

	<br>
	[[File:QGIS TUFLOW Increment 03.png]]<br>		[[File:QGIS TUFLOW Increment 03.png]]<br>
	<br>		<br>

← Older revision		Revision as of 09:55, 27 August 2024
Line 31:		Line 31:
	<br>		<br>
	A summary of the options is described below and more details are given further on:		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_Only\|Increment Layer Only]]</u>:''' 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#Increment_Layer_and_Preserve_Database\|Increment Layer and Preserve Database]]</u>:''' 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>		* '''<u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save Layer Out Into Superseded Folder]]</u>:''' 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 ==		== Increment Layer Only ==
Line 39:		Line 39:

	== Increment Layer and Preserve Database ==		== 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>		This option 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 whether 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.<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>

Line 45:		Line 45:

	== Save Layer Out Into Superseded Folder ==		== 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>		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>		<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>		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_spatial_database_ss_layer.PNG]]<br>		[[File: increment_layer_spatial_database_ss_layer.PNG]]<br>
	<Br>		<br>

	= Examples =		= Examples =

← Older revision		Revision as of 16:37, 26 August 2024
Line 24:		Line 24:

	= Working with GPKG =		= Working with GPKG =
	''Available since v3.3''<br>		:''Available since v3.3''<br>
	If the source layer is a GPKG, the user will be given additional options:<Br>		If the source layer is a GPKG, the user will be given additional options:<Br>
	'''Note:''' <u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save layer out into superseded folder]]</u> is available since v3.7.0.25<br>		:'''Note:''' <u>[[QGIS_TUFLOW_Increment_Layer#Save_Layer_Out_Into_Superseded_Folder\|Save layer out into superseded folder]]</u> is available since v3.7.0.25<br>

	: [[File: increment_layer_spatial_database_options.PNG]]		[[File: increment_layer_spatial_database_options.PNG]]<br>
		⚫	<br>
	A summary of the options is described below and more details are given further on:		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_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.
Line 37:		Line 39:

	== Increment Layer and Preserve Database ==		== 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.		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>
	~~<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.		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>

⚫	<br>
	[[File: increment_layer_spatial_database_preserve_database.PNG]]<Br>		[[File: increment_layer_spatial_database_preserve_database.PNG]]<Br>

Line 47:		Line 48:
	<Br>		<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>		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_spatial_database_ss_layer.PNG]]<br>		[[File: increment_layer_spatial_database_ss_layer.PNG]]<br>
	<Br>		<Br>