Introduction to Running UVAFME - UVAFME/UVAFME_model GitHub Wiki

UVAFME is written in Fortran(90), and can be run on a Linux platform and easily compiled on a Linux system with the ifort compiler. Each site simulated in UVAFME is independent from other sites. Thus, when simulating multiple sites, UVAFME runs them in succession. This setup means that UVAFME simulations may be run `interactively' (i.e. from an active command line session), or distributed across several linux nodes via a job manager such as SLURM.

Files needed to run UVAFME

In order to successfully run UVAFME, all the necessary files must be present in the correct directories and with the correct naming system. These files/folders must be present (though they need not be named as below):

  • UVAFME_vx: the UVAFME executable file; the vx denotes version

  • file_list.txt: the text file that tells the model where the input/output directories are located

  • input_data: the input directory/ies

  • output_data: the output directory

These files and folders need not be all in the same directory, but you must be sure to specify where these folders are located in file_list.txt.

For a basic run, you must have these files present in the input directory:

  • UVAFME2018_runtime.txt
  • UVAFME2018_rangelist.csv
  • UVAFME2018_specieslist.csv
  • UVAFME2018_litterpars.csv
  • UVAFME2018_climate.csv
  • UVAFME2018_climate_stddev.csv
  • UVAFME2018_climate_ex.csv
  • UVAFME2018_climate_ex_stddev.csv
  • UVAFME2018_sitelist.csv
  • UVAFME2018_site.csv

See the How To Guide for more information about input/output files and parameterization.

Running the Model

After you have prepared your input files and are ready to run the program, use the command ./UVAFME_vx file_list.txt in a terminal or command prompt window. This will run the model. Once the model has finished running, your output files will be in the output_data directory.

See the How To Guide or the website for more information.