Download

Download

CROCO is a new oceanic modeling system built upon ROMS_AGRIF and the non-hydrostatic kernel of SNH  gradually including algorithms from MARS3D.

CROCO project contains source code and croco_tools pre-and-post-processing matlab toolbox.

CROCO is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. CROCO is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Download stable release

  • CROCO_TOOLS uses several Datasets also available for download below.

Datasets

All external datasets (8.9G): DATASETS_CROCOTOOLS.tar.gz [ 03/01/2022 updated version : correction in WOA2009 ; see below ]

CARS2009 (7.7G): CARS2009.tar.gz
COADS05 (103M): COADS05.tar.gz
GOT99 (8.9M): GOT99.2.tar.gz
m_map (126M): m_map1.4f.tar.gz
QuickSCAT (43M): QuikSCAT_clim.tar.gz
SeaWifs: SeaWifs.tar.gz
SST Pathfinder (14M): SST_pathfinder.tar.gz
Topo (101M): Topo.tar.gz
TPX06 (145M): TPXO6.tar.gz
TPX07 (148M): TPXO7.tar.gz
WOA2009 (219M): WOA2009.tar.gz [ 03/01/2022 updated version : bug in o2 fields units corrected ]
WOAPISCES (306M): WOAPISCES.tar.gz

Tutorial configurations

Some configuration examples and associated forcing and output pre-built files used for trainings can be downloaded here.

Access for developers

Warning: Access the  CROCO project on Inria GITLAB: CROCO gitlab version is a development version evolving on a daily basis, and subjected to untested issues and eventual bugs. We strongly advise non-developers to stick on the CROCO stable version available as a tar file on the previous Download section.

  1. Fist-time user access to Inria gitlab
    • Request an account on Gitlab: if you are not already registered, please send a request to register and access the code (specify the repository you want to register to (croco or croco_tools or both), and the reason you request access to use CROCO development repositories) to: croco-gitlab-registerNO SPAM -- FILTER@NO SPAM -- FILTERinria.fr
    • Once your login is available, if you have not access to the project yet, request access with:
  2. Finally get the code
  3. Join the mailing list

Developers and advanced users can subscribe to the mailing list croco-commitsNO SPAM -- FILTER@NO SPAM -- FILTERinria.fr to follow the developments. To subscribe to this mailing-list, simply send an email to sympa_inriaNO SPAM -- FILTER@NO SPAM -- FILTERinria.fr with the subject: subscribe croco-commitsNO SPAM -- FILTER@NO SPAM -- FILTERinria.fr First name Last name. Leave the body of the message empty. To unsubscribe the mailing list, simply send an email to sympa_inriaNO SPAM -- FILTER@NO SPAM -- FILTERinria.fr with the subject: unsubscribe croco-commitsNO SPAM -- FILTER@NO SPAM -- FILTERinria.fr commits mailing list

Source code Change Log

2022

New in CROCO v1.3 (November 2022)

CROCO v1.3 is recommended for users of PISCES, MUSTANG and the coupling toolbox. In addition it includes correction of critical bugs, inconsistencies and light improvements

Environment

  • Little updates on create_config.bash : mostly comments and some little bugfixes

Coupling

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.coupling.html and https://croco-ocean.gitlabpages.inria.fr/croco_doc/tutos/tutos.16.coupling.html

  • put by default exchanges of AVERAGE fields over the coupling timestep
  • add possibility to use coupling with WRF moving nests (coupling only on the parent domain, and interpolation in WRF between the parent and moving nest for ocean surface conditions => requires to use the last version of WRF in the WRF-CROCO github fork)
  • some corrections for coupling with a toy model
  • add the possibility to create oasis restart files from pre-existing model outputs
  • coupling scripts: correct some typos, comments, and directory and grid names for oasis files and oce_compile for AROME and ECMWF

Sediment

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.modules.sediment.html

  • Test and reorganise flocculation capabilities. FLOCMOD module is present in MUSTANG and in SEDIMENT with equal routines. To avoid redundancies and clarify maintenance/dev on this module, an independent module has been be created, flocmod.F90 with interfaces in MUSTANG/SEDIMENT

Numerics and parametrisations

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.numerics.html

  • UV_HADV_UP5: change to apply UP5 to both predictor and corrector time steps to avoid checkboard noise detected in regional simulations (thanks to J. Gula)
  • GLS_MIXING: add limitation in potential flow region following Larsen and Fuhrman (2018), to prevent the instable growth of turbulent viscosity for non-breaking external or internal waves

New Configurations

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.test_cases.html

  • 1 new test cases for sediment processes (can be used with USGS or MUSTANG sediment model) :a schematized estuary (from MARS corresponding test case). From TIDAL_FLAT, the grid is set to 200×90 then the cells sizes are fixed to dx = 600m and dy = 100m. The OBC West is the same as in TIDAL_FLAT. The bathymetry is derived from MARS code with the same parameters. A river is placed on the East side with sediment input (400m3/s – 50mg/L of MUD)

Pisces

  • fix various bugs and improve robustness

Runoff

Possibility to add a source point as a volume vertical influx. With this feature there is no need to take care of the position of the source with the mask and a source can be added anywhere on the grid. The outflow is applied at rho point (cpp key PSOURCE_MASS)

Miscellaneous

  • run_croco scripts: some corrections for adequation with prod env, comments and re-organization
  • NC4 for diagnostics
  • Some fixes when writing into existing diagnostics files (diag TS, diag Momentum, Vorticity, PV, EK, PV, VRT…)
  • Various fixes when using NC4PAR
  • Move Surface atmospheric forcing and Lateral forcing cpp-keys upper in cppdefs.h
  • Output in double precisions in case of PARALLEL_FILES (to be compatible with ncjoin)
  • Put back by default previous partit.F to handle with FRC_FRY
  • Changes in compilations options for ifort and gfortran

CROCO_TOOLS

  • Improve octave compatibility
  • Add global attribute in netcdf files (notably: origin date)
  • Tides: add the possibility to create frc files with tides only, and add a routine to create tide-only frc files for interanual simulation
  • Add pre-processing scripts for downlading glorys oceanic reanalysis data.
  • Coupling: add scripts to create weight files and smoothing for the coupler (interpolation between model grids), some corrections in pre-processing for WWIII for adequations with more recent versions of WWIII, and some other minor corrections in scripts
  • Biology: Pre-processing scripts have been moved to Preprocessing_tools/Bio. Update some scripts to handle PISCES-quota
  • Nesting_tools: some small corrections

Bugfix release 1.2.1

Intermediate release v1.2.1 is fixing some bugs in v1.2

Here are the bugfix corrections :

  • ONLINE bulk: wind speed was not properly computed, with a consequent understimation of fluxes when using bulk ONLINE. This is now corrected
  • Runoff : Msrc parameter in param.h was wrongly set to 0, it is now corrected and set to 100
  • Plurimonth_scripts: DT was wrongly intialized with nesting. This is now corrected.
  • In 2D cases, the size of wrthis array was wrong. This is now corrected.
  • A typo in def_diags has been corrected
  • CVTK: some continuous integration tests have been updated

New in CROCO 1.2

Environment

The whole structure of the repository has been updated, please read carefully. It comes with a new set of scripts to help to launch production simulations. See https://croco-ocean.gitlabpages.inria.fr/croco_doc/tutos/tutos.02.contents.html for details.

  • create_config.bash: script to create a configuration environment. 2 typical modes are proposed: all-dev for the usual (“all-in”) architecture for forced CROCO runs and/or dev, and all-prod/all-prod-cpl for production run architecture and coupling with external models
  • SCRIPTS/ directory: where scripts for running croco in production mode are provided
  • croco input and output files for interannual simulations can now be named systematically with 2 digits for month: croco_…Y????M??.nc instead of croco…_Y????M?.nc (the old option is however still available)
  • croco/XIOS/process_xios_xml.sh : stand-alone cpp-process of the XIOS xml files. It is now separated from the jobcomp script. It is deployed in Run/ in all-dev setup, and in CONFIGS/PREPRO/XIOS/ in all-prod setup

Air-sea interactions

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.forcing.html

  • 1D Atmospheric Boundary Layer model (ABL)
  • Updated Bulks
  • Updated current feedback

Coupling

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.coupling.html and https://croco-ocean.gitlabpages.inria.fr/croco_doc/tutos/tutos.16.coupling.html

Sediment

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.modules.sediment.html

  • MUSTANG sediment model : MUSTANG is a sediment model developed at Ifremer and proposed in addition to the existing one from USGS
  • Bedload : improvement of robustness and new parametrization available
  • Cohesive bed : introduction of bed stratigraphy with cohesive or mixed cohesive/non-cohesive case

Numerics

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.numerics.html

  • quasi-hydro CROCO_QH : a quasi-hydrostatic option (non-traditional Coriolis terms)
  • MORPHODYN correction : improvement of robustness for morphodynamics
  • NO_TEMPERATURE and NO_TRACERS option : use only salinity as active tracer, run in fully homogeneous mode

New Configurations

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/model/model.test_cases.html

  • 3 new test cases for sediment processes (can be used with USGS or MUSTANG sediment model)
    • TIDAL_FLAT : a 2DV tidal flat with sediment mixture
    • SED_TOY : a single column case
    • DUNE : migration of a dune with different sand classes
  • 1 new realistic configuration COASTAL : a coastal configuration with a finer resolution than BENGUELA and corresponding/different settings (rivers, GLS mixing …)

Miscellaneous

  • Multiple passive tracers : the number of passive tracers is now a parameter up to 100
  • XIOS : former XIOS2 option is now the only option
  • Restart
  • NC4 for all diagnostics : all diagnostics are compatible with NetCDF4 parallel writing
  • NO_LAND and PARALLEL_FILES compatibility
  • EXACT_RESTART : bit to bit restartability

Detail list of CPP keys

Suppressed keys : ”ANA_BPFLUX’, ‘ANA_SPFLUX’, ‘BEDLOAD_SOULSBY’, ‘BULK_EP’, ‘BULK_FAIRALL’, ‘BULK_SMFLUX’, ‘BULK_SM_UPDATE’, ‘CFB_STRESS2’, ‘CFB_WIND’, ‘MLCONVEC’, ‘PLUME’, ‘SMFLUX_CFB’, ‘STFLUX_CFB’, ‘WAVE_BODY_STREAMING’, ‘XIOS2’

New keys (extented version…) : ‘ANA_DUNE’, ‘ANA_MORPHODYN’, ‘BEDLOAD_MARIEU’, ‘BEDLOAD_UP1’, ‘BEDLOAD_UP5’, ‘BEDLOAD_VANDERA’, ‘BEDLOAD_WENO5’, ‘BEDLOAD_WULIN’, ‘BED_ARMOR’, ‘BED_HIDEXP’, ‘BHFLUX’, ‘BULK_ECUMEV0’, ‘BULK_ECUMEV6’, ‘BULK_GUSTINESS’, ‘BULK_WASP’, ‘ ‘CFB_WIND_TRA’, ‘COASTAL’, ‘COHESIVE_BED’, ‘CROCO_QH’, ‘DIAGNOSTICS_BARO’, ‘DIAGNOSTICS_TSVAR’, ‘DO_NOT_OVERWRITE’, ‘DUNE’, ‘DUNE3D’, ‘ECUMEv0’, ‘ECUMEv6’, ‘EXACT_RESTART’, ‘FLOC_BBL_DISS’, ‘FLOC_TURB_DISS’, ‘GUSTINESS’, ‘HOURLY_VELOCITIES’, ‘ISOLITON’, ‘LMD_LANGMUIR’, ‘M3FAST_REINIT’, ‘MIXED_BED’, ‘MORPHODYN_MUSTANG_byHYDRO’, ‘MPI_TIME’, ‘MUSTANG’, ‘MUSTANG_CORFLUX’, ‘NO_TEMPERATURE’, ‘NO_TRACER’, ‘RVTK_DEBUG’, ‘RVTK_DEBUG_ADVANCED’, ‘RVTK_DEBUG_PERFRST’, ‘SANDBAR_OFFSHORE’, ‘SANDBAR_ONSHORE’, ‘SED_DEFLOC’, ‘SED_FLOCS’, ‘SED_TAU_CD_CONST’, ‘SED_TOY’, ‘SED_TOY_CONSOLID’, ‘SED_TOY_FLOC’, ‘SED_TOY_RESUSP’, ‘SED_TOY_ROUSE’, ‘SFLUX_CFB’, ‘SLOPE_KIRWAN’, ‘START_DATE’, ‘STOKES_DRIFT’, ‘SUBSTANCE’, ‘TAU_CRIT_WULIN’, ‘TEMPERATURE’, ‘TIDAL_FLAT’, ‘TRACERS’, ‘VILAINE’, ‘WASP’, ‘WAVE_BREAK_BJ78’, ‘ZETA_DRY_IO’, ‘key_CROCO’, ‘key_MUSTANG_V2’, ‘key_MUSTANG_bedload’, ‘key_MUSTANG_specif_outputs’, ‘key_noTSdiss_insed’, ‘key_nofluxwat_IWS’, ‘key_sand2D’, ‘key_tenfon_upwind’

New in CROCO_TOOLS 1.2

Interannual forcing pre-processing

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/tutos/tutos.05.prepro.matlab.inter.html

  • croco_pytools toolbox from Evan Mason has been removed from the repository and is now available on croco website in the documentation section https://www.croco-ocean.org/documentation/ under “Useful Links”. A new python toolbox for preparing CROCO files is under development, and will be available in a future release.
  • New option to build interannual forcing with 2 digit month format

Atmospheric forcing

  • Aforc_ERA5/ : new scripts to create atmospheric forcing using the ECMWF-ERA5 hourly reanalysis

Oceanic forcing

  • Oforc_OGCM/ : new scripts to create oceanic lateral forcing and initialisation using the CMEMS GLORYS1/12 daily reanalysis : make_OGCM_mercator.m and download_mercator_python.m

Runoff

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/tutos/tutos.12.rivers.html

  • Rivers/ : Some bug fixes regarding the runoff positioning

Coupling

full description : https://croco-ocean.gitlabpages.inria.fr/croco_doc/tutos/tutos.16.coupling.advanced.html

  • Coupling_tools: The coupling toolbox is now splitted into croco_tools/Coupling_tools and croco/SCRIPTS/SCRIPTS_COUPLING. The latter contains the full toolbox to configure and launch coupled simulations. croco_tools/Coupling_tools now contains only useful scripts for pre-processing files for the different coupled models. When using all-prod-cpl in create_config.bash, these pre-processing scripts will be placed under the PREPRO directory in your configuration directory.

2019

25 October 2019 : CROCO V1.1 RELEASE

CROCO stable release V1.1 (25 October 2019):  Download croco-v1.1

  • CROCO_TOOLS stable release V1.1 (25 October 2019):  Download croco_tools-v1.1

    • Reminders:

    CROCO sources and CROCO_TOOLS (the follow-on of ROMS_TOOLS) are now distributed separately (for croco_tools releases, see associated tab at https://www.croco-ocean.org/download/croco-project ). ROMS_AGRIF is not maintained anymore and we strongly encourage ROMS_AGRIF users to switch to CROCO. CROCO version available directly from the git repository is an unstable development version. Standard users should use the stable one downloaded from the web site.

    New in v1.1 :
    • architecture : slight changes
      • CROCO doesn’t come with a default Run directory anymore, first step as a user will be to run the script create_run.bash to create your own
      • as a consequence TEST_CASES files are now stored in croco/TEST_CASES and the scripts for running the model in croco/SCRIPTS
    • parallelisation : in MPI (not OPENMP), CROCO now has the capacity to save computation in MPI partitions set over land. A pre-processing step is required. The corresponding tool is located under croco/MPP_PREP : the namelist has to be filled with the maximum number of CPUs available, then compile and execute the code. It returns the optimal partitioning parameter values for NP_XI, NP_ETA and NNODES.
    # define MPI
# define MPI_NOLAND   (default undef)
    • outputs :
      • NetCDF4 parallel capability is available. When running with MPI activated, the outputs are stored in a single file (different from PARALLEL_FILES) but faster than with serial netcdf writing.
      # define MPI # define NC4PAR (default undef)# define MPI # define XIOS (default undef)
    • diagnostics : several budget equations added. Each of them has its corresponding section in croco.in.
      • vorticity :
      # define DIAGNOSTICS_VRT
      • eddy kinetic energy :
      # define DIAGNOSTICS_EK
      • potential vorticity
      # define DIAGNOSTICS_PV
    • grid : the resolution of a mesh can be locally refined to account for a section reduction (example : keep realistic sections for an under-resolved river canal in a realistic configuration)
    # define REDUC_SECTION  (default undef)`
    • bottom friction :
      • Spatialisation of roughness length Z0 coefficient
      # define Z0B_VAR (default undef)
      • Use sub-timesteps for computation of fast bottom friction. In this case, bottom friction is computed in step3d_fast routine
      # default BSTRESS_FAST `
    • functional : Use of calendar to define start and end date : The user can choose the beginning and the end of the simulation in croco.in , then the number of time steps will be calculated. Also print the date at each time step in screen log.
    # define USE_CALENDAR   (default undef)

    adding additional lines in croco.in : run_start_date: 01/04/2015 00:00:00 run_end_date: 12/04/2015 00:00:00

    • atmospheric forcing :
      • Use MeteoFrance inputs (Arome/Arpege) for online atmospheric reading and interpolation
      # define AROME (default undef)
      • Read atmospherical pressure from meteo files, use it in bulk flux and apply atmospherical pressure gradient in the momentum equations
      # define READ_PATM (default undef)
      • Current feedback added in bulk and forcing cases. Three possibilities: feedback on the stress (CFB_STRESS, default) using a coefficient based on the wind speed, or based on the wind stress (CFB_STRESS2), or feedback on the wind speed (CFB_WIND, less physical)
      # define SMFLUX_CFB (default undef)
    • ocean/wave coupling : add wave average outputs. Add wave-to-ocean stress accounting for wave model bulk
    • tides : Introduction of a new method for harmonic composition : use of Simon (SHOM) method to build tide elevation from harmonic constituents.
    # define TIDES_MAS    (default undef)
    • open boundaries : reduced-form equation for barotropic velocities at boundary conditions in case when tidal currents are not available (#undef UV_TIDES). It’s also useful for test cases, forcing the model with analytical sea surface elevation (for example a M2 tide). In both cases it replaces M2_FRC_BRY (in this case set #undef M2_FRC_BRY to avoid confusion) and it works with M2FLATHER and M2CHARACT obc conditions. This development comes from ROMS-Rutgers source code. This option has been tested in a tidal flat test case for each open boundary condition (north, south, west and east)
    # define OBC_REDUCED_PHYSICS (default undef)

    OBC_M2FLATHER was suppressed (redondant with OBS_M2CHARACT). Use OBS_M2CHARACT instead.

    • vertical mixing : GLS scheme was rewritten. GLS_MIX2017 cpp key was suppressed and only GLS_MIXING stays.
    #define GLS  (KEPSILON model and CANUTO stability function are chosen by default if no other key selected in cppdefs.h)

    Dedicated configuration : SINGLE_COLUMN, a 1D vertical model with several subsettings to test.

    • test cases : additions/changes
      • I_SOLITON : was previously within GRAV_ADJ (#define GRAV_ADJ_SOLITON)
      • FLUME : now SANDBAR
      • TS_HADV_TEST : new case to test horizontal advection for tracers

    2018

    26 June 2018 : CROCO V1.0 RELEASE

    CROCO stable release V1.0 (26 June 2018):  Download croco-v1.0

    CROCO_TOOLS stable release V1.0 (26 June 2018):  Download croco_tools-v1.0

    CROCO sources and CROCO_TOOLS (the follow-on of ROMS_TOOLS) are now distributed separately (for croco_tools releases, see associated tab at  https://www.croco-ocean.org/download/croco-project/ ).

    CROCO has now a new architecture tree. The OCEAN directory contains the sources.

    New in CROCO v1.0 (associated cppkey names and dedicated configuration in cppdefs.h are presented):

    • Non-hydrostatic kernel: a (3D) non-Boussinesq “fast-mode” is available.  
      • #define NBQ
      • Dedicated configurations : #define TANK, ACOUSTIC, GRAV_ADJ (NBQ), KH_INST, S2DV, MILES
      • croco.in: set CSOUND_NBQ (sound speed) to a minimum of 5 times the max external gravity wave phase speed (sqrt(gh)). Max is real sound speed of 1500 m/s. Lower sound speed allows larger time steps.
      • cppdefs.h: choice of the full scheme (NBQ_PRECISE) or for faster integration a simplified one (NBQ_PERF). In this case, the vertical grid and some non-dominant terms of the fast mode equations are only updated at the internal (slow) step. NBQ_PERF is the default option and is recommended for submesoscale applications (>10m resolution), while NBQ_PRECISE should be used for LES applications (e.g., KH_INST)
      • cppdefs.h: choice of advection scheme for vertical velocity w includes TVD and WENO (see below); default choice is W_HADV_C4 and W_VADV_SPLINES for horizontal and vertical advection respectively (see cppdefs_dev.h for default choices).
      • AGRIF nesting (1-WAY for now) is possible with NBQ and for NBQ integration in child grid only: #define NBQ_CHILD_ONLY
    • Updated Ocean-Wave-Atmosphere coupling using the generic coupler OASIS3-MCT  
      • #define OA_COUPLING and/or #define OW_COUPLING
      • See specific documentation for coupling in the Documentation section of our website ; https://www.croco-ocean.org/documentation/  ; dedicated Coupling_tools are also available in croco_tools
    • Updated Wave-Current interactions (McWilliams et al., JFM 2004)  
      • #define MRL_WCI
      • Dedicated configuration : SHOREFACE
    • Built-in wave propagation model (WKB) for nearshore applications
      • #define WKB_WAVE
    • Updates in sediments modules based on Warner et al. (2008): bedload transport, hydro-morphodynamics coupling and morphological acceleration factor
      • #define SEDIMENT and associated cppkeys
      • Dedicated configuration :  FLUME, RIP
    • Additional IO module (XIOS) providing more flexibility and better performances for HPC
      • # define XIOS
    • Choice of monotonic horizontal and vertical advection schemes for all variables (WENO5 &  TVD)
      • WENO5:  #define UV_HADV_ADV ;  UV_VADV_TVD ; W_HADV_TVD ;  W_VADV_TVD ; TS_VADV_WENO5 ; TS_HADV_WENO5
      • TVD:  # define UV_HADV_TVD ; UV_VADV_TVD ; W_HADV_TVD ; W_VADV_TVD
    • Semi-implicit vertical advection for avoiding CFL limitation associated with “hot spots” (Shchepetkin, OM 2015)
      • # define  VADV_ADAPT_IMP
    • GLS turbulent closure sub-model (in addition to KPP)  
      • # define GLS_MIXING_2017
    • Wave‐induced (non breaking) vertical mixing in KPP modified according to Wang et al. (JGR 2010) based on Qiao et al (JPO 2004)  
      • # define WAVE_NONBRK_VMIX_QIAO in mrl_wci.F
    • Basic 3D Smagorinsky model for LES-type applications   
      • # define UV_VIS_SMAGO_3D (with NBQ)
    • Built-in diffusion in barotropic time stepping as an alternative to fast mode filtering (used in NBQ applications)  
      • # define M2FILTER_NONE
    • Updated PISCES version (Aumont et Bopp, GBC 2006)  
      • # define PISCES
    • New vertical coordinate (not dependent on minimum depth), by default,  suited for decreasing pressure gradient errors in the thermocline above steep topography (Shchepetkin and McWilliams, 2009)
      • # define NEW_S_COORD
    • Dedicated log output file croco.log
      • # define LOGFILE

    ROMS_AGRIF  is not maintained anymore and we strongly encourage ROMS_AGRIF users to switch  to CROCO.

    Known problems and fixes : 

    29 July 2019

    • In croco_tools/Rivers : Update and Bug fix in River (  Bug fixes in the T/S_src seasonal cycle ;  Bug fix in direction/sense in case of not using all the rivers detected ; New rivers detection criteria, new plots, ..)
    • In croco_tools/Aforc_NCEP : Update url security level https
    • In croco_tools/Oforc_OGCM : Bug fix  to download SODA oceanic data using make_OGCM ; ( use Opendap_tools_noloaddap ;  cancel dimension shifting for 3D variables )

    17 June 2019 :

    • In croco/OCEAN, fixes in analytical.F : bug fix and improvements from the development branch. Thanks to P. Marchesiello
    • the treatment of the ramp when using the cpp keys #define PSOURCE_NCFILE and /or #define PSOURCE_NCFILE_TS
    • other stuff …

    Fixes in check_domain_runoff.m  : to manage rotated grid.

    05 September 2018 : in croco/OCEAN, fixes in get_psource_ts.F  . Thanks to S. Pous

    30 July 2018 : in croco/OCEAN, fixes in read_inp.F : to read wind stress from croco_frc.nc files in case of #define BULK_FLUX  and #!define BULK_SMFLUX

    Tools Change Log

    2019

    25 October 2019:  CROCO_TOOLS V1.1 RELEASE

    New in v1.1 :

    • Aforc_CFSR : new specific directory dedicated to CFSR atmospheric forcing processing
    • croco_pyvisu : a new powerful visualization gui (as croco_gui) in Python (Thanks to S. Le Gentil, LOPS/Ifremer), portable on every supercomputer.
    • Preprocessing_tools:
    • Insert Easy interactive grid maker (adapted from J. Molemaker (UCLA) package) within make_grid and the croco_tools package (allows grid rotation and parameter adjustment)
    • Add new filter used in smoothgrid.m (adapted by P. Penven from A. Shchepetkin) with option set in crocotools_param.h
    • Rivers : several update to manage variable flows and/or concentration (temperature, salinity, bigeochemical tracers, …) from input netCDF files.

    CONTENTS:

    • start.m: script to set the Matlab paths
    • crocotools_param.m: script that contains the necessary parameters for the generation of the CROCO input NetCDF files
    • Aforc_ECMWF/: Scripts for the recovery of surface forcing data (based on ECMWF reanalysis) for inter-annual simulations
    • Aforc_CFSR/: Scripts for the recovery of surface forcing data (based on CFSR reanalysis) for inter-annual simulations
    • Aforc_NCEP/: Scripts for the recovery of surface forcing data (based on NCEP reanalysis) for inter-annual simulations
    • Aforc_QuikSCAT/ : Scripts for the recovery of wind stress from satellite scatterometer data (QuickSCAT)
    • Coupling_tools/: Scripts for building and running coupled configurations (with atmosphere and/or wave models)
    • croco_pytools/ : Preprocessing Python scripts for preparing the grid, forcing, initialization files
    • croco_pyvisu/ : A new portable visualization gui (as croco_gui) but in Python
    • Diagnostic_tools/ : A few Matlab scripts for animations and basic statistical analysis
    • Forecast_tools/ : Scripts for the generation of an operational oceanic forecast system
    • Nesting_tools/ : Preprocessing tools used to prepare nested models
    • Oforc_OGCM/ : Scripts for the recovery of initial and lateral boundary conditions from global OGCMs (SODA (Carton et al., 2005) or ECCO (Stammer et al., 1999)) for inter-annual simulations
    • Opendap_tools/ : LoadDAP mexcdf and several scripts to automatically download data over the Internet
    • Opendap_tools_no_loaddap/ : same as Opendap_tools but use the built-in support for OPeNDAP from Matlab >= 2012a. You do not need to install libdap and loaddap library. Note that you can also access to local data.
    • Preprocessing_tools/ : Preprocessing Matlab scripts (make_grid.m, make_forcing, etc…)
    • Rivers/ : Scripts to prepare time-varying runoff forcing file and compute the runoff location
    • RUNOFF_DAI/ : runoff global climatology
    • Tides/ : Matlab routines to prepare CROCO tidal simulations. Tidal data are derived from the Oregon State University global models of ocean tides TPXO6 and TPXO7 (Egbert and Erofeeva, 2002): http://www.oce.orst.edu/research/po/research/tide/global.html
    • Town/:
    • UTILITIES/: Matlab utilities
    • Visualization_tools/ : Matlab scripts for the CROCO visualization graphic user interface

    2018

    • 28 June 2018:  CROCO_TOOLS V1.0 RELEASE
      • – former OASIS directory has been moved to Junk/oasis_old_scripts as new tools are available in Coupling_tools directory
    • March 2018: New tools:
      • – Coupling_tools scripts: scripts to help you build and run a coupled configuration
      • – croco_pytools: Python scripts, some are equivalent of croco Preprocessing_tools
      • – new default s vertical coordinate (vtransform=2, #define NEW_S_COORD) and new values of theta_s, theta_b and hc accordingly
      • – new topographic filter adapted from ucla tools
      • – all matlab utilities moved to new UTILITIES directory

    2016

    • 4 Feb. 2016 : In Aforc_NCEP/, if you were using the ROMSTOOLS v3.1.1, there was a bug in the download_CFSR.m routines.
      • We were downloading heat fluxes variable for Upward Long wave, Downward and Upward Short wave. We were using the variables AT THE TOP OF THE ATMOSPHERE that was inducing large biais in SST in all the CFSR simulation. To use the right fluxes at THE SURFACE OF THE OCEAN, the vname values in download_CFSR.m
        -Upward_Long-Wave_Rad_Flux_surface
        -Downward_Short-Wave_Rad_Flux_surface
        -Upward_Short-Wave_Rad_Flux_surface
      • Here are the fixes:
        download_CFSR.m.fix.6fev2016 5.73 kB interp_CFSR.m.fix.6fev2016 4.57 kB

    Datasets Change Log

    2014

    Date: 10 January 2013

    Author : P. Penven and G. Cambon
    Category : Update
    Description: Updated QSCAT/SCOW wind stress climatology (Risien and Chelton 2008)

    2012

    Date: 18 december 2012

    Author : G. Cambon
    Category : Bug fix
    Description: Add the Iron dust deposition forcing netcdf file (dust.iron.cdf) in WOAPISCES datasets. Needed for PISCES bgc model

    Archive

    UTILITIES  CROCO_TOOLS V1.0 (compatible ROMSTOOLS V3.1.1, V3.1, V3.0, V2.2, V2.1)

    DOWNLOAD toolboxes or softwares needed by CROCO_TOOLS | V1.0, 12 February  2017 | m_map1.4h updated

    • ./croco_tools/UTILITIES/air_sea/
    • ./croco_tools/UTILITIES/export_fig/
    • ./croco_tools/UTILITIES/mask/
    • ./croco_tools/UTILITIES/mexcdf/
    • ./croco_tools/UTILITIES/netcdf_matlab_60/
    • ./croco_tools/UTILITIES/m_map1.4h/
    • ./croco_tools/UTILITIES/netcdf_g77/
    • ./croco_tools/UTILITIES/netcdf_ifc/
    • ./croco_tools/UTILITIES/netcdf_x86_64

    UTILITIES ROMSTOOLS V3.0 (compatible V3.1.1, V3.1, V3.0, V2.2, V2.1)

    DOWNLOAD toolboxes or softwares needed by ROMSTOOLS | V3.0, 21 December 2012

    • ./Roms_tools/air_sea/
    • ./Roms_tools/export_fig/
    • ./Roms_tools/mask/
    • ./Roms_tools/mexcdf/
    • ./Roms_tools/netcdf_matlab_60/
    • ./Roms_tools/m_map1.4/
    • ./Roms_tools/netcdf_g77/
    • ./Roms_tools/netcdf_ifc/
    • ./Roms_tools/netcdf_x86_64

    untarall.csh (a little csh script to uncompress and untar all the downloaded files) – size 1k

    Utilities Change Log

    2012

    Date: 21 December 2012

    Author : G. Cambon & P. Marchesiello
    Category : Release v3.0
    Description :

    • Add the export_fig subdirectory : to modify and create nice eps and pdf plots using Matlab

    2010

    Date: 13 July 2010

    Author : G. Cambon
    Category : Release v2.1
    Description :

    • Update m_map version
    • Update netcdf librairy for Matlab : change mexnc/ and netcdf_toolbox by mexcdf/netcdf_toolbox and mexcdf/mexnc, works on Matlab 7 and Matlab 8 (tested on R2008a), on both 32 and 64 bits plateforms.
    • Add (but not used yet) mexcdf/snc_tools
    • Replace mex60 by netcdf_matlab_60 , for Matlab 6 : work on both 32 and 64 bits plateforms.

    Search