Team forecasting allows multiple modelers to work on the same forecast simultaneously. Each team member has a copy of the master watershed forecast on their computer. Changes that are uploaded to the master watershed forecast can be downloaded and modified by other team members.

If the forecast requires CWMS data, the team member creating the forecast is the only modeler that needs access to the CWMS servers, because once the forecast is created, it will contain all the extracted forecast input data needed to compute.

The following sections go over retrieving a team forecast from the master watershed, creating a new team forecast, uploading and downloading team forecast changes, and the available team tools to help with this process.

Retrieve a Team Forecast

Once a forecast has be uploaded to the master watershed, it can be shared with other team members as a team forecast.

Note – When retrieving team forecasts from the master watershed, a forecast cannot be open in the Modeling module. If a forecast is open, you will be unable to download a team.

To download a team forecast from a master watershed: 

1. First, from the CWMS CAVI main window, open the master watershed that is on your computer, click the Modeling tab. Do not open a forecast, if you have a forecast open, close the forecast.
2. From the Forecast Tabs (Figure 1), click on Team. Click Download, the Choose Forecast to Download dialog will open (Figure 2).
   
   
3. From the Existing box (Figure 2), select the forecast you would like to download from the list, click Download. A Download from Master Watershed confirmation message will display.
4. Click Yes, the download will begin. A Download tab will display in the Message Pane, providing status updates during the download process.
5. When the download is finished a Download Complete window will display. Click Yes, the forecast will open.

Creating a Team Forecast

To create a team forecast, use your local copy of the master watershed and create a forecast as you normally would. Once the forecast is created you can upload it to the master watershed before or after you compute it.

To create a team forecast: 

1. First, from the CWMS CAVI main window, open the master watershed that is on your computer, click the Modeling tab. Steps for creating a new forecast are detailed in CWMS Forecasts.
2. From the Forecast Run Details area (Figure 3), select a forecast. From the Forecast Tabs (Figure 1), click Team.
3. Click Upload (Figure 3), the Enter Upload Comments dialog will appear open.
   
4. In the Enter Upload Comments dialog, enter information about the upload click OK.

The forecast will temporarily close in CWMS and the upload will begin. Once the upload is complete, the forecast will display in the Modeling tab (Figure 4). More team forecasting information will display on the Team tab now that the forecast is a team forecast.

Uploading Forecast Changes

Changes made to the team forecast on your computer can be uploaded to the master watershed and shared with other team members. If other team members have the forecast open in CWMS, the team members will receive a notification message that the master watershed has been updated. The uploaded forecast changes can include all the forecast data or a single model alternative's data.

When uploading a single model alternative's data, only the model alternative's data and the model alternative's DSS records will be uploaded to the master watershed. If uploading the entire forecast, all model alternatives and the entire forecast.dss file will be uploaded.

Note - Before making changes and uploading forecast data, the status displayed in the Team tab needs to read Current. The Current status means you have a copy of the most recent changes from the master watershed on your computer. This copy can be changed once it is downloaded. Best practice would be to download the forecast to the current status and then make changes to the model alternatives. This prevents you from unintentionally erasing data that has been changed since you last updated your local data files.

To upload the changes for the team forecast to the master watershed: 

1. First, from the CWMS CAVI main window, open the master watershed that is on your computer, click the Modeling tab. From the Forecast menu, open a team forecast.
2. From the Forecast Run Details area (Figure 5), select a forecast. From the selected forecast tree, click on a model alternative. For example, in Figure 5, the MFP model alterative has been selected.
   
3. From the Actions box (Figure 5), click Upload, the Enter Upload Comments dialog will open. Enter comments on the upload in the text field. When you are done, click OK, the upload will begin.

Note – You can upload ALL data for the selected forecast by checking the Upload All Files checkbox located on the bottom left-hand side of the Enter Upload Comments dialog. This will override all the data for that forecast model in the master watershed, not just the changes.

If you try to upload changes for a model alternative and the current local revision number does not match what is on the master watershed, you will be notified that your model alternative is out-of-date and prompts you to download the latest changes from the master watershed.

When the upload starts, the forecast will close and an Upload tab will appear in the Message Pane on the CAVI. The Upload tab displays information on the files uploading.

When the upload is complete, the real-time notification messages will appear on the bottom right-hand side of your monitor screen and the forecast will be re- opened and displayed again in the CAVI.

If changes have been made within a team forecast, the affected model alternative's icon will display two red arrows, indicating that your local copy is no longer current (Figure 6).

When attempting to close a team forecast without first uploading changes to the master watershed, the Copy Model Changes dialog (Figure 7) will prompt you to sync your changes.

To upload the changes to the master watershed from the Copy Model Changes dialog (Figure 7):

1. Select the model alternatives to sync with the master watershed by selecting the check next to their name. Any model alternatives that do not match the copies in the master watershed will be checked by default. The MFP and HMS model alternatives need to be synced with the master watershed in the example (Figure 7).
2. Copy to Base updates changes in model files from the forecast folders back to the watershed "base" model folders.
3. Click Sync to Master, an Enter Upload Comments dialog will open for each model alternative selected to sync.
4. Enter upload comments and click OK to start the upload process. An Upload message tab will display in the Message Pane. The tab will display the status message during the upload.

If your local files are not current, you will receive an Out Of Date warning reminding you to sync with the master copy before making and uploading changes.

Downloading Forecast Changes

Changes made to the team forecast on the master watershed can be downloaded to your computer's team forecast copy. You can download the entire forecast or a single model alternative's data. When downloading a single model's data, only the model alternative's data and DSS records will be downloaded to your local copy. If downloading the entire forecast, all model alternatives and the entire forecast.dss file will be copied. 

Note – It is important to download any files that have been updated before you start making revisions to the files on your copy. This is to ensure you don't accidentally override another modeler's changes.

To download team forecast changes to your local copy of the forecast: 

1. First open the forecast in the CAVI on your computer.
2. Select the forecast run or model alternative node in the Forecast Tree you would like to download changes for. For example, in Figure 8, the HEC-HMS model alternative is selected.
   
3. From the Team tab, click the Upload button in the Actions (Figure 8).
4. The Download from Master Watershed message will appear.
5. Click Yes to continue with the download. If you would like to override all files for the selected forecast Node you are downloading, check the Download All Files checkbox before clicking Yes.

The forecast will close in the CAVI and the download will start. A Download tab will appear in the Message Pane that displays information on the download. 

When the download is complete, the forecast will re-open in the CAVI and a real-time message will appear on the bottom right-hand side of your screen. 

The download will replace any out-of-date files for the selected Forecast Tree node on your computer with the files from the master watershed and the Revision information on the Team tab will update. Only the files that have had a revision update on the master watershed will be downloaded.

Team Forecast Tab

The Team tab is located with the bottom of the Modeling tab and provides access to team forecasts, and allows you to upload, download, and protect forecast data. It also provides detailed information on the forecast data's revision information and history. Each of these features are explained in more detail in the following sections.

The Forecasts box displayed at the top of the Team tab shows the Forecast Tree, which displays the different forecast runs and model alternatives for the forecast. When a node is selected in the Forecast Tree, the bottom half of the tab will populate with information about forecast teaming on that selected forecast data. For example, if a forecast run node is selected, the Team area reflects the information for that specific forecast run. If a model alternative is selected in the tree, the Team tab will display information on that particular model alternative in the forecast run. If there are no team forecasts open and the watershed is a master watershed, the Team tab will display a Download button that allows you to select a pre-existing team forecast on the master watershed and download it to your computer.

For example, in Figure 9, displays the MFP model alternative "No Future Rain" selected in the Forecast Tree and the Team tab displaying information on that particular model alternative.

The following sections go over the different features provided in the Team tab in detail.

Action Buttons

Depending on what is selected in the Forecast Tree, the Actions area provides Upload, Download, Protect, and UnProtect buttons (Figure 10). These different options allow you to interact directly with the master watershed forecast.

The Actions box includes the following:

If the forecast or model alternative are already protected, you will see an UnProtect option.

Once you unprotect the data, Protect becomes available again.

If a forecast is not open on the Modeling tab, only the Download button will be available to download Team forecasts from the master watershed.

Revision Pane

The Team Tab also displays information on team forecast revisions. This information can be found directly underneath the Actions box (Figure 11).

The revision information displays for the selected node in the Forecast Tree. The information includes the following:

Revision History Dialog

The Revision History dialog (Figure 12) is available on the forecast's Team tab through the History button. It is also available on the Out of Date with Master Watershed dialog. It displays detailed information on the versions for the watershed data selected in the forecast or Synchronization Tree.

Clicking on a row of the table populates the bottom section of the Revision History dialog with expanded information from the columns: Node, Number, Author, Date, Type, and Description. Expanded descriptions of the features of the Revision History dialog can be found in the following sections.

Revision Table and Details Panel

The Revision Table is located the top of the Revision History dialog, directly underneath the name of the master watershed. Each row in the table displays information on a revision that has been made. The revisions are group by forecast and then model alternative (Figure 13).

When a row is selected in the table, the information on the Details panel is populated for the selected revision in the lower half of the Revision History dialog.

The table and panel contain the following information:

The UPLOADED option indicates the revision changed when the modeler uploaded new data to the master watershed.

The PROTECTED option displays when the modeler changed the status of the data to Protected Mode. It prevents others from uploading changes to the master watershed data.

The UNPROTECTED option displays when a modeler has changed the status of the data out of the Protected Mode. This means that others can start to upload changes to the master watershed again.

Additional information at the bottom of the Revision History dialog includes:
Description, Files, and File Changes.