Skip to content
Matlab client for Simons CMAP
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.



matcmap is the MATLAB client for Simons CMAP project. It provides access to the Simons CMAP database where various ocean data sets are hosted. These data sets include multi decades of remote sensing observations (satellite), numerical model estimates, and field expeditions.

This package is adopted from pycmap which is the python client of Simons CMAP ecosystem.


Clone or download the repository. The source code is in the src directory. The CMAP.m file abstracts the Simons CMAP API and provides the user with several methods to query the database and extract subsets of data. In order to make API requests, you need to get an API key from Simons CMAP website. Once you got your API key run the following command (in the MATLAB Command Window) to store the API key on your local machine:

CMAP.set_api_key('your api key');


In the MATLAB Command Window run the following command to see the docs:

doc CMAP


  1. Get the list of data sets:
  1. Retrieve a subset of sea surface temperature measured by satellite. A simple plot is made to visualize the retrieved data.
 tbl = CMAP.space_time(...
                       'tblsst_AVHRR_OI_NRT',... % table
                       'sst',... % variable  
                       '2016-04-30',... % dt1  
                       '2016-04-30',... % dt2
                       10,... % lat1
                       70,... % lat2
                       -180,... % lon1
                       -80,... % lon2
                       0,... % depth1
                       0);   % depth2
 lat = unique(;
 lon = unique(tbl.lon);
 sst = reshape(tbl.sst, length(lon), length(lat));
 imagesc(lon, lat, sst');
 axis xy;
 title('Sea Surface Temperature');
You can’t perform that action at this time.