UTILS Notebooks

Xarray

This part explains the use of xarray accross multifiles reading examples from MARS, MesoNH, NEMO… outputs.

The user is highly invited to use moawi function to read any model data set. It will be more efficient and will keep the genericity of the analysis.

• Dataset from single or multiple NetCDF files
  • mars outputs
    • Concat over time
    • Concat over time and select a subdomain
  • NEMO outputs
  • AROME (previmer format)
  • MesoNH
  • Basic files
• Sortie Previmer avec packing
  • Liste des fichiers
  • Lecture classique
  • Lecture osdyn

Calculation

• Mathematical tools
  • Avalaible functions
  • bounds for a range or colorbar
  • unit of a number
  • precision of a number

Plot

• colorbars
  • Classic quick search
  • The colorbar separators flatten the histogram of the data
    • Get the range
    • Check the repartition of the values
• colormaps
  • Available functions
  • Liste of the colormaps
  • Plot a colorbar
  • crop_by_percent (wrapping of cmocean function)
  • crop
  • lighten a colormap
• Visualize correlation from heatmap

Interpolation

• fortran function linear4dto1dxx
  • note : Use of N.ogrid
    • Basic initializations for the test
    • Interpolation from pure 1D axes for t,z,y and x axes to a unique location
    • Interpolation from a single point in space (x=cst, y=cst), z and t axes are pure 1D axes to a unique location
    • No interpolation in time but x, y and z axes are pure 1D axes
    • Interpolation from 1D x, y and t axes, z is a 5D array to a unique location
    • Interpolation from 2D X/Y - no other axes (pure curvilinear) - to a unique location
    • Interpolation from and to the same coordinates

ConfigManager

• misc.config.ConfigManager
  • Different types of readings
    • read .ini from utils ConfigManager class
    • read .cfg from with class ConfigObj class
    • read the same cfg file from ConfigManager
  • patch method
    • Patch .ini with .cfg
    • Patch 2 .cfg without .ini
  • argparse method
    • Other way to patch .ini with .cfg
    • Update the specfile (.ini) with arguments passed to the script
    • also update with .cfg file
    • Check arg_parse arguments
    • difference arg_parse and patch
    • Update the cfg file (.cfg) with arguments passed to the script
    • Use only arguments passed to the script (nor .ini neither .cfg file)
• osdyn.utils.misc.config list_options
• Create documentation from .cfg .ini file plus arguments

Logging

• Log message
  • Set verbose level
  • Get the current verbose level