HYPE Files

README for HYPE version 5.19.3 released 2023-06-26
----------------------------------------------------------

HYPE, HYdrological Predictions for the Environments, is a
semi-distributed process based hydrological model used operationally
at the Swedish Meteorological and Hydrological Institute (SMHI).

HYSS, HYdrological Simulation System, is a wrapper which handles
calibration, simulation, input data and writing results to files. It
has also been used to run HBV and some research models.

HYSS and HYPE source code is released under the Lesser Gnu Public
License v3.0 http://www.gnu.org/copyleft/lesser.html. Pre- and post-
processing programs are not included.

Version 5.19.3 has been developed at SMHI (http://www.smhi.se/). This
is an open source version and we hope to find co-developers
outside SMHI and receive input and suggestions for improvements for
future versions.

Project home page: http://hypecode.smhi.se

Contact:
Charlotta Pers	charlotta.pers@smhi.se (HYPE and HYSS code)
Contact through the forum is prefered:
https://sourceforge.net/projects/hype/forums/ -> Help
https://sourceforge.net/projects/hype/forums/ -> Open discussion

Executable files
----------------
hype and hype_assimilation (extract from hype_5_19_3_exe.tgz) - HYPE 
model compiled for Linux with gfortran 8.5.0. Tested on RHELS 8.8. 
Demand access to gfortran dynamic library (libgfortran.so). One 
compiled with data assimilation code and one without.

HYPE.exe and HYPE_DA.exe (extract from hype_5_19_3_exe.zip) - HYPE model 
compiled for Windows with ifort 14.0.3.202. Tested on Windows 10. 
One compiled with data assimilation code and one without.

See wiki (http://www.smhi.net/hype/wiki/doku.php?id=start:hype_file_reference)
for information about the files needed to run HYPE. Examples of model
set-ups in the demos in the release folders at https://sourceforge.net/projects/hype/files.

----------------------------------------------------------------------
Compiling HYSS/HYPE
----------------------------------------------------------------------

HYPE compiles with ifort and gfortran. In the supplied makefiles the 
ifort compiler is used for Windows and the gfortran compiler for Linux. 
If you want to use another Fortran compiler you need to change the 
makefiles. 

Linux
-----
tar -zxvf hype_5_19_3_src.tgz 
make hype
or
make hype_assimilation -f makefile_assimilation

Resulting file is named hype and hype_assimilation respective.


Windows
-------
Unzip hype_5_19_3_src.zip and run MAK_HYPE.bat

Resulting file is named HYPE.exe.

No make file for assimilation code for Windows available.

-------------------------------------------------------------------
Development
-------------------------------------------------------------------

Contact us to become a member of the project by writing to one of the
e-mail adresses above or go to http://sourceforge.net/p/hype/_members/
and follow instructions. If you don't have a user at sourceforge, 
register at https://sourceforge.net/user/registration before joining 
the project.

How to get the code, short version:

git clone git://git.code.sf.net/p/hype/code hype-code (read-only)
git clone ssh://username@git.code.sf.net/p/hype/code hype-code (read/write) 

Long version:

Read and follow http://sourceforge.net/p/forge/documentation/Git/

Git downloads and documentation:
http://git-scm.com/download
http://git-scm.com/documentation