diff --git a/tutorial.html b/tutorial.html index df1690e..9ef0dec 100644 --- a/tutorial.html +++ b/tutorial.html @@ -121,6 +121,8 @@
  • Error because python is not added to the PATH
  • Error because the path has white spaces included
  • Error because the python libraries are installed incorrectly
  • +
  • Error because the settings file is not stored as utf-8 file
  • +
  • Error because the references are used wrong
  • Running the model 1
  • @@ -248,21 +250,23 @@

    5. Tu
  • Error because python is not added to the PATH

  • Error because the path has white spaces included

  • Error because the python libraries are installed incorrectly

  • +
  • Error because the settings file is not stored as utf-8 file

  • +
  • Error because the references are used wrong

  • -
  • Running the model 1

  • -
  • Downloading and installing the spatial dataset

  • -
  • Changing the Settings file

  • -
  • Error and exception handling

  • -
  • Running the model 2

  • -
  • Changing parameters of the model

  • -
  • Changing the Output

    +
  • Running the model 1

  • +
  • Downloading and installing the spatial dataset

  • +
  • Changing the Settings file

  • +
  • Error and exception handling

  • +
  • Running the model 2

  • +
  • Changing parameters of the model

  • +
  • Changing the Output

  • @@ -442,9 +446,31 @@

    Error because the python libraries are i +
    +

    Error because the settings file is not stored as utf-8 file

    +

    If the model causing an error which look like this:

    +
    UnicodeDecodeError: 'utf-8' codec can't decode byte 0x83 in position 1504: invalid start byte
    +
    +
    +

    It is because the file was not stored as utf-8 (Unicode Transformation Format - 8-bit) file. This can happen if you use the Windows texteditor Wordpad or Notepad. We suggest you use Notepad++ and store the file as utf-8. Might happen too, if your language use strange characters like German Umlaut.

    +
    +
    +

    Error because the references are used wrong

    +

    In the settingsfile we use references:

    +
    [FILE_PATHS]
    +PathRoot = C:\basin
    +PathMaps = $(PathRoot)/input
    +
    +
    +

    If you use the reference in the next section, you have to put in the section where you defined the reference. Here: FILE_PATHS:

    +
    [NETCDF_ATTRIBUTES]
    +metaNetcdfFile = $(FILE_PATHS:PathRoot)/metaNetcdf.xml
    +
    +
    +
    -

    Running the model 1

    +

    Running the model 1

    Warning

    The model needs a settings file as an argument. See: Settings file

    @@ -464,7 +490,7 @@

    Running the model 1 -

    Downloading and installing the spatial dataset

    +

    Downloading and installing the spatial dataset

    The spatial dataset contains:

    -

    Changing the Settings file

    +

    Changing the Settings file

    to run the model the pathes to data have to be set correctly: The information of pathes are stored in the settings file around line 80-100

    [FILE_PATHS]:

    @@ -533,12 +559,12 @@

    Changing the Settings file -

    Error and exception handling

    +

    Error and exception handling

    We try to make our program behave properly when encountering unexpected conditions. Therefore we caption a number of possible wrong inputs.

    If you get an output with an error number please look at Error handling

    -

    Running the model 2

    +

    Running the model 2

    If you type now:

    python cwatm.py settings_rhine.ini -l
     
    @@ -594,16 +620,16 @@

    Running the model 2Error handling

    -

    Changing parameters of the model

    +

    Changing parameters of the model

    Note

    An overview of possibilities is given in see Settings file

    -

    Changing the Output

    +

    Changing the Output

    -

    Output variables

    +

    Output variables

    Output can be every global defined variable in the model Variable are e.g. Precipitation, runoff, baseflow

    but also not so common variables as:

    @@ -615,7 +641,7 @@

    Output variables -

    Daily, monthly - at the end or average

    +

    Daily, monthly - at the end or average

    -

    Time series as point infomation or catchment sum or average

    +

    Time series as point infomation or catchment sum or average

    As standard time series can include values of the specific cell as defined in the settings file as Gauges But time series can also show the area sum or area average of the upstream catchment from the specific cell

    for example

    @@ -663,7 +689,7 @@

    Time series as point infomation or catch

    -

    Most important output variables - a selection

    +

    Most important output variables - a selection

    #Variable name    : Description
     discharge         : river discharge
     runoff            : runoff
    @@ -678,7 +704,7 @@ 

    Most important output variables - a sele

    -

    A list of all variables

    +

    A list of all variables

    We started a list of possible output variables. Please note that this list is under construction. We still need to fill in all descriptions and all units. You find this list at List of output variables