Last updated January 29, 2024

Description of code and input files for the manuscript "A simple approach to represent precipitation-derived freshwater fluxes into nearshore ocean models: an FVCOM4.1 case study". 

Authors: 
Krysten Rutherford (Institute of Ocean Sciences, Fisheries and Oceans Canada, Sidney, BC; krysten.rutherford@dfo-mpo.gc.ca.)
Laura Bianucci (Institute of Ocean Sciences, Fisheries and Oceans Canada, Sidney, BC; laura.bianucci@dfo-mpo.gc.ca)
William Floyd (Vancouver Island University, Nanaimo, BC; British Columbia Ministry of Forests, Nanaimo, BC)

1. Fixed version of Finite Volume Community Ocean Model (FVCOM) version 4.1 used in the present study. Last accessed from https://github.com/FVCOM-GitHub/FVCOM on October 29, 2022. Original source code was developed by the Marine Ecosystem Dynamics Modeling Laboratory (MEDM-Lab) at the University of Massachusetts - Dartmouth, led by Dr. Changsheng Chen (https://www.fvcom.org/). See Chen et al. (2006) for more details on this model. Code, including configuration settings, are included as "FVCOM-source-Rutherford-etal-2024.zip"

2. Input files required to run 7 sensitivity tests detailed in the manuscript, including: 
    - QS_run.nml, example run file
    - General model files: 
      - QS_grd.dat, grid file
      - QS_10min_5iters_smthLapl_dep.dat, depth file
      - QS_cor.dat, coriolis file
      - QS_obc.dat, open boundary (obc) points
      - sigma.dat, sigma levels file
    - Turbulence model file: QS_newMix_gotmturb.inp
    - Atmospheric forcings: 
      - qs_1kmRes_20211001_1231_wnd_correctrotnUPDATE.nc, wind forcing from HRDPS-1km (MSC Open Data, 2022)
      - QS_1kmRes_20210901_20220101_hfx_relHum.nc and QS_1kmRes_20210901_20220101_hfx_specHum.nc, air temperature and humidity from HRDPS-1km (MSC Open Data, 2022)
      - QS_1kmRes_20210901_20220101_precip.nc, precipitation from HRDPS-1km (MSC Open Data, 2022)
    - Initial file: qs_Oct142021v7_CTDplusCIOPSWobc_its.nc, from CIOPS-W (Paquin et al. 2021)
    - Lateral boundary files: 
      - QS_tsobc_Oct-Dec_2022.nc, temperature and salinity at open boundaries, from CIOPS-W (Paquin et al. 2021)
      - QS_obc_elev_CIOPSW_2021-22.nc, SSH at open boundaries, from CIOPS-W (Paquin et al. 2021)
    - River ID files, *riv.nml, listing rivers and associated pour points to be included:
      - QS_MarbleRivONLY_riv.nml; used for Marble River Only
      - QS_FULLrivs_updatedAug2023rivproxy_riv.nml; used for All Rivers
      - QS_rivsGT20v2_riv.nml; used for Watersheds20km and Distributed18
      - QS_rivsGT50v2_riv.nml; used for Watersheds50km and Distributed6
      - QS_FULLrivs_riv.nml; used for Distributed538
    - River flux timeseries files, *_riv.nc, which include river flux, river temperature and river salinity as follows:
      - QS_NimpkishTemp_AllRivs_morePPs_Oct-Dec2021_riv.nc: used for All Rivers, Marble River Only, Watersheds50km, Watersheds20km
      - QS_NimpkishTemp_AllOver6_morePPs_Oct-Dec2021_riv.nc: used for Distributed6
      - QS_NimpkishTemp_AllOver18_morePPs_Oct-Dec2021_riv.nc: used for Distributed18
      - QS_NimpkishTemp_AllRivDiviAll_Oct-Dec_riv.nc: used for Distributed538
  

References 
Chen, C, R.C. Beardsley and G. Cowles. 2006. An unstructured grid, finite-volume coastal ocean model (FVCOM) system. Special Issue entitled "Advance in Computational Oceanography", Oceanography, vol. 19, No. 1, 78-89. 

MSC Open Data. 2022. Experimental High Resolution Deterministic Prediction System (HRDPS) 1 km West data in GRIB2 format. https://eccc-msc.github.io/open-data/msc-data/nwp_hrdps/readme_hrdps-datamart-alpha_en/, last access: 26 August 2022.

Paquin, JP, G.C. Smith, F. Dupont, S. MacDermid, Y. Hata, O. Huizy, J. Lei, Y. Martinez, M. Dunphy, M. Krassovski, S. Taylor, H. Blanken, J. Holden, N. Soontiens, S.E. Allen, D Latornell. 2021. Changes from version 1.5.0 to version 2.0.0 of the Coastal Ice Ocean Prediction System for the West Coast of Canada (CIOPS-W). Technical Note, Canadian Centre for Meteorological and Environmental Prediction. December 1st , 2021.