Skip to content

oceanmodeling/FVCOM

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FVCOM 5.0.1

http://fvcom.smast.umassd.edu/

Code download

To download the latest version of FVCOM:
git clone https://github.com/FVCOM-GitHub/FVCOM.git

To obtain an old version of FVCOM:
git clone --branch VERSION https://github.com/FVCOM-GitHub/FVCOM.git
where VERSION is the version number. All available verions can be found on https://github.com/FVCOM-GitHub/FVCOM/releases.

Required libraries

Compilers FVCOM codes are mainly written in Fortran 90 and C language. We recommend users to use

Required/Optional libraries

Installation

  • make depends
    Generate the module dependencies of FVCOM codes. This step is required only when there are new codes added.
  • edit make.inc
    The ‘make.inc’ file includes all the settings for compiling FVCOM. This file needs to be edited correctly based on users’ interest of simulation, before the FVCOM codes are compiled. Users need to edit three parts in this file, including library environments, control flags, and compiler settings.
  • make clean
    When the ‘make.inc’ file is modified, this step is necessary to make the model compiled from the beginning with the modified settings.
  • make
    Compile the FVCOM codes. You should see the executable file ‘fvcom’ when the compilation is successful. FVCOM can be compiled in a parallel mode, with the following command:
    make -j N
    where N is the integer number specifying the maximum number of cores used for compiling the FVCOM source codes. Based on the tests with Intel® Xeon® CPU E5-2640, the total time of compiling FVCOM is 120 s with one core. The time can be saved 40% with two cores and 54% with three cores. When more than three cores are applied, there is no large improvement on the compiling speed. The results could vary with different cpus and different flags selected. However, we recommend users compile FVCOM with 2 or 3 cores to save the compiling time.

Set up and run

  • Step 1: make a folder ‘run’ and copy/link the executable file ‘fvcom’ to this folder.
  • Step 2: prepare all required input files
  • Step 3: create the namelist file with the name of CASENAME_run.nml. You can get a blank namelist file by
    ./fvcom –create_namelist
  • Step 4: run the model.
    • To run FVCOM with single cpu
      ./fvcom –casename=CASENAME
    • To run FVCOM in the parallel way
      mpiexec ./fvcom –casename=CASENAME
      or
      mpiexec ./fvcom –casename=CASENAME
      where CASENAME is the name of simulation case and must be consistent with the prefix of the namelist file. For example, the namelist file is named as ‘gom_run.nml’, then CASENAME is ‘gom’.

Testsuite

We also provide a package of helping users to learn and run FVCOM, including benchmark test cases, offline models, necessary libraries, and processing tools. The package is available at:
https://drive.google.com/file/d/1xwcFjzkSNT26FBu83pq2I8oIGzPqnjUn/view

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Fortran 99.0%
  • Other 1.0%