You are currently reviewing an older revision of this page.
Waterobjects.NET is the Application Programming Interface (API) used with Bentley's Hydraulics and Hydrology products, such as WaterCAD and WaterGEMS. It allows users with programming knowledge to extend the functionality of the product to suit their needs. Being .NET Framework based allows support for a number of different programming languages, such as VB, C#, C++, etc (more information on that can be found here and here.)
Waterobjects.NET essentially provides a way to code routines/tools that take the data in a hydraulic model file, manipulate it in some way and either present output in a certain way and/or modify the model data. It is not intended as a way to modify the existing numerical engines or the user interface. Source code for those components are not provided.
Examples of what can be done with Waterobjects.NET are included in the "samples guide". An overview can be seen here:
A basic training/overview course is also available on the LEARN.Bentley.com:
To use Waterobjects.NET, you need:
Note: you will also need to learn the structure/schema of the Haestad products/code which will require a time investment. The SDK will help with this.
If you have the product already installed (SewerGEMS, WaterGEMS, etc) then you already have access to program with Waterobjects.NET. There is no separate installation file necessary.
However, if you are a member of the Bentley Developer Network (BDN), then you can download the Software Development Kit (SDK) from our website. The Waterobjects.NET SDK includes Programming and Sample guide documents as well as several samples (mostly written in C#). This will help guide you through how to use Waterobjects, though in most cases a high level of programming experience will be necessary as a prerequisite.
WaterObjects.NET SDK version Compatibility
The below table outlines general compatibility between the Haestad product version and the sample projects included in the WaterObjects.NET SDK.
In general, the first six digits of the version number of the latest available release corresponds with the current WaterGEMS release. For example 10.00.00.01 corresponds with WaterGEMS 10.00.00.50. If in doubt on compatibility, ask technical support via the forum.
More information on the Bentley Developer Network (BDN):
Some benefits of BDN:
Successful use of Waterobjects.NET often requires advanced programming experience and the willingness to take the time to learn the API. If used properly, it can be a powerful tool in extending the product functionality. However, due to the time investment that would typically be required, when considering if Waterobjects.NET is right for you, it's important to ensure that the functionality you desire isn't already available in the product itself. Bentley's Hydraulics and Hydrology products are robust, feature rich and flexible, out of the box. Below are some examples of using product functionality to do things that you might be considering Waterobjects.NET for:
If you need to make a calculation that is a function of one or more input or result fields in the model, you can take advantage of the Formula-derived User Data Extension (UDX) feature. This allows you to create a custom field whose value is based on a formula. This feature is quite flexible and the resulting data can be used like any other model input/output field, in that you can color code on it, annotate, etc. Note that formula UDX operates on information at a given timestep, so it currently cannot be used to aggregate data for multiple timesteps (such as finding the sum, min, max for a particular field across all timesteps). More information on Formula UDX can be found here:
Creating Formula Based User Data Extensions
Let's say for example you want to locate all junctions that are at a dead-end, then convert them all to hydrants. This can be done in the program already, by first using the "dead end junctions" predefined query (accessible from View > Queries or View > Network Navigator) to select the dead end nodes, then select Tools > Batch Morph, click the "selection" option, choose Hydrant as the new node type, then click OK. There are many other useful queries available in Network Navigator.
See article: Using Waterobjects.NET for SewerCAD
In general, support for Waterobjects.NET is provided by way of the community forum (including Bentley developers and other users). For general information on Waterobjects.NET and the Bentley Developer Network, post your question to the BDN forum (available to BDN members - must be signed in and a member of the community or the link will not work)
For other, technical questions such as how to program something or problems with your tool, use the Haestad | Hydraulics and Hydrology Community
For consulting services on developing a Waterobjects.NET tool, contact your Bentley Account Manager (sales representative).
Product TechNotes and FAQs
Haestad Methods Product Tech Notes And FAQs