How to use EPyGrAM?

1. Installing EPyGrAM

• To install EPyGrAM, you can follow the indications on this page:

https://opensource.cnrm-game-meteo.fr/projects/epygram

If you are outside CNRM, you need to clone the EPyGrAM GIT repository.

If you are in CNRM, either you use the version of EPyGrAM already installed in /home/common directory, either you clone the EPyGrAM GIT repository.

2. Plotting SURFEX OFFLIN output fields

• For specific case of SURFEX, we developed several little python scripts allowing to plot a field:
  • at one given output instant,
  • at one given lat,lon point as a time series,
  • for the whole period as an animation.

• These scripts are available for several SURFEX projections:
  • GAUSSIAN
  • LONLATREG
  • LONLATVAL
  • IGN

• These scripts take five arguments:
  • FILE.OUT.nc : name of the SURFEX OFFLIN output file to read
  • FIELD : name of the field from FILE.OUT.nc to plot
  • TIME : output time step to plot
  • LON : longitude of the point to extract (for time series plot)
  • LAT : latitude of the point to extract (for time series plot)

• So the syntax is, for example:

python make_anim_gauss.py FILE.OUT.nc FIELD TIME LON LAT

• To go further with plots:
  • upper scripts are commented, indicating what does each instruction.
  • many arguments are available for EPyGrAM subroutines, notably you can look at the documentation of plotfield:
    http://www.umr-cnrm.fr/gmapdoc/meshtml/EPYGRAM1.2.15/library/H2DField.html?highlight=plotfield#epygram.fields.H2DField.H2DField.plotfield to improve your plots.

3. More help on EPyGrAM

• if you want to do specific plots with EPyGrAM that are not possible with upper scripts:
  • first, refer to the EPyGrAM documentation: http://www.umr-cnrm.fr/gmapdoc/meshtml/EPYGRAM1.2.15/index.html
  • then, contact surfex-support@meteo.fr. We will try to help you, and if we can’t, contact the EPyGrAM support.