Southern Hemisphere Carbon Monoxide Modeling

Version 2.8 (72.3 KB) by Pete Simonson
Tools to relate climate index data to carbon monoxide data in a linear model framework. Optimal temporal offsets found by grid search.
Updated 24 Jul 2018

View License

Tools to accompany paper:
Links between carbon monoxide and climate indices for the Southern Hemisphere and tropical fire regions
Journal of Geophysical Research: Atmospheres, 2018.
R. R. Buchholz, D. Hammerling, H. M. Worden, M. N. Deeter, L. K. Emmons, D. P. Edwards, S. A. Monks

This set of MATLAB tools allows users to replicate the results of the paper listed above, as well as apply and (hopefully) innovate on the methods employed to solve similar problems.
In brief, this kit contains import, storage, consolidation, and analysis tools to relate climate index time series (for an arbitrary number of indices) to a response variable time series (in the above paper, the response variable is a regional carbon monoxide measurement) in a linear model framework; possible time dependence is handled through a lag factor applied to each index, optimal lag factors are found via grid search.
All of the usual linear model assumptions apply, so users are cautioned to detrend and deseasonalize their data before using these tools.

Getting Started:
The script demonstration_script_full_data.m is a demonstration of the basic tools in the codebase, and is probably the best place for a new user to begin.
The script example_user_config_script.m is provided as a documented user specifications script; the function initialize_user_config_script_gui generates a similar user config script that is NOT documented, but does contain all of the user specifications required to run the full data process. The demonstration script as it exists can be altered to use the example_user_config_script by commenting out the gui call on line 23 and the gui output script execution on line 34, and de-commenting the example script execution on line 33.

Example Data:
This distribution comes with several sets of response data (Carbon Monoxide values derived from MOPITT output over several distinct geographic regions), found in the Carbon_Monoxide_Data subfolder.
This distribution also comes with four sets of climate mode index data (El Nino Southern Oscillation, Indian Ocean Dipole, Tropical South Atlantic, and Antarctic Oscillation), found in the Climate_Mode_Index_Data subfolder.
Other data may be used instead of or in addition to the example data provided, as long as the data files are formatted as below:

Response data files must be csv files, with a header row, and at least two columns.
The first column must be a time index in YYYYMM format.
The index of the column that will be imported as response observations is specified by the user in the ResponseData.fileDataColumnIndex field (the user config gui allows the user to select from the column headers detected).

Climate index data files must be csv files, with a header row, and two columns.
The first column must be a time index in YYYYMMDD format.
The second column must be the value of the climate mode index to be used as an input.

A Note on Model Selection vs. Lag Space Search:
In general terms, this codebase executes search at two levels; the lag space search attempts to identify the lags for each climate mode index that are most informative, while the model selection search attempts to build the best linear model from the indices at a particular set of lags.
At the model selection level, models are assessed using a user-specified criterion (in the user specification gui function, the default is the Bayes Information Criterion).
At the lag space level, lagsets are compared using a model evaluation metric, presently hardcoded as the terminal model's R^2_adjusted value; different lag sets generate different regression tables, and thus, other criteria (e.g. BIC) may not generate apples-to-apples comparisons.

Cite As

Pete Simonson (2024). Southern Hemisphere Carbon Monoxide Modeling (, MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2018a
Compatible with R2017a to R2018a
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes