Installing FVCOM

From FVCOM Wiki

(Difference between revisions)
Jump to: navigation, search
(Created page with "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...")
Line 5: Line 5:
=Windows Users=
=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.
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=
 +
 +
 +
=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.  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.

Revision as of 18:06, 10 November 2011

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.


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

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. 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