SWMM5 Delphi GUI Dcurve.pas Summary

 The Dcurve unit is a dialog form used in the EPA SWMM project that allows users to edit curve data for various objects within the system, such as control curves, diversion curves, pump curves, rating curves, shape curves, storage curves, and tidal curves. This form facilitates adding and modifying curve data, which is essential for simulations in SWMM.

Key Features of the Dcurve Unit:

1. Curve Selection and Editing:

   • The user can select the curve type (e.g., control curve, pump curve) using the CurveTypeCombo dropdown list.
   • The form dynamically updates the grid's column headers and input fields based on the selected curve type.
   • Users can input or modify curve data in a grid (GridEdit) that corresponds to the X and Y values for the curve.

2. Curve Data Handling:

   • The form supports loading and saving curve data to/from text files. The BtnLoadClick and BtnSaveClick procedures handle loading and saving the curve data, respectively.
   • Data is validated to ensure that no duplicate curve names exist and that the X-values are in ascending order.
   • Users can edit curve data and modify properties such as curve name and description.

3. Support for Different Curve Types:

   • The form supports various types of curves, such as:
     • Control Curve: Used for control rules.
     • Diversion Curve: Defines inflow and outflow for diversion structures.
     • Pump Curve: Defines the relationship between flow and head for pumps.
     • Rating Curve: Defines the relationship between stage and flow.
     • Shape Curve: Defines the relationship between depth and width/area.
     • Storage Curve: Defines the relationship between stage and storage.
     • Tidal Curve: Defines the relationship between stage and time for tidal flow simulations.
   • Each curve type has its own unique format and units, and the form adjusts accordingly.

4. Dynamic Grid Update:

   • The grid is populated with data from the selected curve type. Each curve type has its own header labels for X and Y axes (e.g., "Control," "Outflow," "Head," etc.).
   • For example, for pump curves, the user enters the relationship between volume, depth, and head. For rating curves, the relationship between stage and flow is entered.
   • The user can modify the data, and the form will update accordingly.

5. Validation and Error Handling:

   • The ValidateData function checks if the curve name is unique and ensures that the X-values are in ascending order.
   • If any validation error occurs (e.g., duplicate name or out-of-order values), the form prompts the user with appropriate error messages and prevents saving the data.

6. Graphical Preview:

   • The BtnViewClick procedure allows users to view a graphical representation of the curve data, such as a plot for the selected curve type.
   • The form opens a TPreviewPlotForm to display the curve's plot, helping the user visualize the curve and its behavior.

7. Help Support:

   • The form supports context-sensitive help. When the user presses the F1 key or clicks the "Help" button, it opens the help file with relevant information for the current form.

Detailed Breakdown of Functions:

• SetData: Initializes the form with the data of the curve selected for editing. It loads the curve's name, description, and curve data (X and Y values) into the grid.
• GetData: Retrieves the data entered in the form and updates the corresponding curve object.
• ValidateData: Ensures the curve name is unique and that the X-values are in ascending order. If any issues are found, it displays error messages.
• BtnOKClick: Validates and accepts the data entered into the form.
• BtnLoadClick: Opens a file dialog to load curve data from an external file into the form.
• BtnSaveClick: Opens a file dialog to save the current curve data to an external file.
• BtnViewClick: Opens a preview of the curve's graphical representation.
• CurveTypeComboClick: Adjusts the grid's column headings based on the selected curve type.
• CurveNameChange: Marks the form as modified whenever the curve name is changed.
• EditBtnClick: Opens a comment editor dialog when the "Edit" button is clicked.

Key Variables:

• CurveType: The type of the curve being edited (e.g., control curve, pump curve).
• CurveIndex: The index of the curve being edited in the project's curve list.
• FileDir: The directory where curve files are saved or loaded from.
• Modified: A flag indicating whether the form has been modified.

This form is essential for managing curves within the SWMM model, allowing users to define relationships between different hydrological variables that are central to simulations and analyses.