Using Source: Troubleshooting and FAQs

This section contains a collection of hints and tips that may assist you if Source appears to misbehave or otherwise malfunction on your system.

Check prerequisites

Source is designed to operate in a particular computing environment and may malfunction if any of its design assumptions do not hold. When investigatin problems, your first check should be that your computer system meets the minimum system requirements.

Window placement issues

Source supports the ability to rearrange the structure, relationship and placement of dockable windows to support your workflow. Some of these settings persist across invocations of Source so that the choices you make about arranging your workspace are preserved. The settings are specific to:
  • The version of Source that you are using and are not reset if you uninstall and reinstall a given version of Source; and
  • Your user account on the computer on which Source is installed.
In most cases, choosing View » Reset All Windows will cause all dockable windows to return to their default locations. However, where this command fails to have the desired effect, it may be necessary for you to remove the settings file manually. This file is created automatically when you re-launch Source so there is no need to make a backup before you remove it.

On a Windows 7 system, the settings file should be located at the following path:
<drive>\Users\<user>\AppData\<profile>\eWater CRC\eWater Source\<version>\DockPanel.config

On a Windows XP system, the settings file should be located at the following path:
<drive>\Documents and Settings\<user>\Application Data\eWater CRC\eWater Source\<version>\DockPanel.config
Where the sub-folders are as defined previously.
Note: Your system administrator may have made changes to where settings files are stored on your computer so you should only view the information in this section as a guide. If you can not identify the settings file that needs to be removed, you should ask your system administrator.

To delete the settings file, you should:
  • Quit Source. If you do not quit Source, this procedure will not work;
  • Use Windows Explorer to identify and open the folder containing the settings file that is appropriate for your system;
  • Delete the settings file - generally with a .config file extension (eg right-click and choose Delete from the contextual menu); and
  • Re-launch Source.
Note: Your system administrator may have restricted your ability to delete preference files. Ask your system administrator if you are unable to delete the settings file.

Windows resolution

Source does not support Windows accessibility features such as the options in Windows 7 at:
Control Panel » Appearance and Personalisation » Display

or in the Appearance tab of the Display control panel under Windows XP, which allows you to change the size of text and other items on your screen by adopting a system-wide scaling factor other than 100%. Neither does Source inherently support screen resolutions other than the native or "recommended" resolution of the display(s) that are connected to your computer (eg. 96ppi).

If you adopt a scaling factor other than 100% or change your screen resolution to achieve a similar effect, you may not be able to access all of Source’s on-screen controls.

Data file formats (dates and time)

Data file format issues are often the result of incorrectly-formatted date and/or time entries. If Source is unable to interpret your data file, it raises an exception called LoadDataFileIOException. If you see this error, you will need to check your data input. You may also need to check your data if you use an ambiguous date format rather than the recommended ISO-8601 format.

Possible problems with time-steps

The only known case where a time-step may be incorrectly detected when reading a file is on a computer with U.S settings, due to the mm/dd/yyyy date format. This may happen if the whole of a daily time series covers less than 13 days, or less than 12 months for a monthly time series. Users working on such computers should use the recommended ISO 8601 format to prevent ambiguity.

Examples

Parsing the following file would raise an exception. Missing entries are not allowed since their interpretation may lead to ambiguities (ie. missing data, or zero record).
2000-01-01,0.9
2000-01-02,2.2
2000-01-05,1.1
2000-01-06,1.1
The following file, generated with Excel, will be recognised as a monthly time series on a computer with U.S culture (locale) settings, but loading it on a computer with different culture settings will likely fail:
01/01/2000,0.1
02/01/2000,0.8
03/01/2000,0.6
04/01/2000,0.9
05/01/2000,0.6
06/01/2000,0.4
07/01/2000,0.6
08/01/2000,0.2
09/01/2000,0.8
10/01/2000,0.6
11/01/2000,0.3
12/01/2000,0.1
01/01/2001,0.389
02/01/2001,0.389

Plugins related

When installing a new version of Source, ensure that the old version does not have any plugins loaded. If it does, remove them using Tools » Plugin Manager. In the resulting window, select the plugin and click Remove. In some instances, after loading a plugin, Source might display an error and terminate prematurely. Click on View Program details to view details of the error. Refer to Plugins when working with externally created plugins.

Feedback and Knowledge Base