Customizing Dashboard Widgets

The Dashboard includes five types of widgets:

• Map Panel - Displays a watershed map.
• Model Actions - Integrates forecast-related functionality from the Actions tab in the Modeling module.
• Plot Panel - Visualizes time series data in graphical format.
• Tabulate Panel - Presents time series data in tabular format. 
• Text Block - Displays formatted text, including HTML content.

This guide explains how to customize each widget type.

Customizing a Map Panel

The Map Panel displays a snapshot of the watershed map from the Modeling tab. Once added to the Dashboard, it no longer syncs with changes made in the Modeling module—and vice versa.

To customize a map panel:

1. Right-click the map panel tab (e.g., Map Panel 001) and select Properties.
2. The Properties Editor dialog will open, allowing you to modify various settings.
3. To edit, click the ellipsis (…) next to the corresponding Value cell:
   1. Tab Name - Rename the tab.
   2. Map Panel Name - Rename the map panel.
   3. Zoom Coordinates - Define the map's initial view extent.
   4. Border and Layout - Adjust the map's appearance and arrangement.
4. Click Apply to save changes, then OK to close the dialog.

Adjusting the Zoom Level

You can adjust the zoom level of the map in two ways:

• Use the magnifying glass icon on the left side of the panel.
• Or, use your mouse scroll wheel to zoom in/out.

Customizing Model Actions

The Model Actions widget embeds forecast model interactions from the Modeling module’s Actions tab into the Dashboard. When first added, the widget displays the forecast name and a Forecast Run dropdown.

To add model actions:

1. Right-click below the dropdown menu and select Edit Actions.
2. In the Select Workflow Actions dialog:
   1. Use the left dropdown to choose from these categories:
      1. CWMS CAVI - Forecast: Actions from the Modeling tab's Forecast menu.
      2. CWMS CAVI - Forecast Run: Actions tied to specific forecast alternatives.
      3. CWMS CAVI - Scripts: User-defined scripts.
      4. CWMS CAVI - Team: Team Watershed actions.
      5. Model Name: Actions unique to the selected model.
   2. Use the right dropdown to assign actions to a specific forecast alternative or to All Forecast Runs.
3. Click OK to exit the dialog.

If the same action exists in both locations, it appears only once, with priority given to the specific forecast alternative. This ordering ensures a logical flow and prevents duplication of actions.

Customizing a Plot Panel

The Plot Panel allows you to graph time series data.

To configure a plot panel:

1. Right-click the plot panel tab (e.g., Plot Panel 001) and select Properties.
2. In the Properties Editor dialog, click on the ellipsis next to the desired Value field to modify the properties:
   1. Name - Rename the component.
   2. Dss Records - Add HEC-DSS data.
   3. Maximum Height - Adjust the maximum height.
   4. Minimum Height - Adjust the minimum height.
   5. Plot Template - Apply a visual template.
3. Click Apply, then OK to close the dialog.

Adding Data from HEC-DSS Records

To add data to the plot widget from an HEC-DSS record:

1. In the Properties Editor, click the ellipsis next to Dss Records.
2. From the new dialog, click Add Records.
   
3. In the Browse DSS dialog, navigate to the desired HEC-DSS file and open it.
4. Select the relevant pathnames and click Add Pathnames.
   
5. A prompt will ask if you want to set the model F Parts using relative pathnames.
   
   
   1. Yes - Replaces the F Part with percent signs (%), enabling data to switch between forecast alternatives.
   2. No - Locks data to the selected model alternative.
6. Close the Browse Dss dialog.
7. Click Apply, then OK to return to the Properties Editor dialog.
8. Click Apply to save changes, then OK to close the dialog.

The selected data will appear in the plot panel.

Customizing the Plot Appearance

To customize the appearance of a plot within the Dashboard:

1. Click the Properties Editor icon to open the Plot Panel Properties dialog.
   
2. Adjust the settings of the plot as desired. You can modify line styles, labels, and legends as needed.
    
3. Use Select Viewport to navigate between graphs.
4. After finalizing edits click Apply, then OK to close the dialog.

Managing Viewports

To add or remove viewports:

1. In the Properties Editor, click the plus (+) button under Components to add additional viewports to the plot panel.
2. Click the minus (-) button to remove any unwanted viewports. 

Customizing a Tabulate Panel

The Tabulate Panel displays time series data in table format.

To configure a tabulate panel:

1. Right-click the tab of the Tabulate Panel (e.g., Tabulate Panel 001) and select Properties.
2. In the Properties Editor dialog, click on the ellipsis next to the desired Value field to modify the properties.

Adding Data from HEC-DSS Records

To add data, follow the same steps used to add data to a plot panel.

Customizing a Text Block

The Text Block widget allows you to add HTML-formatted notes, links, and dynamic variables.

To customize a text block:

1. Right-click the text block tab (e.g., Text Block 001) and select Properties.
2. In the Properties Editor dialog, click on the ellipsis next to the Display Text field.
3. Enter your text in the dialog box and click OK.
4. Click Apply to save your changes and OK to close the dialog.

Common HTML Tags

You can use standard HTML tags to format your text. Here are some common tags:

 Visit this site for more HTML examples.

Dynamic Placeholders

You can embed real-time information using the following variables:

• $FORECAST$ - Current forecast name.
• $WATERSHED$ - Current watershed name.

Additional Recources

Refer to this tutorial for a step-by-step guide to building a Dashboard to support HEC-HMS model calibration.