Add files via upload

digitizing all TDH class objects

docs/en/user-guide/digitizing/dataentry.rst

@@ -3,63 +3,23 @@ Data entry
 
 There are basically two ways:
 
-* Data entry by constructing or digitizing in a TWW-project with the TWW-wizard or QGIS-tools itself
-* Data entry in an external program or software and then importing the position and/or technical data into TWW e.g.:
+* Data entry by constructing or digitizing in a TDH-project with the QGIS-tools itself
+* Data entry in an external program or software and then importing the position and/or technical data into TDH e.g.:
 
    * coordinates from manholes from measurement
    * position and/or technical data from another GIS or CAD system
    * using data from the surveyor (e.g. property boundaries) as a basis for defining catchment borders
    * other
 
-Data entry in TWW needs some understanding of the underlying data model `VSA-DSS <http://dss.vsa.ch>`_, but is supported with some great data collecting wizards and forms that link the different tables correctly together. Especially the linking of manholes and reaches to a complete sewer network is highly automated and can be controlled with the network following tool.
-
-.. _wizard:
-
-The TWW wizard
----------------
-
-The TWW wizard helps digitizing manholes and reaches with just a few clicks.
-
-To start with data entry select the TWW button **Wizard**.
-
-.. figure:: images/button_data_entry_wizard_selected.jpg
-
-On the left side bottom, **TWW Data Entry** window appears:
-
-.. figure:: images/wizard_data_entry.jpg
-
-Click **Start Data entry** to enter the edit mode.
-
-Choose **Wastewater Structure** or **Reach**. Start adding new feature in vw_tww_wastewater_structure or vw_tww_reach.
-
-There is no need to select the correct layer in the layers-window, you do not need to toggle editing or to choose the add feature tool.
-
-When adding new **wastewater structure**, the wizard has no additional functionality. In the layer form configuration, the option **Reuse last entered value** defines for every field, if the last value will be used again or not.
-
-When adding new **reach**, the wizard has some additional functionality:
-
-* Snapping on wastewater nodes and other reaches is on, even if QGIS **Enable Snapping** is off.
-* Snapping on nodes is always preferred to snapping on reaches.
-* When the new reach snaps, then the obj_id_links are automatically entered in the fk_fields of the reach points.
-* The **Reuse last entered value** - option of QGIS does not work in this view. But the standard-fields on the general-tab (and only those fields) do reuse the last entered value.
-
-If you use another tool (e.g. the **Identify Features** tool) and then want to continue digitizing with the wizard, you can not select the wizard again. You have to click **Stop Data Entry** and then **Start Data Entry** and you can continue.
-
-If you change from digitizing wastewater structures to digitizing reaches, it is recommended to stop and start data entry also. This saves the new manholes and enables the reaches to snap also on new digitized manholes.
-
-.. note:: When digitizing, it is recommended to start with the point elements (wastewater structures such as manholes, special structures). Afterwards its easy to connect those points with line elements (channels with reaches).
-
-It is possible to use the **Advanced Digitizing** tools together with the wizard.
+Data entry in TDH needs some understanding of the underlying data model `SIA 405`_, but is supported with forms that link the different tables correctly together.
 
 
 QGIS standard tools
 -------------------
 
-To digitize in other layers than vw_tww_wastewater_structure or vw_tww_reach, you work with the standard QGIS tools:
+To digitize th network elements, you need to work with the standard QGIS tools:
 
 * Select the layer you want to edit
 * Toggle Editing if necessary
 * Enable snapping if necessary
 * Choose the add feature tool
-
-It is also possible to use the standard QGIS tools with the two vw_tww-main layers. But there will be no automatic value in the fk-fields of the reach-points and no preferred snapping to wastewater nodes.

docs/en/user-guide/digitizing/deletingobjects.rst

@@ -1,21 +1,19 @@
 Deleting objects
 ================
 
-You can delete point or line objects (with all associated objects) through the **vw_tww_(wastewater_structure/reach)** layers.
-You can also pick and delete only a specific object (e.g. cover).
 
-Delete Reach
-------------
+Delete Pipe_section
+-------------------
 
-* Select **vw_tww_reach** and change to edit mode.
+* Select the **pipe_section** layer and change to edit mode.
 
-* Select the reach(es) you want to delete. You can click on an object or draw an area.
+* Select the pipe_section(s)) you want to delete. You can click on an object or draw an area.
 
 .. figure:: images/select_tool.jpg
 
 * Use the top menu **Edit** --> **Delete Selected** to delete.
 
-.. figure:: images/delete_reach.jpg
+.. figure:: images/delete_pipe_section.jpg
 
 .. note:: The easiest way is to simply press the **Delete** key on your keyboard.
   Another way is to press the **Delete** button located in the **Digitizing toolbar**.
@@ -27,88 +25,33 @@ Delete Reach
 
 * Deselect the edit mode and confirm changes to layer. All changes will be saved to database.
 
-.. figure:: images/delete_reach_confirm.jpg
+.. figure:: images/delete_confirm.jpg
 
-.. note:: Delete reach deletes also all connected structure parts (e.g. dryweather_downspout). The connected channel is only deleted if there is no other wastewater networkelement connected to the channel. If there are two reaches connected to one channel, the channel is only deleted if both reaches are deleted.
+Delete pipe_point_normal or pipe_point_feed
+-------------------------------------------
 
-Delete Manhole or other Wastewater Structure
-------------------------------------------------
-
-* Select **vw_tww_wastewater_structure** and change to edit mode
-* Select the objects (**manholes**, **special structures** etc.) you want to delete
+* Select **vw_pipe_point_normal** or **vw_pipe_point_feed** layer and change to edit mode
+* Select the objects you want to delete
 * Use **Edit** --> **Delete Selected** to delete.
 * Stop the editing mode and confirm changes to layer. All changes will be saved to database.
 
-.. note:: Delete wastewater structures deletes also all connected structure parts (cover, access_aid etc) and all connected wastewater nodes. fk_wastewater_networkelement in reachpoints, that where connected to the node, are set to NULL.
-
-Delete Wastewater Structure, but keep the wastewater_node and the connections to the wastewater_node
----------------------------------------------------------
-First, you have to kill the connection between wastewater_node and wastewater_structure. Because the fk_wastewater_structure field is not visible in the wastewater_node feature attribut window (this field make no sense in other cases, where the form is also used), you have to follow this way:
-
-* Select **vw_tww_wastewater_structure** and change to edit mode
-* Use the **Identify Features** tool to open the form of the manhole you want to delete
-* Switch to Wastewater Nodes tab
-* Select the Node, that should not be deleted
-* Use the button **Unlink selected child record(s)**
-
-.. figure:: images/unlink_childe.jpg
-
-* Click **OK** and close the form window
-The wastewater node is no no more part of the wastewater_structure
-
-* Select the object (**manhole**, **special structure** etc.) you want to delete
+Delete Structure
+----------------
+* Select **structure** layer and change to edit mode
+* Select the objects you want to delete
 * Use **Edit** --> **Delete Selected** to delete.
 * Stop the editing mode and confirm changes to layer. All changes will be saved to database.
 
-.. figure:: images/keep_node.jpg
-
-Delete Cover
--------------
-
-* Select **vw_tww_wastewater_structure** and change to edit mode
-* Select the object (**manholes**, **special structures** etc.) from which the cover is to be deleted
-* Use the **Identify Features** tool to open the form
-* Switch to the covers tab
-* Select the cover(s) you want to delete
-* Click the button **delete selected child features** to delete the covers
-
-.. figure:: images/delete_covers.jpg
-
-* Click save on the form
-* Deselect the edit mode and confirm changes to layer. All changes will be saved to database.
-
-Second way to delete a cover
-
-* Select the **vw_cover** layer and change to edit mode
-* Select the cover
-* Use **Edit** --> **Delete Selected**
-* Stop the editing mode
-
-Delete Structure parts
-----------------------
-
-* Select **vw_tww_wastewater_structure** and change to edit mode
-* Select the object (**manholes**, **special structures** etc.) from which a structure part is to be deleted
-* Use the **Identify Features** tool to open the form
-* Switch to the structure parts tab
-* Select the structure part you want to delete
-* Click the red x button to delete the structure parts
-* Click save on the form
+Delete trench or trench_point
+-----------------------------
+* Select **trench** or **trench_point** layer and change to edit mode
+* Select the objects you want to delete
+* Use **Edit** --> **Delete Selected** to delete.
 * Stop the editing mode and confirm changes to layer. All changes will be saved to database.
 
-Delete detailed geometries
---------------------------
-
-.. attention:: Deleting features directly from **wastewater_structure** (layergroup Wastewater Structures) will remove the complete wastewater structure from the database and not only the geometry of the wastewater structure!
-
-* Select layer **wastewater_structure** and change to edit mode
-* Activate the **Delete part** tool from the Advanced digitizing toolbar
-
-.. figure:: images/delete_part_tool.jpg
-
-
-* You get a cross-cursor. Click on the part you want to delete (there is no question if you really want... If you click, the part is deleted!)
-
-.. figure:: images/delete_part_tool2.jpg
-
-* Stop the editing mode and confirm changes to layer. All changes will be saved to database.
+Delete cable or cable_point
+-----------------------------
+* Select **sia405cc_cable** or **sia405cc_cable_point** layer and change to edit mode
+* Select the objects you want to delete
+* Use **Edit** --> **Delete Selected** to delete.
+* Stop the editing mode and confirm changes to layer. All changes will be saved to database.

docs/en/user-guide/digitizing/digitizingcable.rst

@@ -0,0 +1,48 @@
+Digitizing Cables
+=================
+
+General
+-------
+
+TDH includes the SIA-405 extension in order to allow cables and cable_points to be digitized.
+
+
+Digitizing
+----------
+* Make sure that the automatic snapping tool is activated for all layers.
+
+* Select the **sia4005cc_cable** layer in that layer panel and then select the edit mode.
+
+* In digitizing mode the cursor will automatically snap to the nearest map objects.
+  When left clicking a line starts to draw.
+
+
+* With further left clicks anywhere you can define intermediary points of the cable progression.
+  You can also directly select another soa405cc_cable_point to draw a straight line.
+
+* You finish digitizing the line by right clicking. This will make the **sia4005cc_cable** feature attributes window appear and you can start adding data:
+
+.. figure:: images/tdh_sia4005cc_cable_form.jpg
+
+Select the function of the sia4005cc_cable you want (preselected is 'control_cable'):
+
+- control_cable
+- others
+- power_cable
+- signal_cable
+- unkown
+
+.. note:: Keep in mind that the finishing point of the line is the last point where you **left** clicked.
+  Thus, for digitizing a simple line with 2 points you need two **left clicks** to digitize the line and one
+  **right click** to finish the line digitizing.
+
+.. note:: If you do not enter an `name_number` identifier on this form, TDH will enter the `obj_id` also as identifier (you can change later).
+
+* When finished, then click the **OK** button.
+
+* Save the information of this layer by selecting the Floppy icon in the menu bar.
+
+You can re-edit your polygon object selecting the edit mode and then click with the info cursor on the object you want to edit.
+If you do not select the edit mode, you can just look at the existing data.
+
+For detailed information about editing see the :ref:`editing-data` chapter.

docs/en/user-guide/digitizing/digitizingcablepoint.rst

@@ -0,0 +1,47 @@
+.. _digitizing-cable-point:
+
+Digitizing cable point
+=======================
+
+General
+-------
+
+TDH includes the SIA-405 extension in order to allow cables and cable_points to be digitized.
+
+Digitizing
+----------
+
+Select the **sia405cc_cable_point** layer in that layer panel and then select the edit mode. Select the **point tool** in the digitizing toolbar.
+
+Now the cursor changes to the digitizing symbol and you can select the location of the new point element.
+
+Then the **sia405cc_cable_point** form opens and you can start adding data :
+
+.. figure:: images/tdh_sia405cc_cable_point_form.jpg
+
+Select the kind of cable point you want (preselected is 'cabine'):
+
+- cabine
+- cable_manhole
+- cable_point
+- cable_sleeve
+- others
+- unknown
+
+Then add the name_number (this is the attribute that will be displayed on the map).
+
+.. note:: If you do not enter an identifier, TDH will enter the obj_id also as identifier (you can change later). 
+
+Add other mandatory attributes.
+You can also add attributes in the other sections (Ground observations, Organisations, etc.).
+
+.. note:: The idea of the head of the form is, that in the normal digitizing process (95% of the cable_point) the user has not to change the attributes that are necessary in the other sections.
+
+Click **OK** to close the form.
+
+Save the information of this layer by selecting the Floppy icon in the menu bar.
+
+You can re-edit your polygon object selecting the edit mode and then click with the info cursor on the object you want to edit.
+If you do not select the edit mode, you can just look at the existing data.
+
+For detailed information about editing see the :ref:`editing-data` chapter.

docs/en/user-guide/digitizing/digitizingpipepoints.rst

@@ -0,0 +1,76 @@
+Digitizing Pipe Points
+======================
+
+General
+-------
+
+TDH has no wizard to correctly build pipe_points (normal or feed).
+
+
+Digitizing pipe_point_normal
+----------------------------
+* Make sure that the automatic snapping tool is activated for all layers.
+
+* Select the vw_pipe_point_normal layer in that layer panel and then select the edit mode.
+
+* In digitizing mode the cursor will automatically snap to the nearest object in the map canvas.
+  When left clicking a point is created at the selected cursor position.
+
+* This will make the **vw_pipe_point_normal** feature attributes window appear and you can start adding data:
+
+.. figure:: images/tdh_pipe_point_normal_form.jpg
+
+Select the kind of the pipe_point_normal you want (preselected is 'NULL') in the dropdown list:
+
+- armatures.valve_without_motor
+- armatures.emptying
+- armatures.venting
+- armatures.shaped_piece.reduction
+- armatures.shaped_piece.t_piece
+- armatures.installations.condenser
+- armatures.pipe_point.geometry_point
+- armatures.pipe_point.change_of_material
+- armatures.pipe_point.sleeve
+
+Add other mandatory attributes.
+You can also add attributes in the other sections (Ground observations, Characteristics, Organisations, etc.).
+
+
+* When finished, then click the **OK** button.
+
+* Save the information of this layer by selecting the Floppy icon in the menu bar.
+
+You can re-edit your point object selecting the edit mode and then click with the info cursor on the object you want to edit.
+
+Digitizing pipe_point_feed
+----------------------------
+* Make sure that the automatic snapping tool is activated for all layers.
+
+* Select the vw_pipe_point_feed layer in that layer panel and then select the edit mode.
+
+* In digitizing mode the cursor will automatically snap to the nearest object in the map canvas.
+  When left clicking a point is created at the selected cursor position.
+
+* This will make the **vw_pipe_point_feed** feature attributes window appear and you can start adding data:
+
+.. figure:: images/tdh_pipe_point_feed_form.jpg
+
+Select the kind of the pipe_point_feed you want (preselected is 'NULL') in the dropdown list:
+
+- network_supply
+- network_interconnection
+- network_transfer_station
+- others
+
+Add other mandatory attributes.
+You can also add attributes in the other sections (Ground observations, Characteristics, Organisations, etc.).
+
+
+* When finished, then click the **OK** button.
+
+* Save the information of this layer by selecting the Floppy icon in the menu bar.
+
+You can re-edit your point object selecting the edit mode and then click with the info cursor on the object you want to edit.
+If you do not select the edit mode, you can just look at the existing data.
+
+For detailed information about editing see the :ref:`editing-data` chapter.