6. Troubleshooting

6.1. How to report an issue of this manual?

Please submit your issue via our GitHub page.

6.2. How to join your email-list?

Please join our email-list here.

6.3. How to create a directory?

Please search the web using this phrase if you do not know how to create a folder or directory

6.4. How to unzip a file

Please search the web using this phrase if you do not know how to unzip a file

6.5. A text editor

A program to edit plain text files. If you search on the web using the phrase ‘text editor’ you will find numerous programs. These include for example, NotePad, EditPad, Text Pad etc

6.6. Command prompt

From Start select run –type cmd – this will open a window. Change directory to the location of where you stored your files. The following website may be helpful if you do not know what a command prompt is: http://dosprompt.info/

6.7. Day of year [DOY]

January 1st is day 1, February 1st is day 32. If you search on the web using the phrase ‘day of year calendar’ you will find tables that allow rapid conversions. Remember that after February 28th DOY will be different between leap years and non-leap years.

6.8. ESTM output

First time steps of storage output could give NaN values during the initial converging phase.

6.9. First things to Check if the program seems to have problems

  • Check the problems.txt file.
  • Check file options – in RunControl.nml.
  • Look in the output directory for the SS_FileChoices.txt. This allows you to check all options that were used in the run. You may want to compare it with the original version supplied with the model.
  • Note there can not be missing time steps in the data. If you need help with this you may want to checkout UMEP

6.9.1. A pop-up saying “file path not found”

This means the program cannot find the file paths defined in RunControl.nml file. Possible solutions:

  • Check that you have created the folder that you specified in RunControl.nml.
  • Check does the output directory exist?
  • Check that you have a single or double quotes around the FileInputPath, FileOutputPath and FileCode

====“%sat_vap_press.f temp=0.0000 pressure dectime”==== Temperature is zero in the calculation of water vapour pressure parameterization.

  • You don’t need to worry if the temperature should be (is) 0°C.
  • If it should not be 0°C this suggests that there is a problem with the data.

6.9.2. %T changed to fit limits

  • [TL =0.1]/ [TL =39.9] You may want to change the coefficients for surface resistance. If you have data from these temperatures, we would happily determine them.

6.9.3. %Iteration loop stopped for too stable conditions.

  • [zL]/[USTAR] This warning indicates that the atmospheric stability gets above 2. In these conditions MO theory is not necessarily valid. The iteration loop to calculate the Obukhov length and friction velocity is stopped so that stability does not get too high values. This is something you do not need to worry as it does not mean wrong input data.

6.9.4. “Reference to undefined variable, array element or function result”

  • Parameter(s) missing from input files.

See also the error messages provided in problems.txt and warnings.txt