Site Map

General presentation

Articles

• How to begin with SURFEX ?
• Tile Nature
• Chemistry and aerosols
• Surface assimilation
• Tile Lakes
• Tile Sea and Ocean

Coordination

• Meetings
  • Internal CNRM Coordination
  • Surfex steering committee
• Developments to be included in future versions
  • After version 7.2: waiting contributions
  • After version 8.1: waiting contributions
• Preparation of the new versions of SURFEX
  • Points requiring a discussion between developers and users
  • Reminder of the general recommendations to mergers

Training courses

Articles

• course material
• Training course 2024

Contact us

Articles

• Advanced contacts on some parts of the code

Useful links

Workshops

• Journées Techniques Montagne
• LAKE Workshop
  • LAKE2019
• Seminars
  • C3S User Workshop on Regional Reanalysis
  • ECMWF working day - Friday 19th January 2018
  • IRSTEA working day - Wednesday 24th October 2018
  • UERRA restitution - Monday 18th December 2017
• SURFEX Users Workshops
  • SUW2017
  • SUW2019

Get the code and browser

Articles

• How to get the SURFEX code
• Code browser
• To get ECOCLIMAP only
• Tree view (by Arsene Druel)

• The versions management tool Subversion (SVN)
• The versions management tool GIT
  • 1). General introduction to GIT
  • 2). References for the inline GIT documentation
  • 3). Main principles to use GIT for the SURFEX code

Scientific documentation

Articles

• Internal reports

Technical documentation

• General considerations
  • How to compile a version of SURFEX previous than 7_2 on Linux Mageia?
  • Recommendations about compilation (V8)
• Rules of coding
  • Compilation and modules of interfaces self-generated
  • Reading of NAMELISTS in one time at the beginning
  • Suppression of the allocatable arrays in the time loop of the model
  • Keys of C-precompilation
  • Modifications of the covers files for ECOCLIMAP
  • The DOCTOR norm (from Meso-NH)
  • A few rules for programming (from Meso-NH)
  • A few recommendations from Rimvydas Jasinskas
• About DR_HOOK
  • Implementation of Dr Hook in the code
  • To use DR_HOOK in Surfex
• About the types from Surfex V8.0
  • How to find the full name of a type

Versions documentation

• Surfex v7.1
  • Modifications between Surfex v7 and Surfex v7.1
  • Reproducibility: tests and results
  • Current bugs
• Surfex v9_0
  • New developments in SURFEX V9
  • Changes in namelists
• Surfex V8_1
  • Novelties in V8_1
    • 1). Optimization and MPI parallelisation of the PGD and PREP steps.
    • 10). A first version of the new coding related to the building of ECOCLIMAP-SG
    • 11). The GRIB-API library is updated to version 1.17.0.
    • 12) The output SNOW fields can be written 2D (number of points / number of snow layers), by M. Lafaysse (CEN).
    • 13) The NETCDF forcing file can be partially read, by M. Lafaysse (CEN).
    • 14) The definition of the OFFLIN output fields to be written is suppressed from files init_outfn_....
    • 15) The OFFLIN output fields are adapted to plot their fields with EPyGrAM.
    • 16) The possibility to give CONDSAT, MPOTSAT, BCOEF, WWILT, WFC and WSAT, by soil layer, in the namelist NAM_DATA_ISBA, is added.
    • 17) A correction for the forcing radiation is introduced, under key (C. Szczypta, P. Le Moigne).
    • 18) Tehcnical news for the assimilation part SODA (C. Albergel, S. Munier).
    • 19) The XRD and DR_HOOK library are merged and updated to version 44.
    • 2). The general OPEN-MP in the OFFLINE driver is removed
    • 3). By default, the output written fields are all 1D-fields (there is no longer the dimension PATCH in output files).
    • 4). The types introduced in version 8_0 are used to simplify the writing of several subroutines of the code.
    • 5). Some obsolete options are suppressed
    • 6). The modifications of P. Marguinaud for the parallelization of the PREP with FULLPOS in AROME
    • 7). The modifications of J. Escobar and M. Moge for the MPI parallelization of the PREP_REAL, PREP_NEST_PGD and SPAWNING
    • 8). The parallel I/O server XIOS implemented in Surfex by S. Senesi
    • 9). The fortran interface for NETCDF4 replaces the previous NETCDF3 interface
  • Practical changes
    • 1). Changes in the namelist OPTIONS.nam
    • 2) Changes in the subroutines doing the interface with the calling atmospheric model
    • 3). Changes in the output fields
    • 4). Changes in the results (reproducibility)
    • 5). An OFFLINE test of performance for XIOS
• Surfex v8_0
  • branch CNRM_CM6_DEV from GMGEC
  • branch MEB_DEV2 from MOANA & SMHI
  • branch NEW_PREP from MOSAYC
  • Changes in Namelists
  • CROCUS from CEN
  • Current bugs
  • Draft of the schedule for the building of SURFEX V8
  • ECUME from MEMO & MICADO
  • Ensemble prediction in AROME from MICADO
  • Main changes in SURFEX v8
  • Modifications from Aladin
  • OI_MAIN + PREP from GMAP
  • Preparation of the SURFEX Version 8
  • Results of tests and analyses
  • rotated grid from P. Samuelsson
  • SODA from HIRLAM
  • Suppression of global variables from CERFACS
  • SURFEX in MESONH V4_10_0 from LA
  • TEB from TURBAU
  • technical modifications from HIRLAM
  • TOPMODEL from MICADO
  • VARASSIM from VEGEO
• Surfex v7_3
  • Main changes in Surfex v7_3
  • NAMELISTS changed in Surfex v7_3
  • Modified files in Surfex v7_3
  • Suppressed files in Surfex v7_3
  • New files in SURFEX v7_3
  • Reproducibility between Surfex v7_3 and Surfex v7_2_1
  • Current bugs
• Surfex v7_2
  • News in v7_2
  • Changes in namelists
  • Reproducibility
  • Current bugs: 7_2_0
  • Current bugs: 7_2_1

User’s guide

• 1. How to install the software
  • 1.1. Basic packages to install on a Linux PC
  • 1.2. Export off-line version of SURFEX
  • 1.3. Precisions about compilation from version 7_2
  • 1.4. How to install and run Surfex in parallel mode on Ubuntu
• 10. Data assimilation
  • 10.1 Interface and usage
    • 10.1.1. Inline (CANARI)
    • 10.1.2. Offline (SODA)
  • 10.2 Sea
    • 10.2.1 Sea properties from data source
    • 10.2.2 Extrapolation of sea temperatures
  • 10.3 Inland water
    • 10.3.1 Use nature temperature over inland water
    • 10.3.2 Extrapolation of inland water temperatures
  • 10.4 Nature
    • 10.4.1 ISBA: snow update
    • 10.4.3 Extrapolation of ISBA properties
    • 10.4.2.1 ISBA: OI soil assimilation
      • 10.4.2.1.1 Namelist NAM_ASSIM
      • 10.4.2.1.2 Namelist NAM_NACVEG
    • 10.4.2.2 ISBA: EKF soil assimilation
      • 10.4.2.2.1 Namelist NAM_ASSIM
      • 10.4.2.2.2 Namelist NAM_NACVEG
      • 10.4.2.2.3 Namelist NAM_IO_VARASSIM
      • 10.4.2.2.4 Namelist NAM_OBS
      • 10.4.2.2.5 Namelist NAM_VAR
    • 10.4.2.3 ISBA: ENKF soil assimilation.
      • 10.4.2.3.1 Namelist NAM_ENS
  • 10.5 Town
    • 10.5.1 TEB: Update T_ROAD3 from T2M_TEB
• 11. Coupling with OASIS-MCT
  • 12.1. Namelist NAM_SFX_LAND_CPL
  • 12.2. Namelist NAM_SFX_LAKE_CPL
  • 12.3. Namelist NAM_SFX_SEA_CPL
• 2. Overview of the externalized surface sequence
  • 2.1. The sequence
  • 2.2. The atmospheric models using the externalized surface
    • 2.2.3. in AROME
    • 2.2.1. In offline mode
      • 2.2.1.1. namelist NAM_IO_OFFLINE
      • 2.2.1.2. namelist NAM_LAND_USE
      • 2.2.1.3. Namelist NAM_ZS_FILTER
      • 2.2.1.4. Namelist NAM_NACVEG
    • 2.2.2. in MESONH
      • 2.2.2.1. Initialization of surface fields integrated in MESONH programs
      • 2.2.2.2. Namelist NAM_PGDFILE
      • 2.2.2.3. MESONH run and diagnostics
• 3. Off-line Guide
  • 3.1. The input files
  • 3.2. Forcing files
    • 3.2.1. Forcing format in ASCII and binary cases
    • 3.2.2. Forcing format in NETCDF case
    • 3.2.3. creation of forcing files
    • 3.2.4. installation of an experiment
    • 3.2.5. Interpolation of forcing data at the model time step
  • 3.3. One example of off-line surfex application
    • 3.3.1. netcdf format file
      • 3.3.1.1. FORCING.nc
      • 3.3.1.2. list of parameters
    • 3.3.2. ascii format files
      • 3.3.2.1. PGD.txt
      • 3.3.2.2. PREP.txt
      • 3.3.2.3. Extracting 2d fields
      • 3.3.2.4. I/O diagram
  • 3.4. Some output of off-line simulation
    • 3.4.1. Examples of prognostic variables output
    • 3.4.2. list of available variables
• 4. The physiographic fields
  • 4.1. Choice of the surface schemes
    • 4.1.1. Namelist NAM_PGD_SCHEMES
    • 4.1.2. Namelist NAM_ISBA
    • 4.1.3. Namelist NAM_DATA_TSZ0
    • 4.1.4. Namelist NAM_DATA_SEAFLUX
    • 4.1.5. Namelist NAM_DATA_FLAKE
    • 4.1.6. Namelist NAM_TEB
    • 4.1.7. Namelist NAM_MEB_ISBA
  • 4.2. Definition of the grid
    • 4.2.1. Choice of the grid type
      • 4.2.1.1. Namelist NAM_PGD_GRID
    • 4.2.2. Conformal projection grids (Mercator, Lambert, Polar stereographic)
      • 4.2.2.1. Namelist NAM_CONF_PROJ
      • 4.2.2.2. Namelist NAM_CONF_PROJ_GRID
      • 4.2.2.3. Namelist NAM_INIFILE_CONF_PROJ
    • 4.2.3. Cartesian grids
      • 4.2.3.1. Namelist NAM_CARTESIAN
      • 4.2.3.2. Namelist NAM_INIFILE_CARTESIAN
    • 4.2.4. Longitude-latitude grids
      • 4.2.4.1. Namelist NAM_LONLAT_REG
      • 4.2.4.2. Namelist NAM_LONLATVAL
      • 4.2.4.3. Namelist NAM_LONLAT_ROT
    • 4.2.5. Regular Lambert grids
      • 4.2.5.1. Namelist NAM_IGN
    • 4.2.6. Gaussian grids
      • 4.2.6.1. Namelist NAMDIM
      • 4.2.6.2. Namelist NAMRGRI
      • 4.2.6.3. Namelist NAMGEM
  • 4.3. Orography, subgrid orography gaussian indices and bathymetry
    • 4.3.1. Namelist NAM_ZS
    • 4.3.3. Namelist NAM_SEABATHY
  • 4.4. Land cover data
    • 4.4.1. Choice of the type of land cover data
      • 4.4.1.1. Namelist NAM_FRAC
    • 4.4.2. ECOCLIMAP is used
      • 4.4.2.1. Namelist NAM_COVER
      • 4.4.2.2. Namelist NAM_PGD_ARRANGE_COVER
      • 4.4.2.3. Namelist NAM_READ_DATA_COVER
      • 4.4.2.4. Namelist NAM_WRITE_COVER_TEX
      • 4.4.2.5. List of ECOCLIMAP covers names
    • 4.4.3. some land cover data fields are defined by user
      • 4.4.3.1. ISBA scheme: NAM_DATA_ISBA
      • 4.4.3.2. TEB scheme: NAM_DATA_TEB & NAM_DATA_TEB_IRRIG
      • 4.4.3.3. BEM scheme: NAM_DATA_BEM
      • 4.4.3.4. TEB_GARDEN scheme: NAM_DATA_TEB_GARDEN
      • 4.4.3.5. TEB_GREENROOF scheme: namelist NAM_DATA_TEB_GREENROOF
  • 4.5. Specificities of ECOCLIMAP II classification
    • 4.5.1. Namelist NAM_ECOCLIMAP2
  • 4.6. Namelist to add user's own fields
    • 4.6.1. Namelist NAM_DUMMY_PGD
  • 4.7. Namelist for chemistry anthropogenic emissions
    • 4.7.1. Namelist NAM_CH_EMISSIONS
    • 4.7.2. Namelist NAM_CH_EMIS_PGD
    • 4.7.3. Namelist NAM_CH_SNAP_EMIS_PGD
• 5. Initialization of the prognostic fields
  • 5.1. Overview of fields computation: PREP
  • 5.2. Date initialization and default input data file for all schemes
    • 5.2.1. Namelist NAM_PREP_SURF_ATM
  • 5.3. Sea scheme "SEAFLX"
    • 5.3.1. Namelist NAM_PREP_SEAFLUX
  • 5.4. Lake scheme "WATFLX"
    • 5.4.1. Namelist NAM_PREP_WATFLUX
  • 5.5. Lake scheme "FLAKE"
    • 5.5.1. Namelist NAM_PREP_FLAKE
  • 5.6. Vegetation scheme "ISBA "
    • 5.6.1. Namelist NAM_PREP_ISBA
    • 5.6.2. Namelist NAM_PREP_ISBA_SNOW
    • 5.6.3. Namelist NAM_PREP_ISBA_CARBON
  • 5.7. Town scheme "TEB "
    • 5.7.1. Namelist NAM_PREP_TEB
    • 5.7.2. Namelist NAM_PREP_TEB_SNOW
    • 5.7.3. Namelist NAM_PREP_TEB_GARDEN
    • 5.7.4. Namelist NAM_PREP_GARDEN_SNOW
    • 5.7.5. Namelist NAM_PREP_TEB_GREENROOF
    • 5.7.6. Namelist NAM_PREP_GREENROOF_SNOW
• 6. How to run the externalized surface physical schemes
  • 6.1. "SURF_ATM" general options available over all tiles
    • 6.1.1. Namelist NAM_SURF_CSTS
    • 6.1.2. Namelist NAM_SURF_ATM
    • 6.1.3. Namelist NAM_WRITE_SURF_ATM
    • 6.1.4. Namelist NAM_SSOn
    • 6.1.5. Namelist NAM_REPROD_OPER
  • 6.2. "SEAFLX" sea scheme options
    • 6.2.1. Namelist NAM_SEAFLUXn
    • 6.2.2. Namelist NAM_SURF_SLT
    • 6.2.3. Sea-ice schemes
    • 6.2.4. Gelato sea-ice scheme
    • 6.2.5. Namelist NAM_SEAICEn
  • 6.3. "WATFLX" inland water scheme options
    • 6.3.1. Namelist NAM_WATFLUXn
  • 6.4. "FLAKE" lake scheme options
    • 6.4.1. Namelist NAM_FLAKEn
    • 6.4.2. Namelist NAM_CH_FLAKEn
  • 6.5. "ISBA " vegetation scheme options
    • 6.5.1. Namelist NAM_SGH_ISBAn
    • 6.5.10. Namelist NAM_ISBA_SNOWn
    • 6.5.11. Namelist NAM_ISBA_AGSn
    • 6.5.2. Namelist NAM_ISBAn
    • 6.5.3. Namelist NAM_SURF_DST
    • 6.5.5. Namelist NAM_AGRI
    • 6.5.6. Namelist NAM_DEEPSOIL
    • 6.5.7. Namelist NAM_TREEDRAG
    • 6.5.8. Namelist NAM_SPINUP_CARBn
    • 6.5.9. Namelist NAM_SURF_SNOW_CSTS
  • 6.6. "TEB" town scheme options
    • 6.6.1. Namelist NAM_TEBn
  • 6.7. "IDEAL" ideal flux scheme options
    • 6.6.1. Namelist NAM_IDEAL_FLUX
  • 6.8. Coupling with TRIP model
    • 6.8.1. NAM_TRIP_GRID
    • 6.8.2. NAM_TRIP
    • 6.8.3. NAM_TRIP_LAND_CPL
    • 6.8.4. NAM_TRIP_SEA_CPL
    • 6.8.5. NAM_TRIP_RUN
    • 6.8.6. NAM_OASIS
    • 6.8.7. NAM_START_DATE
    • 6.8.8. NAM_TRIP_PREP
  • 6.9. Coupling with TOPMODEL
    • 6.9.1. NAM_PGD_TOPD
    • 6.9.2. NAM_TOPD
• 7. How to run the externalized surface chemical schemes
  • 7.1. Chemical settings control
    • 7.1.1. Namelist NAM_CH_CONTROLn
  • 7.2. Chemical anthropogenic emissions
    • 7.2.1. Namelist NAM_CH_SURFn
  • 7.3. Chemical deposition over ocean
    • 7.3.1. Namelist NAM_CH_SEAFLUXn
  • 7.4. Chemical deposition over lakes
    • 7.4.1. Namelist NAM_CH_WATFLUXn
  • 7.5. Chemical deposition over towns
    • 7.5.1. Namelist NAM_CH_TEBn
  • 7.6. Chemical deposition and biogenic emissions over vegetation
    • 7.6.1. Namelist NAM_CH_ISBAn
  • 7.7. Chemical aerosol scheme (ORILAM)
    • 7.7.1. Namelist NAM_CHS_ORILAM
• 8. Externalized surface diagnostics
  • 8.1. Diagnostics relative to the general surface monitor
    • 8.1.1. Namelist NAM_DIAG_SURF_ATMn
  • 8.2. Diagnostics relative to the general surface monitor and to each surface scheme
    • 8.2.1. Namelist NAM_DIAG_SURFn
    • 8.2.2. Namelist NAM_WRITE_DIAG_SURFn
  • 8.3. Diagnostics relative to the ISBA vegetation scheme
    • 8.3.1. Namelist NAM_DIAG_ISBAn
  • 8.4. Diagnostics relative to the TEB town scheme
    • 8.4.1. Namelist NAM_DIAG_TEBn
  • 8.5. Diagnostics relative to the FLAKE scheme
    • 8.5.1. Namelist NAM_DIAG_FLAKEn
  • 8.6. Diagnostics relative to the sea
    • 8.6.1. Namelist NAM_DIAG_OCEANn
    • 8.6.2 Sea-ice diagnostics
• 9. Externalized surface model output fields
  • 9.3. Physiographic fields
    • 9.3.1. Common fields
    • 9.3.2. ISBA / GARDEN / GREENROOF
    • 9.3.3. ISBA
    • 9.3.4. ISBA_PAR
    • 9.3.5. TSZ0_PAR
    • 9.3.6. TEB_PAR
    • 9.3.7. SEAFLUX
    • 9.3.8. SEAF_PAR
    • 9.3.9. FLAKE
  • 9.1. Prognostic model output fields
    • 9.1.1. ISBA / GARDEN / GREENROOF
    • 9.1.2. ISBA
    • 9.1.3. TEB
    • 9.1.4. SNOW
    • 9.1.5. SEAFLUX
    • 9.1.6. WATFLUX
    • 9.1.7. FLAKE
    • 9.1.8. Canopy
  • 9.2. Diagnostic model output fields
    • 9.2.1. All tiles aggregated
    • 9.2.2. For each tile and all tiles aggregated
    • 9.2.3. ISBA & GARDEN
    • 9.2.4. ISBA
    • 9.2.5. TEB
    • 9.2.6. SEAFLUX
    • 9.2.7. WATFLUX
    • 9.2.8. Chemical diagnostics

Physiographic maps

Articles

• Bathymetry
• Lakes
• Land use
• Soil texture
• Topography

Various tools

Articles

• To convert old netcdf forcing files
• To check missing USE MODI_...
• To check useless USE MODI_...
• The DRAW tool

• How to use EPyGrAM to plot the SURFEX OFFLIN outputs?
  • What is EPyGrAM?
  • How to use EPyGrAM?
  • Examples of plots for different grids
• Converting SRTM 90 .tiff to .dir file

The STRATO tests base

Articles

• 1. Introduction
• 2. Principle of use for the base of tests
• 3. Principle of operating, for the base of tests
• 4. Particular case: building of SURFEX OFFLINE version 8
• 5. To install and run the base of test cases
• 6. Output files produced by the base of tests
• 7. One means to analyse results (proposition)
• 8. Detailed numbers of tests cases and execution times
• 9. Ending remarks and prospects

• Contents of the base (summary)
  • 1. Scripts
  • 2. Test cases
  • 3. Forcing files