Installing FVCOM

From FVCOM Wiki

Revision as of 18:10, 10 November 2011 by Gcowles (Talk | contribs)
Jump to: navigation, search

This section describes the installation of FVCOM on your system. The preferred environment is Linux with OS X an option as well. Windows installation is possible but senseless.


Contents

Windows Users

It is recommended that you download and install the latest version of cygwin (http://www.cygwin.com). Cygwin is a bash shell/Unix emulation program and contains many of the tools such as tar, gzip/gunzip, and cpp which will be useful for installation and compilation of FVCOM. Also, cygwin gives Windows a decent interface with which to setup and run the model. Note that it requires basic familiarity with Unix commands.


Acquiring FVCOM

FVCOM can be obtained from the FVCOM community website through the code repository portal. Note that this section of the website is password protected. Usernames and passwords will be provided after the user agreement form has been signed. Once in the repository, read the package definitions and choose the appropriate version for your research needs. Download the gzipped tar file directly to your computer. This tar file will contain the source code, a makefile, and the test problems described NEEDLINK.

Extracting the tarfile

Extract the tarfile with the following command:

gunzip –c FVCOMxxx | tar xvf -

This will produce the top level directory: FVCOMxxx where xxx indicates the version number.

Compiling METIS

This is only necessary for users intending to use the explicit MPI parallelization. The METIS graph partitioning libraries are used to perform the domain decomposition portion of the FVCOM parallelization. These library routines are coded in the c language and must be compiled separately from the main coding. To compile the libraries, edit the makefile in the METIS source directory to point to your c compiler. It is advisable to use a c compiler from the same vendor as your intended Fortran compiler. In addition, make sure you are compiling the libraries using the same architecture (currently 32 or 64 bit) This will help avoid compatibility problems when linking the libraries and the FVCOM code. To compile the libraries, use “make”. A successful build will produce the file libmetis.a which will be linked during the FVCOM build. Note that if you do not intend to use FVCOM in a multiprocessor environment, it is not necessary to build these libraries.

Personal tools