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#
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