eWater acknowledges the NSW Government’s financial and in-kind contribution to this project through the Department of Primary Industries, the Victorian Government’s financial and in-kind contribution to this project through the Department of Environment, Land, Water and Planning, the Western Australian Government’s financial support through the Department of Water, the South Australian Government’s financial and in-kind contribution to this project through the Department of Environment, Water and Natural Resources, and the Queensland Government’s financial and in-kind contribution to this project through the Department of Natural Resources and Mines and the Department of Science, Information Technology and Innovation.
________
________
________
________
The authors and editors gratefully acknowledge contributions from: Australian Capital Territory Department of the Environment, Climate Change, Energy and Water; Bureau of Meteorology; Commonwealth Department of Environment, Water, Heritage and the Arts; Murray-Darling Basin Authority (incl MSM-Bigmod material); New South Wales Department of Water and Energy (incl IQQM material); Queensland Department of Environment and Resource Management (incl IQQM material); Sinclair Knight Merz; South Australian Department of Water, Land and Biodiversity Conservation; University of Melbourne Department of Civil and Environmental Engineering (incl NGenIRR crop modelling work); Victoria University (incl REALM material); Victorian Department of Sustainability and Environment (incl REALM material); Water for a Healthy Country Flagship, CSIRO; Western Australian Department of Water.
The contents of this publication do not purport to represent the position of the Commonwealth of Australia or the Funding Parties in any way and are presented for the purpose of informing and stimulating discussion for improved management of Basin's natural resources.
To the extent permitted by law, the copyright holders (including its employees and consultants) exclude all liability to any person for any consequences, including but not limited to all losses, damages, costs, expenses and any other compensation,arising directly or indirectly from using this report (in part or in whole) and any information or material contained in it.
Source Scientific Reference Guide
The authors acknowledge information on this website is derived from the Source Scientific Reference Guide and the Source Catchments Scientific Reference Guide:
Kelley, P. and O'Brien, A.(eds) 2012, Source Scientific Reference Guide, eWater Cooperative Research Centre, Canberra, Australia. ISBN 978-1-921543-50-0 (as for Source v3.1.0)
eWater Cooperative Research Centre 2010, Source Catchments Scientific Reference Guide, eWater Cooperative Research Centre, Canberra, Australia. ISBN 978-1-921543-30-2 (as for Source Catchments v2.0.1)
Source User Guide
The authors acknowledge this material is derived from the Source User Guide:
Delgado, P., Kelley, P., Murray, N., & Satheesh, A. 2013, Source User Guide, eWater Cooperative Research Centre, Canberra, Australia. ISBN 978-1-921543-71-5 (as for v3.1.0, June 2012).
Contact information
System Requirements
Outlined below are the minimum recommended system requirements for installing Source. Note that software installation may require the assistance of a system administrator.
| Minimum recommended requirements |
|---|
|
Up to 5GB of available space may be required, and maintaining a free hard disk space of at least 20GB is recommended.
For large models 32GB of RAM is recommended, and a minimum of four cores. For parallelisable models, the more cores the better.
If using Insight, you will also need the Microsoft Visual C++ 2010 Redistributable Package, 32-bit version (for both 32 and 64-bit machines): available here.
Download and installation
There are several versions of the Source software, all of which are available via the eWater Toolkit at toolkit.net.au. Source (public version) is freely available as soon as a free Toolkit account is created. Other versions, such as the betas or the Source version with full water sharing functionality, is restricted under certain licensing conditions.
Source Versions
Accessing and Installing the Source software
Downloading and installing the Source software is a relatively simple process.
- Visit eWater Toolkit at http://toolkit.net.au
- Create a Toolkit account and verify it using the generated email
- Log in to Toolkit
- Click on Tools. The tools you have access to, including eWater Source (public version)
- Select Source (public version), or any other Source version you require and have access to. Click download software.
- Read and agree to the Product licence agreement
- Select the main download that is most appropriate for your machine and click on it. this will begin to download a .msi file
Double click the .msi file to begin the installer. You will be asked once again to agree to Product license agreement once again.
- You will be asked to provide your toolkit login at the start, and occasionally when Source starts up after that.
Creating a toolkit account
TODO
Installing Source
Once logged in, the Source splash screen (Figure 5) appears, which provides shortcuts to various actions in Source, including:
- Creating new projects and scenarios. The commands found here are synonyms for File New » Project... and File New Scenario..., and New Scenario on the File toolbar;
- Opening recent projects. You can also find a list of recent projects at File [recent documents]
- Community news with related links; and
- Accessing troubleshooting and other useful materials using the Support / Feedback link. Note that you must have a working Internet connection for this to work.
To skip the splash screen altogether and go directly to the main screen next time Source is launched, disable the Don’t show this again checkbox at the bottom left of the screen. Display of this screen can be toggled using the same checkbox (choose Help » Splash Screen to access this splash screen).
Figure 5. Source splash screen
Launching Source
Source can be launched from your Windows start menu. The standard location is:
Start » All Programs » eWater Source n.n.n » Source
The folder containing Source also has shortcuts to various online documentation, including this user guide, and also the stand-alone version of Results Manager.
Toolkit login
When you open Source for the first time, you will be prompted to enter your Toolkit login credentials (as shown in Figure 1):
- Enable the I accept the terms in the Licence Agreement) checkbox. Refer to note below;
- If you have a Toolkit account, enter your credentials and click Login;
- If you do not have a Toolkit account, enter the credentials you wish to keep and click Register; or
- Click Cancel to exit from Source.
You must also enter proxy settings if your computer is located behind a proxy and you are unable to login. Contact your IT Department because Source may be being blocked by a local firewall.
Figure 1. Toolkit Login
If you are unable to login because of firewall or application restrictions, generating a bypass code allows you to work offline. In this case, the dialog shown in Figure 2 appears.
Figure 2. Toolkit Login, Connection error
If you wish to use Source on a computer with internet access, follow these steps to generate a bypass code:
Click the link in the error message at the top of the Toolkit Login dialog, this will open the Toolkit website in your default web browser.
- Log in using your Toolkit username and password.
- A unique by-pass code will be displayed (Figure 3), copy this by-pass code (Select all and Ctrl+C) and paste it in the Enter By-Pass Code field (Figure 2).
- Click Login to start using Source.
If you wish to use Source on a computer that cannot access the internet, follow these steps to generate a by-pass code. Note that you still need access to the internet, but it can be a different computer.
On the computer with Source:
Open Source and login to Toolkit
Click the link in the error message at the top of the Toolkit Login dialog (Figure 2). This will open a browser with a link that is specific to the computer that you are using and your Toolkit username. The link will not work because you are not connected to the internet.
- Copy this link into a text file and save it so that you can transfer it to a computer with internet access (eg. to a USB drive).
- On a computer with internet access:
- Paste the link into a web browser, this will open the Toolkit website.
- Log in to Toolkit with your username and password
- A unique by-pass code will be displayed (Figure 3), copy this by-pass code (Select all and Ctrl+C) and paste it in to another text file. Save the text file so you can transfer it back to your computer with Source.
On the computer with Source:
- Copy the by-pass code from the text file (Select all and Ctrl+C) and paste it in the Enter By-Pass Code field (Figure 2).
- Click Login to start using Source.
Figure 3. Toolkit website, bypass code
Figure 4. Toolkit Login, Offline
