Project Options

Note: This is documentation for version 5.0 of Source. For a different version of Source, select the relevant space by using the Spaces menu in the toolbar above

Project Options

 

Configuration settings that are project-specific are accessed via Edit » Project Options. These settings are saved with your project, and if you share the project with another person, the settings will persist. 

Audit Log Settings

The audit log keeps track of the changes made to a project over time. This is particularly useful for projects that are worked on by multiple people, but can become a processing burden, especially in the case of large projects. Audit logging is on by default, but can be disabled by toggling off Enable Logging. Additional comments can be added to the project by enabling the Force Comments on Save  option. 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. 

Figure 1. Project Options, Audit Log Settings

Auto Export Run Results

This features provides a method for automatically exporting the recorded run results to .res.csv files when the model run is complete. If the Export Results After Run option is selected the files will be either exported to the specified Export Path or if a path has not been specified a Folder named Results  will be automatically generated in the same location as the saved .rsproj. By default the results file will be saved with a combination of the Project Name - Scenario Name - Run Date and Time.res.csv. The Run number can also be added to the name of the results file if the Append Run Number option is selected

Figure 2. Project Options, Auto Export Run Settings

Data Format

Various identifiers can be used for missing data in a time series. All missing time series data within a project must have the same identifier assigned to it. In the example below the identifier has been assigned as -9999.

Figure 3. Project Options, Data Format

 

Performance

To improve model run time performance the option to disable the Data Sources Explorer, and Function Manager has been provided. Performance gains may be marginal if these options are activated, however in very large projects enabling these options will most likely enhance the performance of the model run.

Figure 4. Project Options, Performance

 

Project Summary Export

The Project Summary Export  allows for the project summary to be saved to either the specified location or by default the to same location as the saved .rsproj file. The export on Save cannot be enable until the project has been saved.

Figure 5. Project Options, Project Summary Export

 

Result Manager Options

You can specify the default start of the water year, and choose how this change will affect existing statistics. There are three Update Mode options available:

  • Do not update – only new statistics will use the new value. This is the default;

  • Update all – update any existing statistics to the new water year; and

  • Update unchanged – update any existing statistics that have not been changed from the previous default. Regardless of the default, you can change the start of water year for a single result or custom chart on the Statistics view for that result.

For example, the start of the water year is set to 1 Oct. You create a custom chart, it has the default water year start date of 1 Oct. You also create an annual aggregator transform and change the water year start date from 1 Oct to 1 Jan. Later, you change the default water year start date in Project Options to 1 Jul. Regardless of which update mode you choose, all new statistics will use 1 Jul. If you choose Do not update, the custom chart and aggregator will continue to use their previous values, 1 Oct and 1 Jan, respectively. If you choose Update all, the custom chart and the annual aggregator will both use the new default, 1 Jul. If you choose Update unchanged, the custom chart will use 1 Jul, but the aggregator will continue to use 1 Jan, because it has already been changed from the previous default of 1 Oct.

Figure 2. Project Options, Result Manager Options

 

Run Results Storage

 

Run Results storage will allow the user to select the method to store the Run results of the project. The options are streaming run results to disk or keeping them in memory. The default options selected for all project is 'In memory'.

 

 

Non-timeseries based recorders are currently disabled when using results streaming. An example of non-timeseries based recorders would be BorrowAndPaybackRecorder, FullOrderRecorder and ModelTimingsRecorder.

Files generated are considered intermediary files and not final outputs. Hence the files are stored in the LocalAppData similar to the project temp location (C:\Users\<User Name>\AppData\Local\Source\X.X.X\TempRunData)

These files are removed when a project is closed or a run is deleted from Results Manager.

The format used (called Source Time Series Database .sdb) is now also available as a general time series format.  There is also a new command line utility for interacting with the format: Source.DataUtility.exe run with --help to see the instructions for interacting with the utility.

Unit Preferences

Here you can configure the default display units used in Source. On the Category Defaults tab, model properties have been grouped logically into categories (Figure 3, Table 1), allowing you to set different unit preferences for each category. For example, you can choose different preferences for rainfall and depth, although they both use the same dimension of length. The available categories, their system defaults and their dimensions are listed in Table 1. On the Defaults tab, you can configure the defaults used for properties not associated with any category (Figure 4). The available dimensions, their system defaults, and the other available unit options are listed in Table 2.

Figure 3. Unit Preferences, Category defaults
Figure 4. Unit Preferences,  Defaults not in a category
Table 1. Unit Preferences, Category defaults

Category

System default

Category dimensions

Category

System default

Category dimensions

Crop area

hectare (ha)

Length2

Depletion

millimetres (mm)

Length

Depth and elevation

metres (m)

Length

Extraction or demand rate

megalitres per day (ML/d)

Length3.Time−1

Extraction or demand volume

megalitres (ML)

Length3

Flow rate

megalitres per day (ML/d)

Length3.Time−1

Flow volume

megalitres (ML)

Length3

Moisture

millimetres (mm)

Length

Rainfall and evaporation depth

millimetres (mm)

Length

Rainfall and evaporation rate

millimetres per day (mm/d)

Length3.Time−1

River length

kilometres (km)

Length

Storage/Wetland volume

megalitres (ML)

Length3

Water surface area (storage/wetland or river reach area)

square kilometres (km2)

Length2