To create a new geometry dataset:

  1. From the Geometry Editor, go to the Geometry menu and click New. The Create New Geometry dialog box will open.
  2. In the Name box, enter a name for the geometry dataset (e.g., GeometeryData1 in Create New Geometry – Example with HEC-ResSim Network).
  3. Optionally, enter a description in the Description box (this is recommended).
  4. From the Network dropdown list, select the desired ResSim reservoir network (e.g., ExerciseWQ).



 Create New Geometry – Example with HEC-ResSim Network
There are two possible scenarios for importing the HEC-RAS geometry shapefile: First Import: This is the initial time importing the shapefile. Subsequent Import: The shapefile has been previously imported for an existing HEC-ResSim geometry dataset. Steps for importing the HEC-RAS geometry shapefile:
To import the HEC-RAS geometry shapefile (*.shp):

1.From the Create New Geometry dialog (as shown in Create New Geometry – Example with HEC-ResSim Network), click the Import button next to the RAS Geometry dropdown menu. The Import RAS Geometry dialog box will open.


Import HEC-RAS Geometry Dialog Box

2. From the Import RAS Geometry dialog box (shown in the Import HEC-RAS Geometry Dialog Box), click the browse buttonnext to the Shapefile field. An Open window will appear, allowing you to select  Files of type Shapefile (*.shp).



Open Browser Window

3. From the Open browser window, navigate to the location of the HEC-RAS geometry shapefile (.shp) of interest. Select the appropriate file (e.g., RR_XS.shp), and the File name field will update with the name of the selected file. Click Open. The Open browser window will close, and the selected shapefile path will appear in the Shapefile field of the Import RAS Geometry dialog box.



Import RAS Geometry Dialog Box – Shapefile Selection

4. In the Import RAS Geometry dialog box (Import RAS Geometry Dialog Box – Shapefile Selection), the River, Reach and Stream Station dropdown lists  automatically select the best attribute field estimate from the selected shapefile. If needed, select the appropriate attribute (shapefile column name) from the dropdown lists.

5. Click OK. The Import RAS Geometry dialog box will close, and the selected shapefile name will be added to the list of imported HEC-RAS geometry shapefiles. Note that imported HEC-RAS geometry shapefiles are listed in the RAS Geometry field in the Create New Geometry dialog box.

To select a previously imported HEC-RAS geometry shapefile (*.shp):

  1. In the Create New Geometry dialog, from the RAS Geometry dropdown (as shown in the Create New Geometry – Example with HEC-RAS Geometry), select the name of the previously imported HEC-RAS geometry shapefile (e.g., RR_XS) that you want to use.


Create New Geometry – Example with HEC-RAS Geometry

After importing the HEC-RAS geometry file has been imported, or selecting it from a previously imported shapefile, the next step is to select the HEC-RAS steady flow file. To do this:

  1. In the Create New Geometry dialog box, click the browse button button next to the RAS Steady Flow File field. An Open browser window will appear. In the Files of type dropdown, select RAS Steady Flow Table Files (*.txt).

2. Navigate to the location of the desired HEC-RAS steady flow text file (.txt). Select the appropriate file, and the File name field will update with the selected file's name. Click Open. Open browser window will close, and the selected filename and path will appear in the RAS Steady Flow File box in the Create New Geometry dialog box (Create New Geometry – Completed Example).


Create New Geometry – Completed Example

3. Click OK to create the new water quality geometry using the selected Network, RAS Geometry, and RAS Steady Flow File. The Create New Geometry dialog box will close, and the Geometry Editor will update, reflecting the newly created geometry dataset (Geometry Editor – Create New Geometry Example Completed).



Geometry Editor – Create New Geometry Example Completed

If the OK button is clicked in the Create New Geometry dialog box without selecting a ResSim Network, a No Network Selected message will appear. Similarly, if the OK button is clicked without selecting an RAS Geometry, a No RAS Geometry Selected message will appear. Both message dialogs will inform the user that the missing files must be selected before the geometry can be created (Missing Geometry File Message Windows – left No Network Selected – right No RAS Geometry Selected).



Missing Geometry File Message Windows – left No Network Selected – right No RAS Geometry Selected

In either message dialog, click OK and select the missing file from the Create New Geometry dialog. Once the required files are selected, click OK to create the new water quality geometry for the chosen ResSim Network, RAS Geometry, and RAS Steady Flow File. The Create New Geometry dialog box will close, and the Geometry Editor will update with the newly created geometry dataset.

Additionally, the Create New Geometry dialog checks that the entered geometry dataset Name (e.g., GeometryData1) is unique. If the name is not unique, a Duplicate Name message dialog will appear, informing the user that the name already exists and must be changed.

From the Duplicate Name message dialog, click OK to close it (Duplicate Name – Geometry Dataset Example). Then, in the Create New Geometry dialog, change the name in the Name box and click OK. The geometry dataset will then open in the Geometry Editor.



Duplicate Name – Geometry Dataset Example

Once a new geometry is created, the Geometry Editor updates with the selected ResSim network and HEC-RAS geometry information.

The following sections provide detailed instructions for completing each tab in the Geometry Editor.

It is important to note that any changes made to the reservoir elements in the Reservoir Network module after a water quality geometry has been created will not automatically be reflected in the water quality geometry. In other words, updating the reservoir network does not automatically update the water quality geometry in ResSim. To incorporate any modified elements into the water quality simulation, a new water quality geometry must be created. Recreating the water quality geometry is essential to ensure that the changes made in the Reservoir Network module are properly integrated into the water quality simulation. Therefore, it is advisable to complete all necessary updates to the reservoir network elements before developing the water quality geometry.