MJO Wavenumber-Frequency Spectra#

Overview#

This recipe computes Wheeler-Kiladis space-time spectra to evaluate Madden-Julian Oscillation (MJO)-related variability in the tropics.

The diagnostic calculates symmetric and anti-symmetric spectra in the equatorial belt, derives a smoothed background spectrum, and produces ratio spectra (signal/background). In addition, it computes seasonal eastward/westward wavenumber-frequency spectra for boreal winter and summer.

The recipe supports daily precipitation, top-of-atmosphere outgoing longwave radiation (OLR), and zonal wind, with zonal wind at 850 hPa and 200 hPa.

Available recipes and diagnostics#

Recipes are stored in esmvaltool/recipes/

  • recipe_mjo.yml

Diagnostics are stored in esmvaltool/diag_scripts/mjo/

  • mjo_diag.py: recipe entry point that loads each input cube and runs the

    spectra workflows.

  • spectra_compute.py: Wheeler-Kiladis computations, smoothing,

    dispersion-curve overlays, plotting, and NetCDF output writing.

The recipe defines three diagnostics: eqw_spectra_pr for precipitation, eqw_spectra_olr for OLR, and eqw_spectra_winds for zonal wind.

User settings in recipe#

  1. Script mjo_diag.py

    Required settings for script

    • script: ../diag_scripts/mjo/mjo_diag.py

    Optional (currently included in recipe_mjo.yml)

    • reference_datasets: list of dataset names used as references in metadata.

    • regrid_dataset: dataset used as target for regridding.

    • mip_name: project/mip label used in metadata.

    • base_range: baseline period.

    • analysis_range: analysis period.

    Required settings for variables

    • variable_group metadata is used internally to select processing branches.

    • eqw_spectra_pr requires variable pr with daily frequency.

    • eqw_spectra_olr requires variable rlut with daily frequency.

    • eqw_spectra_winds requires variable ua with daily frequency.

    Optional settings for variables

    • Additional datasets/ensembles/experiments can be added in the datasets

      section of the recipe.

    Required settings for preprocessors

    • extract_region must provide a full cyclic longitude range and equatorial

      latitude coverage. The recipe uses:

      • start_longitude: 0.

      • end_longitude: 360.

      • start_latitude: -15.

      • end_latitude: 15.

    • pp_precip converts precipitation to mm day-1.

    • pp_olr extracts the equatorial region from rlut. no unit conversion is applied.

    • pp_levels_winds extracts 85000 Pa and 20000 Pa levels from ua.

    Notes and constraints

    • Input longitude must be periodic/cyclic.

    • Latitude and longitude coordinates must be 1D and monotonically ordered.

    • The algorithm requires at least 365 days and uses a 96-day analysis window.

Variables#

  • pr (atmos, daily mean, longitude latitude time)

  • rlut (atmos, daily mean, longitude latitude time)

  • ua (atmos, daily mean, longitude latitude time pressure)

Derived variable names in output are:

  • Precipitation (from pr)

  • toa_outgoing_longwave_flux (from rlut)

  • x_wind_850hPa and x_wind_200hPa (from ua)

Observations and reformat scripts#

No dedicated observational reformat script is required by this recipe. Any input dataset available through ESMValTool with the required variables, daily frequency, and spatial/temporal coverage can be used.

References#

  • Wheeler, M., and G. N. Kiladis (1999), Convectively Coupled Equatorial

    Waves: Analysis of Clouds and Temperature in the Wavenumber-Frequency Domain, Journal of the Atmospheric Sciences, 56, 374-399.

  • Hayashi, Y. (1971), A Generalized Method of Resolving Disturbances into

    Progressive and Retrogressive Waves by Space and Fourier and Time Cross Spectral Analysis, Journal of the Meteorological Society of Japan, 49, 125-128.

Example plots#

The diagnostic produces several plot families per dataset and variable, including:

  • Raw anti-symmetric spectra

  • Raw symmetric spectra

  • Ratio anti-symmetric spectra (raw/background)

  • Ratio symmetric spectra (raw/background)

  • Seasonal (winter/summer) wavenumber-frequency spectra