CROCO includes the source code written in Fortran, and the pre- and post-processing tools, necessary to build and analyze realistic configurations, written in Matlab and Python. The code and tools are open source. The parts of the code inherited from the ROMS model are made available under the conditions of the MIT/X license, those inherited from the AGRIF library under the terms of the CeCILL-C license. The Matlab tools are made available under the terms of the GNU license, the Python tools under the terms of the GPL3 license.
Please refer to the How to cite page for citation.

Download the code and utilities
Recommended download for non-developers is the last stable release:
- CROCO source code: stable release (v2.1.1) : September 26, 2025
- Python pre-/post-processing CROCO_PYTOOLS: stable release (v2.0.3) : February 04, 2026
- Matlab pre-/post-processing CROCO_TOOLS: stable release (v2.1.1) : September 26, 2025
Developers can refer to the “Access for developers” section of the About page.
Source code Change Log and other available releases
- CROCO full changelogs and releases list
- CROCO_TOOLS full changelogs and releases list
- CROCO_PYTOOLS full changelogs and releases list
Join the CROCO users mailing list
We strongly encourage all users to join our mailing list (low traffic; announcements, updates, bug fixes): croco-users@lists.gforge.inria.fr
- To subscribe, simply send an email to croco-users-joinNO SPAM -- FILTER@NO SPAM -- FILTERlists.gforge.inria.fr
- To unsubscribe, simply send an email to croco-users-leaveNO SPAM -- FILTER@NO SPAM -- FILTERlists.gforge.inria.fr
Documentation
- CROCO’s documentation and tutorials
- CROCO_PYTOOLS (Python) documentation
- CROCO_TOOLS (Matlab) documentation
You can also visit CROCO users forum for discussions, and questions about the code and tools.
Training slides
Next training sessions: see the Trainings page.
Additional notes
- CROCO time stepping (Florian Lemarié) : PDF
- CROCO NBQ time stepping (Francis Auclair, Laurent Debreu) : PDF
Download useful datasets and example configurations
Some configuration examples and associated forcing and output pre-built files used for trainings can be downloaded hereafter.
Warning: between a few 10 Mb to 100 Gb. Use of wget is recommended
Climatological datasets and atlases
CROCO_TOOLS uses several datasets also available for download: all datasets (8.9G) DATASETS_CROCOTOOLS.tar.gz [ last update : 03/09/2024 ] or inidividually:
- CARS2009.tar.gz (7.7G)
- COADS05.tar.gz (103M)
- GOT99.2.tar.gz (8.9M)
- gshhs.tar.gz (256M)
- m_map1.4f.tar.gz (126M)
- QuikSCAT_clim.tar.gz (43M)
- SeaWifs.tar.gz
- SST_pathfinder.tar.gz (14M)
- Topo.tar.gz (101M)
- TPXO6.tar.gz (145M) [ 03/09/2024 updated version : add units attribute ]
- TPXO7.tar.gz (148M) [ 03/09/2024 updated version : add units attribute ]
- WOA2009.tar.gz (219M) [ 03/01/2022 updated version ]
- bug in o2 fields units corrected
- WOAPISCES.tar.gz (306M) [ 14/02/2024 updated version ]
- DUST_INCA_new_r360x180.nc
- Ndep_CMIP_NCAR-CCMI-2-0_gn_199001-201012-clim.nc files
Some Global Datasets for interannual preprocessing
- MERCATOR GLORYS 1/4° monthly reanalysis oceanic forcings in a special format compliant with Matlab croco_tools (1.7 Gb/month):
- ERA5 6-hourly atmospheric forcings in a special format compliant with Matlab croco_tools (~2Gb/month):
- CFSR or CFSV2 grib2 atmospheric forcing files for 2013/01 — 2013/03, useful for coupling with WRF tutorials (4.4 Gb/month)
- Global static ‘geog’ to build WRF grid using geogrid.exe (2.6 Gb)
Some idealized test cases
BENGUELA_LR Regional configuration (#define REGIONAL in cppdefs.h)
- Input files for BENGUELA_LR configuration ( Y2005M01 — Y2005M03 )
- BENGUELA region datasets for preprocessing ( Y2005M01 — Y2005M04 )
- for CROCO_TOOLS
- atmo. forcings:
- oceanic forcings:
- SODA 1/2 monthly reanalysis (1 Mb)
- MERCATOR GLORYS 1/12 monthly reanalysis ( 40 Mb)
- for REAL.EXE
- CFSR ‘met’ files (for real.exe) (639 Mb) + WRF grid (geo_em.d01.nc) (1.9 Mb)
- for CROCO_TOOLS
- Full BENGUELA_LR configuration examples
- Forced interanual configuration: (1 Gb) Y2005M01-Y2005M03, using the classical framework based on
run_inter_croco.bashscript - Coupled (WRF-CROCO) interanual configuration: (2.1 Gb) Y2005M01-Y2005M03, using the updated framework for coupled simulations based on submitjob.sh script
- Forced interanual configuration: (1 Gb) Y2005M01-Y2005M03, using the classical framework based on
Coastal configuration (#define COASTAL in cppdefs.h)
CROCOlive, tutorials and Docker from A. Sepulveda
http://mosa.dgeo.udec.cl/LiveCROCO/
https://github.com/AndresSepulveda/docker-croco-public/blob/master/Dockerfile
