Chapter 1Introducing the MunsysQ Water User Manual

MunsysQ Water is used to capture and maintain water networks in QGIS. It does not require GIS expertise: the Water menus guide you through each function, and the water business rules are applied as you work.

MunsysQ Water is one of the MunsysQ applications, alongside MunsysQ Cadastral, Drainage, Roads and Sewer. All of them work on the same Munsys database as Munsys on AutoCAD.

About this manual

This manual describes the functions of MunsysQ Water: how a water network is captured, checked, posted to the database and maintained. It assumes that you are familiar with:

• the water business rules of your organisation
• the MunsysQ panel, QAD command line and edit cycle, as described in the MunsysQ Concepts User Manual
• common GIS terminology.

What is in this manual

Additional reading material

Before you use this manual, read the MunsysQ Concepts User Manual. It explains the topics that are the same in every application:

• connecting to the Munsys data, through WFS-T or directly to the database
• the MunsysQ panel and the QAD command line
• Munsys objects, tags, lookup values and application settings
• the edit cycle of capture, integrity check and posting, and record locking
• the Object and Tools menus that all applications share.

Conventions in this manual

Finding the information you need

• For the manuals, click Online Help on the MunsysQ panel.
• For help on a dialog box, click its Help button.
• For the latest support options, visit www.openspatial.com.

Chapter 2Getting acquainted with MunsysQ Water

About MunsysQ Water

MunsysQ Water is designed to capture and maintain water networks. A water reticulation network is a series of pipes that work under pressure and usually form a looped network. The network carries water of four categories:

The names of the categories in your database come from a lookup table and may be worded differently, for example Potable Network.

The Water menus allow fast and efficient capture and maintenance of the network. The water business rules are built into the functions, so that the data is maintained to engineering standards before it is posted to the database.

About water objects

Water pipes, nodes and service connections together make up the water network.

• Water pipes are laid along cadastral boundaries. The pipe diameter is largest at the source of supply and becomes smaller as the network extends towards the parcels.
• Water nodes show where pipes connect, intersect or end, for example junctions, hydrants, meters and end caps.
• Valves control the flow of water in the network. They are nodes too, and are stored with the other nodes.
• Service connections are the first connection from a parcel to the rest of the network, running from a pipe to the water meter on the parcel.
• Residential water pipes show the supply from a service connection to the buildings on a parcel. They are not part of the network connectivity.
• Water zones are polygons that divide the network into areas for an overview of the layout.
• Water symbols are additional annotation in the form of a symbol, such as a sample point or a cleaning port. They are not part of the network.
• Labels show the value of a pipe attribute, such as diameter and material, and follow the attribute when it changes.
• Notes and dimension arrows add information to plans, for example the offset of a pipe from a parcel boundary.

Every water object except residential water pipes belongs to a water category.

Loading MunsysQ Water

Before you start, QGIS must be connected to the Munsys data and the MunsysQ panel must show its menus. Connecting is described in Chapter 3 of the MunsysQ Concepts User Manual.

1. Open the QGIS project that contains the water layers.
2. On the MunsysQ panel, select Water (WMS) in the Module list. The Water menus are displayed in the menu tree.

The MunsysQ Water menus

The Water functions are grouped in three menus. The Object and Tools menus below them are shared by all applications and are described in the Concepts User Manual.

Munsys on AutoCAD offers many of these functions on toolbars as well. In MunsysQ every function is in the menu tree.

The water layers

Each type of water object is stored in its own spatial table and shown in QGIS as its own layer. A MunsysQ project normally holds them in a Water group in the Layers panel.

MunsysQ finds the layer that a function needs by its spatial table, so you can rename the layers or move them to other groups.

Chapter 3Water data in the project

In Munsys on AutoCAD, water data is brought into the drawing with the Query menu: by category, by water zone, as residential water or as the map page grid. In MunsysQ there is no query step. The water layers are connected to the database while the project is open, and QGIS reads the objects for the area that you are looking at.

Water objects by category

All the water pipes, nodes and service connections are in one layer each, whatever their category. The standard layer styles show the category of each object, and the category is stored in its attributes. To work on one category only, filter or style the layers on the category column; filtering layers is covered in a separate chapter.

Water zones and residential water

Water zones and residential water pipes are in their own layers, Water Zones and Water Residential Pipes. Switch the layers on in the Layers panel when you need them.

The map page grid

The Water Map Page Grid layer shows the page layout used to locate services by map page number, similar to the sheet layout of a map book. Switch it on when you need to find a page; it is not part of the network.

Chapter 4Creating water data

Capturing water data

When you capture a water network, start with the cadastral data and the existing water objects visible, so that new objects are positioned correctly and nothing is captured twice.

Every water object except residential water pipes receives a water category when it is captured or converted. The category of pipes is taken from the Water Category setting; nodes, service connections, dimensions and labels receive the category of the pipe that they are placed on.

A network is normally captured in this order:

1. Pipes first, because they are aligned with the cadastral boundaries.
2. Nodes next. Place a junction at every point where two or more pipes meet. Where a pipe does not loop back into the network, close it off with an end cap.
3. Valves at the points where flow is controlled.
4. Service connections, which link the network to the meter on each parcel. A branch service connection connects two parcels at once.
5. Residential water pipes, from the service connections to the buildings.
6. Water zones at any time, because they do not affect the network.

When the network is complete, check its integrity and post it to the database.

Water capture settings

The Water settings are the defaults that the capture and integrity functions use. Default values are set by the GIS administrator; you can change many of them for your current session to speed up capture.

To specify water capture settings

1. Choose Capture > Water Settings.... The Water Settings dialog box shows the current session settings.
2. Select a setting to see its description in the box below the list.
3. To change a value, click it, and then type a new value or choose one from the list.
4. Click OK.

The new values apply to objects that you capture from now on, until you change them again or close QGIS. They do not change objects that already exist.

Capturing water pipes

Water pipes are the first objects to capture. Pipes are broken at intersections. The diameter of a pipe can change only at an intersection of pipes, at a junction, or at a node such as a valve.

Drawing offset water pipes

An offset pipe is drawn parallel to a boundary, such as a parcel boundary, at the offset distance. You either trace the boundary by points or pick its segments.

To draw an offset pipe by points

1. Choose Capture > Draw Offset Pipe.
2. At the prompt Specify first point or [Offset segment]:, pick the first point along the boundary, then the next points. Press Enter after the last point.
3. At Specify point on side to offset:, click on the side of the boundary where the pipe must lie.
4. At Specify offset distance <2>:, type the distance, or press Enter to accept the default from the Water settings.

To draw an offset pipe by selecting segments

1. Choose Capture > Draw Offset Pipe, then type O and press Enter for the Offset segment option.
2. At Select offset segment:, pick a boundary segment.
3. At Specify point on side to offset:, click on the side for the pipe.
4. At Multiply offset by <1>:, enter a factor for the default offset distance, or press Enter.
5. Continue selecting segments. When all are selected, answer Done selecting offset segments [Yes/No] <Yes>: with Enter.

The pipe is created with the diameter, material and type from the Water settings and is highlighted as a pending edit.

Drawing freehand water pipes

Freehand pipes are drawn by picking points on the map, or by typing coordinates on the command line.

1. Choose Capture > Draw Freehand Pipe.
2. Specify the first point of the pipe, then the next points.
3. Press Enter after the last point.

Showing and changing pipe direction

The direction of a pipe is the order in which its points were captured. Because you can capture the network without taking direction into account, check the direction when the pipes are complete and correct it where necessary.

Capturing water nodes

Place nodes once the pipes have been captured and cleaned up and their direction has been checked. A node can be placed at the end of a pipe, or inserted at any point along a pipe, which breaks the pipe there.

The water node types are:

The node types available at your site are defined in the database and may differ.

Placing endpoint water nodes

An endpoint node is placed at the end of a pipe nearest to the point where you select the pipe.

1. Choose Capture > Place Endpoint Node and the node type, for example Junction.
2. Select the pipe close to the end where the node must go.

The node is placed at the end of the pipe, with its symbol aligned to the pipe.

Inserting nearest nodes

A nearest node is inserted at the point that you select on a pipe, and the pipe is broken at that point.

1. Choose Capture > Insert Nearest Node and the node type.
2. Select the point on the pipe where the node must go.

Capturing valves

Valves control the flow of water. Like nodes, they are placed at the end of a pipe or inserted at a point on a pipe, which breaks the pipe. Valve symbols are always aligned with the pipe.

The valve types are Air Release Valve, Scour Valve, Butterfly Valve, Check Valve, Gate Valve, Pressure Reducing Valve, Pressure Sustaining Valve and Vacuum Release Valve.

Placing endpoint valves

1. Choose Capture > Place Endpoint Valve and the valve type.
2. Select the pipe close to the end where the valve must go.

Inserting nearest valves

1. Choose Capture > Insert Nearest Valve and the valve type.
2. Select the point on the pipe where the valve must go. The pipe is broken and the valve is placed at the break.

Capturing service connections

Service connections connect the parcels to the water network. The length, offset distance and branch offset come from the Water settings.

To place a straight service connection

A straight service connection runs at right angles from the pipe and ends inside the parcel.

1. Choose Capture > Place SC > Straight.
2. Select the water pipe nearest to the parcel.
3. Select the parcel boundary that the service connection must cross.

To place a branch service connection

A branch service connection is placed at the branch offset distance from a parcel boundary.

1. Choose Capture > Place SC > Branch.
2. Select the water pipe nearest to the parcel.
3. Select the parcel boundary that the service connection must connect to.
4. Enter the boundary offset distance, or press Enter to accept the default.
5. Specify an alignment point on the parcel boundary.

To place a double branch service connection

A double branch service connection connects two parcels to the network at once. The steps are the same as for a branch service connection; choose Capture > Place SC > Double Branch.

To place a freehand service connection

A freehand service connection is drawn point by point. Use it when a connection is longer than the default length, or does not meet the pipe at a standard angle.

1. Choose Capture > Place SC > Freehand.
2. Select the water pipe that the service connection starts from.
3. Specify the points of the service connection, ending inside the parcel, and press Enter.

Capturing water zones

Water zones are polygons that show the parts of the network, for an overview of its layout. A zone does not affect the network.

1. Choose Capture > Water Zone > Draw Zone Boundary.
2. At Specify first point:, pick the first corner of the zone, then the next corners at Specify next point:.
3. Press Enter to close the boundary. It is closed back to the first point.

The zone polygon is created directly, and its tag is placed with the Zone Tag Height from the Water settings.

Capturing residential water pipes

Residential water pipes run from the service connection to the buildings on a parcel. They can be drawn freehand or at an offset from a boundary.

• Capture > Residential Water > Draw Freehand Pipe: pick the points of the pipe and press Enter.
• Capture > Residential Water > Draw Offset Pipe: the prompts are the same as for offset water pipes.

Placing water annotation

Placing water symbols

Water symbols are additional annotation, such as a cross over, sample point, line stop, cleaning port or cathodic station. They can be placed anywhere and are not part of the network.

1. Choose Capture > Place Water Symbol.... The Water Symbols dialog box lists the available symbols.
2. Select the symbol and click OK.
3. Specify the insertion point.
4. At Specify rotation angle or [Align to segment] <0>:, type the angle, pick it on the map, or type A and select a segment to align the symbol to.

Placing water labels

A water label shows the diameter and material of a pipe. Because it reads the pipe's attributes, it shows the new values after the pipe has been changed and posted.

1. Choose Capture > Place Water Label.
2. Select the pipe to label.
3. Specify the insertion point of the label.
4. Enter the label height, or press Enter for the Pipe Label Height setting.
5. Specify the angle: type it, pick it on the map, or type A to align the label to a segment.

Placing water notes

Notes add information about the network for map production.

1. Choose Capture > Place Water Note.
2. Specify the insertion point of the note.
3. Enter the note height, or press Enter for the Note Tag Height setting.
4. Specify the angle: type it, pick it on the map, or type A to align the note to a segment.
5. At Enter note value:, type the text of the note and press Enter.

Placing dimension arrows

A map cannot show a pipe at its true offset from a parcel boundary, so dimension arrows are used to state the offset.

1. Choose Capture > Place Dimension Arrow.
2. At Select first segment for dimension:, select the segment that the arrows must be perpendicular to.
3. At Select second segment for dimension:, select the point on the second segment that the arrows must align to.
4. At Enter distance or [Actual]:, type the distance, press Enter for the default offset distance, or type A to use the measured distance.

The dimension text is placed at the arrows.

Checking water integrity

The integrity check validates new and changed objects against the water business rules before they are posted. The rules are held in the database and are applied by the Munsys REST service, so they are the same as in Munsys on AutoCAD. The check has two parts:

• Object integrity checks each object on its own: its geometry and its attributes.
• Network integrity checks how the objects fit together into a network: the topology of the geometry and the connectivity recorded in the attributes. Because it depends on the relationships between objects, it also looks at neighbouring objects that you did not change.

To check water object integrity

1. Select the water objects to check on the map. If nothing is selected, all water objects with pending edits are checked.
2. Choose Capture > Data Integrity > Validate Object Integrity....
3. The MunsysQ Integrity message reports how many objects were checked and failed, how many issues were found, and how many integrity markers were written.

To check water network integrity

1. Select the part of the network to check, or select nothing to check the objects with pending edits.
2. Choose Capture > Data Integrity > Validate Network Integrity....
3. Read the result in the MunsysQ Integrity message.

Browsing integrity markers

Each problem is marked on the map by a point in the Integrity Errors layer. Capture > Data Integrity > Browse Integrity Markers... zooms to the markers and opens their attribute table, which lists for each marker the rule, the error code and message, the layer and object affected, and a description.

Select a row and use the attribute table's Zoom map to the selected rows button to go to that problem.

Erasing integrity markers

Capture > Data Integrity > Erase Integrity Markers asks for confirmation and then removes all the markers. Markers are a working aid on your computer only and are never posted.

Posting water data to the database

New and changed water data that has passed the integrity check is posted to the database.

1. Choose Capture > Post to Database.... The Post to Database dialog box lists each water layer with pending edits and the number of objects to be inserted, updated and deleted.
2. Check the totals and click Post.
3. The Post to Database Results dialog box shows what was posted, with a status and a message for each layer. Click Close.

After posting, the edit highlight is cleared, your locks on the posted objects are released, and the changes are visible to all users. Posting is described in full in the Concepts User Manual.

Chapter 5Maintaining water data

Once the pipes and nodes have been placed, they must be joined correctly, with no overlaps or undershoots, and every pipe must have a node at each end. The Change menu provides the functions for this, and for changing attributes such as pipe diameter, type and material.

When you change an existing object it is locked for you, and the change is a pending edit. Changed objects must pass the integrity check before they are posted.

Changing water pipes

To extend a water pipe to a boundary

Extends a pipe until it meets a boundary object. It is often used to extend pipes so that they meet at a junction.

1. Choose Change > Extend Pipe to Boundary.
2. Select the boundary object that the pipe must extend to.
3. Select the pipe to extend, near the end that must be extended.

To extend a water pipe by distance

Extends a pipe by a distance at the end nearest to the point where you select it. A negative distance, for example -5, shortens the pipe.

1. Choose Change > Extend Pipe by Distance.
2. Select the pipe near the end to extend.
3. At Enter distance:, type the distance and press Enter.

To extend a water pipe and break another at the intersection

Extends a pipe to a second pipe and breaks the second pipe at the intersection.

1. Choose Change > Extend and Break Pipe.
2. Select the pipe to be broken.
3. Select the pipe to extend.

To break a water pipe

1. Choose Change > Break Pipe.
2. Select the point on the pipe where it must be broken.

The pipe becomes two pipes, as described under Inserting nearest nodes.

To change a water pipe

Moves the endpoint of one or more pipes to a new location.

1. Choose Change > Change Pipe.
2. Select the pipe near the endpoint to move.
3. Specify the new location of the endpoint.

To fillet water pipes

Connects two pipes at their projected intersection, extending or trimming them as needed.

1. Choose Change > Fillet Pipe.
2. Select the first pipe, then the second.

To trim a water pipe

1. Choose Change > Trim Pipe.
2. Select the pipe to trim to, the cutting edge.
3. Select the second pipe on the side that must be cut off.

To join water pipes

Joins two pipes into one. The joined pipe keeps the attributes of the first pipe that you select; the second pipe is marked for deletion. If there is a gap between the pipes, it is closed with a straight segment.

1. Choose Change > Join Pipe.
2. Select the first pipe, the one to join to.
3. Select the second pipe close to the end that must be joined.

To change the vertices of a water pipe

Changing water nodes

Nodes can be moved, rotated and snapped to pipes, valves can be opened and closed, and the type of a node can be changed. These functions are mostly used when the network is cleaned up after capture.

To move a node

1. Choose Change > Move Node.
2. Select the node, then specify its new insertion point.

To rotate a node

1. Choose Change > Rotate Node.
2. Select the node.
3. At Specify rotation angle or [Align to segment] <0>:, type the angle, pick it with two points, or type A and select a segment to align the node to.

To snap a node to the endpoint of a pipe

1. Choose Change > Snap Node to Endpoint.
2. Select the node.
3. Select the pipe close to the endpoint that the node must snap to.

To snap a node to a pipe, breaking the pipe

1. Choose Change > Snap Node and Break Pipe.
2. Select the node.
3. Select the pipe, then the point where it must be broken. The node is snapped to the break.

To open or close a valve

Changes the status of gate and butterfly valves between open and closed. The symbol changes with the status; the valve type does not.

1. Choose Change > Open / Close Valve....
2. Select the valves. The Valve Status dialog box is displayed.
3. Choose the status and click OK.

To change a node type

Changes the type of one or more nodes. The symbol and the NODE_TYPE column are updated to the new type.

1. Choose Change > Change Node Type....
2. Select the nodes and press Enter. The Node Types dialog box is displayed.
3. Select the new type and click OK.

To rotate a water symbol

Rotates a water symbol in the same way as Rotate Node rotates a node: select the symbol, then type, pick or align the angle.

Changing the category of water objects

Changes the water category of one or more water objects.

1. Choose Change > Change Water Category....
2. Select the water objects. The category dialog box is displayed; if you selected one object, or several of the same category, its category is highlighted.
3. Select the new category and click OK.

Changing water attribute data

Editing water object attributes

Change > Edit Attributes... shows the attributes of the selected water objects of one type, for example pipes, in the columns Attribute, Value and Status. Attributes with a fixed list of values offer the list. Attributes that may not be changed are unavailable.

1. Choose Change > Edit Attributes....
2. Select the objects and press Enter. If they are of different types, choose the type to edit.
3. To give all the selected objects the same value, select Edit multiple objects simultaneously. To edit them one by one, clear it and use the arrow buttons to move between objects; select AutoZoom to object to have the map follow.
4. Change the values and click OK.

The changes are pending edits until they pass the integrity check and are posted. Mandatory attributes must be completed, or the object fails the object integrity check.

Editing linked table attributes

Some information about water objects is kept in linked, non-spatial tables. Change > Edit Linked Table Attributes... lets you step through the linked records of an object, change them, and insert or delete records, depending on your privileges. Linked table changes are written to the database directly, so you can only select objects that have already been posted.

Changing water pipe diameter, material and type

Changes the diameter, material or type that a pipe was given at capture. The new value is chosen from a list to keep the data accurate.

1. Choose Change > Change Pipe Attributes and Diameter..., Material... or Type....
2. Select the pipes and press Enter. The selection dialog box highlights the current value if you selected one pipe; you can search the list by code or description.
3. Select the new value and click OK.

Linking service connections to parcels and buildings

Links service connections to the parcels and buildings that they supply, so that the network can be traced to a property or building.

1. Choose Change > Link Service Connections.
2. Select the service connections and press Enter.

• If the end of a service connection lies inside a parcel, its PRCL_GID column is set to the GID of that parcel.
• If it also lies inside a building, its LINK_ID column is set to the GID of the building.

Changing water notes

1. Choose Change > Change Water Note....
2. Select the note. The Water Note box is displayed.
3. Change the text and click OK.

Adding comments

1. Choose Change > Add Comment....
2. Select the water objects. The Water Comment box is displayed.
3. Type the comment and click OK. It is stored in the COMMENTS column of each selected object.

Deleting and undeleting water objects

Water objects that are no longer part of the network are deleted. A deletion is a pending edit: the objects are removed from the database when you post.

To delete water objects

1. Choose Change > Delete Water Object.
2. Select the water objects and press Enter. Objects that are not water objects are left out of the selection.

The objects are marked for deletion and shown in the DELETED group at the top of the Layers panel until you post.

To undelete water objects

1. Choose Change > Undelete Water Object. The objects marked for deletion are shown.
2. Select the objects to keep. They are no longer marked for deletion, and any changes made to them before they were deleted are kept.

Restoring a deleted object

Change > Restore Deleted Object brings back an object whose deletion has already been posted, from the archive that the database keeps of deleted objects. See the Concepts User Manual.

Chapter 6Converting drawing entities to water objects

Water networks often exist as CAD drawings. After a drawing has been brought into QGIS with Import CAD/DWG, or geometry has been drawn on a construction layer, the Extras functions convert it to water objects. The procedure for imports and the Object Conversion dialog box are described in the Concepts User Manual.

Some basic attributes are set during conversion. Complete the remaining attributes afterwards, then check integrity and post as for captured objects.

Converting blocks to water symbols

1. Choose Extras > Convert Block to > Water Symbol....
2. Select the block references and press Enter.
3. In the Water Symbols dialog box, select the symbol and click OK. One water symbol is created for each block.

Converting blocks to water nodes and valves

1. Choose Extras > Convert Block to and the node or valve type, for example Gate Valve.
2. Select the block references and press Enter. One node is created for each block.

Converting lines to water objects

Lines can be converted to water pipes, service connections or residential water pipes.

1. Choose Extras > Convert Line to and Water Pipe, Service Connection or Residential Water.
2. Select the lines and press Enter.

Converting text to water zone tags and notes

1. Choose Extras > Convert Text to and Water Zone Tag or Water Note.
2. Select the text and press Enter.

Converting polygons to water zones

1. Choose Extras > Convert Polygon to > Water Zone.
2. Select the polygons and press Enter.

Appendix AWater menus

This appendix lists the Capture, Change and Extras menus of MunsysQ Water. Click a function to go to its description. Menus are stored in the database and can be tailored by an administrator, so the menus at your site may differ.

ReferenceGlossary

Endpoint node

A node placed at the end of a pipe.

Lineage parent

The pipe that a new pipe was split from, recorded when a pipe is broken.

Nearest node

A node inserted at a point along a pipe, breaking the pipe there.

Offset pipe

A pipe drawn parallel to a boundary at the offset distance.

Residential water pipe

A pipe from a service connection to a building. Not part of the network connectivity.

Service connection (SC)

The connection between the network and the meter on a parcel.

Valve

A node that controls the flow of water, such as a gate or butterfly valve.

Water category

The classification of water objects as potable, reclaimed, raw or abandoned.

Water zone

A polygon that groups part of the network for an overview of its layout.

For the terms that all applications share, see the glossary of the Concepts User Manual.