Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Edit through the REST API

A Source model consists of two parts - a project and one or more scenarios. A project is a collection of one or more scenarios. It identifies the project name (also the file name), description, and any scenarios associated with the project. You can only have one project file open at a time and you should not open the same project file using more than one copy of Source.

...

  • A schematic scenario is primarily concerned with modelling longer time-scales;
  • An operations scenario is primarily concerned with shorter time-scales. It utilises facilities for forecasting and working with unaccounted differences, and typically makes heavy use of the Tabular Editor; and
  • A catchments scenario which deals with the management of upland catchment processes. It is usually constructed using the Geographic Wizard for catchments which is a structured sequence of steps that guides you through the construction process.
  • A single catchment scenario builder allows to build a simple catchment scenario to be used for testing purposes. 

...

Info
iconfalse

Note: You must upgrade a project if it was created in Source v3.1.0 or earlier. If you open these projects in later versions of Source, an error message (shown in Figure 5) will appear prompting you to save in v3.1.0. Follow the steps outlined in the dialog to automatically upgrade the project to the current version of Source.

Figure 5. Opening a project, error

 

Copying a scenario

You can duplicate existing scenarios, provided they are part of the same project. You may want to do this if you wish to experiment with variations without affecting your original scenario.

...

The new (copied) scenario will be a duplicate of the original at the time of the copy. 

Figure 6. Copy Scenario

Renaming a scenario

Source automatically gives new scenarios the default name of "Scenario #n" , where n is a number. To rename a scenario:

  • Select the scenario in the Project Hierarchy; and
  • Once the scenario name is selected, pause then click again. When the entry is highlighted, you can enter a new name. Remember that scenario names must be unique within a project.

Linking scenarios

You can link two scenarios using a Connecting Models. Note that some components of the first scenario may not pass on to the second, linked scenario. 

Anchor
compscen
compscen
 Comparing Scenarios

The full version of Source has functionality for determining the difference between scenarios. For more information please see Troubleshooting and Debugging

Anchor
Copying network elements
Copying network elements
Copying network elements

When copying a partial scenario, the effect on each network element is different, see Nodes and Links - Copying and pasting.

Audit Log

 The audit log keeps track of the changes made to a project over time. This is particularly important for projects that are worked on by multiple people.  It contains a combination of software generated information on model changes and provides an opportunity for users to annotate the purpose of those changes with a commit message when the project is saved.

Figure 7.  Audit Log Commit Message

Image Modified


Commit messages are used to group software generated logs in a way that makes sense to users working on the project. If the same issue is being worked on in multiple concurrent sessions, you can select Merge with current task to group the logs under the previous commit message.

Figure 8. Audit Log Viewer



A large audit log attached to a project can become a processing burden, especially in the case of large projects. Audit logging is on by default, but can be disabled in Edit »Project Options» Audit Log Settings by toggling off Enable Logging.  

Figure 9. Project Options, Audit Log Settings

Click Clear Audit Log to delete all existing entries in the audit log. This can be useful if you have finished one stage of modelling (eg. building your model) and now want to monitor the changes made to the project from this point forward. Before clearing the log you can export the existing entries by opening the Audit Log Viewer (select View » Audit Logs...), right-click on a cell and choose Copy All and paste contents into a text file or Excel file.
It is possible to permanently turn on the audit log, by toggling on Force Comment on Save. You will no longer be able to toggle Enable Logging, and Clear Audit Log will also be disabled. This is a permanent project change, and you will receive several warning messages asking you to confirm before the change is made. 

...