Users guide updated

Makefile

 # Makefile for LAKE model
 
  exec = lake.out
- #f90comp=ifort#mpif90
- f90comp=gfortran
+ #FC=ifort#mpif90
+ FC=gfortran
  check_keys = # -check bounds -check pointers
  debug_keys = #-g # debugger
 
- ifeq ($(f90comp),ifort)
+ ifeq ($(FC),ifort)
    opt_keys = -openmp #-O3
  endif
- ifeq ($(f90comp),gfortran)
+ ifeq ($(FC),gfortran)
    opt_keys = -fopenmp #-O3
  endif
 
@@ -22,7 +22,7 @@
 #  Build the executable
  all :
 	cd ./source && make all && cd ..
-	$(f90comp) $(objfiles_path)*.o $(debug_keys) $(check_keys) $(opt_keys) -o $(exec)
+	$(FC) $(objfiles_path)*.o $(debug_keys) $(check_keys) $(opt_keys) -o $(exec)
 
 # Clean all
 clean :

docs/users_guide.tex

@@ -48,11 +48,10 @@ Short Users's guide on Linux}
 \maketitle 
 
 \section{Compiling the model and creating a project}
-The main prerequisite to install the LAKE model is the Fortran compiler.
-It is recommended that you use Intel compiler, that is free under Linux
-for non-commercial purposes. Intel compiler is set by default in the model install configuration (\emph{./Makefile}, \emph{./source/Makefile}).
-So, if you want to use another compiler, you have to change these makefiles 
-accordingly. So, once you unpacked the LAKE model archive just type in the model root folder
+The only prerequisite to install LAKE model is Fortran compiler.
+The model can be built from source code by GNU and Intel Fortran compilers. GNU compiler is set by default in the model install configuration. Install configuration is given in files \emph{./Makefile} and \emph{./source/Makefile}. If you want to use Intel compiler, you have to change variable \emph{FC} in these makefiles to \emph{ifort}. 
+
+Once you unpacked the LAKE model archive just type in the model root folder
 
 \begin{lstlisting}
 user@computer:~/LAKE/lake$ make all
@@ -434,6 +433,20 @@ The model is launched by typing in the terminal
 user@computer:~/LAKE/lake$ ./lake.out
 \end{lstlisting}
 
+However, it usually happen that you need to run the model with different configurations (input parameters). In this case we recommend to use the script \emph{launch} in a root folder. To run the model you invoke this script with an argument specifying the experiment label
+
+\begin{lstlisting}
+user@computer:~/LAKE/lake$ ./launch <project_name>_<spec>
+\end{lstlisting}
+for instance
+
+\begin{lstlisting}
+user@computer:~/LAKE/lake$ ./launch Valkea-Kotinen2006_base
+\end{lstlisting}
+This script does the following. It runs the model, the model writes output data to \emph{results/Valkea-Kotinen2006}, then the script creates \emph{results/Valkea-Kotinen2006\_base} and copies there the content of \emph{results/Valkea-Kotinen2006}, \emph{setup/Valkea-Kotinen2006\_setup.dat} and \emph{setup/Valkea-Kotinen2006\_driver.dat}. As a result, both model output and configuration files of an experiment labeled as $base$ are written in a specific directory, so you will not mix them with that from other experiments.  
+
+
+
 \section{Model output}
 The model output is written in \emph{./results/project\_name} folder.