Master Watershed Base Data

Data that resides in the watershed's main folder is called base data. Base data includes all data that supplies information displayed in the Setup, Acquisition, and Visualization modules. Base data includes: maps, layers, layouts, reports, scripts, extract/post information, all model alternatives, shared and study information, and CWMS data. Base data does not include data needed to run the forecast. More detailed information on forecast data is described in Team Forecasting.

This section explains how to determine which local base data files are up-to-date, how to download base data from the master watershed, and how to upload revised files back to the master watershed.

Master Watershed Synchronization Dialog

The Master Watershed Synchronization dialog is used to upload or download base data to and from the master watershed. From the CWMS CAVI main window, click on the Setup tab. Under the Watershed menu, point to Team and select Sync with Master Watershed. The Master Watershed Synchronization dialog will open.

Within the Master Watershed Synchronization dialog, the base data is displayed in the Synchronization Tree. Each node in the Synchronization Tree represents a data group for the watershed. The data groups reflect the folder structure of the current watershed folder.

The Watershed Data node is a special data group. This data group represents three folders in the watershed's folder structure - study, reports, and layouts.

Hovering the mouse over a node in the Synchronization Tree displays a tool tip that provides information on what watershed folder(s) represent the data group; what master watershed folder(s) represent the data group; what the version is for the local copy of the watershed; what the version is for the server copy of the watershed; and any comments.

For the example shown, the top node is Demo (1/2). This is the name of the watershed. The top node represents all the data groups under the watershed's main folder. If you upload or download this node, all watershed base data will be transferred.

There are two numbers shown in parenthesis next to each data group node. In the above example, the HMS folder has (1/2) displayed. The first number (left) represents the version of the watershed that is stored on your computer. The second number (right) represents the version of the master watershed. If the top number is less than the bottom number, the master watershed folder has been updated and the changes need to be downloaded to your local copy. For example, HMS (1/2) informs you that the HMS folder on the local copy of the watershed is version 1, and the master watershed is version 2. If the numbers were "(0/0)" or "(Na/Na)", this means the folder has never been uploaded to the master watershed. NOTE: the first number will never be greater than the second number.

In addition to the displayed version numbers, the Synchronization Tree nodes will highlight in white, yellow or orange depending on the node's revision state. The different colors and their meaning are listed in the Legend area below the Synchronization Tree. 

The highlight colors represent the following information:

• White - Nodes highlighted in white means that the local watershed copy is up-to-date with the master watershed copy for those data groups. The version number displayed next to the node name will have both numbers matching, for example: CAVI (1/1).
• Orange - Nodes highlighted in orange mean that the master watershed has a newer version of the files in a data group than the local watershed copy. The files need to be downloaded from the master watershed. The version numbers displayed next to the node name will show the top number is less than the bottom number. For example: Watershed Data (1/2) indicates the local watershed copy version is 1, and the master watershed version is 2. To download the files, select a highlighted node (orange), the Master Watershed Synchronization dialog will display an Actions box. From that box, click Download.
• Yellow - Nodes highlighted in yellow mean that the data group has not been uploaded to the master watershed. For example, if the FIA data group displays FIA (0/0) or FIA (Na/Na), this means there is no version for the data group on the mater watershed. To upload the files, select a highlighted node (yellow), the Master Watershed Synchronization dialog will display an Actions box. From that box, click Upload.

In the Team section of the Master Watershed Synchronization dialog, when you select a data group, information about that data is displayed. In addition, the Actions box provides you with commands that allow you to interact with the selected data group:

• Upload - Allows you to upload the selected data group node to the master watershed.
• Download - Allows you to download the latest version of the selected data group node from the master watershed.
• Protect - Only available when the status of the selected data group node is unprotected. This option allows you to prevent other team members from uploading changes for a data group to the master watershed. If the data group node is already protected, you will see an Unprotect option. 
• Unprotect - Only available when the status of the data group node is protected. Selecting Unprotect will allow sharing of the master watershed so you can upload changes for the selected data group.
• Diff... - Allows you to compare what is on your local copy of the watershed to what is on the master copy of the watershed. 

Below the Action box is the revision information for a selected data group:

• Revision - Displays the revision number of the local watershed on your computer and the master watershed as "# Of #", respectively. The first number represents the version number of the selected data group for the local copy of the watershed on your computer. The second number is the revision number of the selected data group on the master watershed. If the two numbers are the same, this means that you have the most recent copy of the master watershed for the selected data group. If they are not the same, then you are not working on the most recent copy of the selected data group and need to download the updated data group from the master watershed.
• Updated On - Reports the date, time, and username of the person who last updated the selected data group on the master watershed (format - "DDMMMYYYY, HH:MM by: <username>"). The date is set by the team member who made the revisions (computer date and time). The username displayed is that team member's CWMS login username.
• Status - Reports if the version of the selected data group from the local copy of the watershed on your computer is Current or Out of Date. The Current status means that your computer's version of the selected data group and the master watershed version are the same. The Out of Date status means that the current master watershed version is newer than the copy of the selected data group that is currently on your computer.
• Comments - Displays comments made (entered during the upload) on the last revision on the master watershed.
• History - Opens the Revision History dialog which provides detailed information on all the revisions made to the master watershed data (further details about the Revision History dialog is available in the Team Forecasting section of this chapter).

Downloading Base Data

If base data has been changed for the master watershed, you can download the data from the Master Watershed Synchronization dialog.

To download base data from the master watershed: 

1. From the CAVI main window, open the team watershed that is stored on your computer. Click the Setup tab.
2. From the Watershed menu, point to Team and select Sync with Master Watershed. The Master Watershed Synchronization dialog will open.
3. From the Synchronization Tree, select the data group node that you want to download. Hovering the mouse pointer over the node will display information about the data group node.
4. From the Master Watershed Synchronization dialog, click Download. The Download from Master Watershed dialog will open.
   
5. Click Yes, the Download from Master Watershed window will close and the download process will start.

During the download process, the Master Watershed Synchronization dialog will disable and display a Downloading indicator.


A Download tab will display in the Message Pane, providing status updates during the download process.

When the download is complete, a notification message will display and the Master Watershed Synchronization dialog will become active again.

Once you have downloaded all files needed, close the Master Watershed Synchronization dialog.

Uploading Base Data

Changes made to the base data on the local copy of the master watershed can be uploaded to the master watershed's base data and then shared with other team members. If other team members have the same watershed open in CWMS during the upload, the team members will receive real-time notification messages indicating that the master watershed has been updated after the upload is complete.

To upload changes to the master watershed's base data: 

1. From CAVI main window, open the team watershed that is on your computer, click the Setup tab.
2. From the Watershed menu, point to Team and select Sync to Master Watershed. The Master Watershed Synchronization dialog will open.
3. From the Synchronization Tree, select the data group node that you need to upload the files for in the master watershed. From the Actions box click Upload.
   
4. The Enter Upload Comments dialog will display. Enter comments about the files that you are uploading. These comments will be seen by other team members as part of the revision.
5. Click OK and the upload process will start. The watershed will close in the CAVI main window and the Master Watershed Synchronization dialog will become inactive and display an Uploading indicator.
   

An Upload tab will display in the Message Pane, providing status updates during the upload process.

When the upload is complete, the watershed will reopen in the CAVI main window and the Master Watershed Synchronization dialog will become active again. A Real-Time Notification Message will indicate which files have been uploaded to the master watershed. Any team members that have the same master watershed open on their computer will also receive a notification.

If you do not have the most recent files, and then try to upload changes, you will get an Out of Date message, preventing you from accidentally deleting another team member's changes.

Click OK to download the outdated files. Downloading files is further explained in the section titled Downloading Base Data.

Out of Date with Master Watershed

If new files have been uploaded to the master watershed, an Out of Date with Master Watershed dialog will display when you open the watershed, prompting you to update any files that are out of date.

The Out of Date with Master Watershed dialog consists of the Data Group table and Update and History buttons. The out-of-date data groups will have a checkmark in the Update column of the Data Group table by default. To download the latest master watershed version of the data groups, click Update. All data groups in the Data Group table with checkmarks will be updated. The Out of Date with Master Watershed dialog (and your watershed) will close as the files begin updating.

The columns of the Data Group table represent the following information:

• Update - Checking the box in the column will select the row's data group, ensuring those files will be uploaded to the master watershed when uploading begins.
• Model -  Displays the data group name. To view the watershed folders associated with the data group, hover the mouse over a data group name in the column and a tooltip will display showing the associated data for that data group.
• Local Rev. - Displays the revision number for the data group of the master watershed stored on your computer.
• Master Rev. - Displays the master watershed's revision number for the data group.
• Comments - Displays the last comment provided for the revision on the master watershed.

At the bottom of the Out of Date with Master Watershed dialog is a History button. The History button is active when a row is selected in the table. Clicking the History button displays the Revision History dialog for the selected row. The Revision History dialog displays a list of detailed information on the versions for the data group.