LocalizeSL: Sea-level localization code for Kopp et al. (2014) projections framework
Switch branches/tags
Nothing to show
Clone or download
Bob Kopp
Latest commit b43463b Nov 14, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
IFILES Rasmussen et al 2018 Apr 2, 2018
MFILES Add y limit parameter Nov 14, 2018
notebooks Rasmussen et al 2018 scripts Nov 14, 2018
.gitattributes gitattributes Dec 1, 2016
LICENSE.txt Initial commit. Feb 18, 2015
README.md Kopp2017 cite Dec 13, 2017

README.md

LocalizeSL: Offline sea-level localization code

README file last updated by Robert Kopp, robert-dot-kopp-at-rutgers-dot-edu, Wed Dec 13 2017

Citation

This code was originally developed to accompany the results of

R. E. Kopp, R. M. Horton, C. M. Little, J. X. Mitrovica, M. Oppenheimer,
D. J. Rasmussen, B. H. Strauss, and C. Tebaldi (2014). Probabilistic 21st
and 22nd century sea-level projections at a global network of tide	gauge
sites. Earth's Future 2: 287–306, doi:10.1002/2014EF000239. 

Please cite that paper when using any sea-level rise projections generated with this code.

Additional features have subsequently been added to this paper. Features related to sea-level rise allowances were developed for

M. K. Buchanan, R. E. Kopp, M. Oppenheimer, and C. Tebaldi (2016).
Allowances for evolving coastal flood risk under uncertain local sea-level
rise. Climatic Change 137, 347-362. doi:10.1007/s10584-016-1664-7.

Features related to developing discrete sea-level rise scenarios conditional on ranges of global mean sea level were developed for

W.V. Sweet, R. E. Kopp, C. P. Weaver, J. Obeysekera, R. Horton, E. R. Thieler,
and C. Zervas (2017). Global and Regional Sea Level Rise Scenarios for the
United States. Technical Report NOS CO-OPS 083. National Oceanic and
Atmospheric Administration.

Features related to the substitution of output from a physical Antarctic ice-sheet model into the projections framework were developed for

R. E. Kopp, R. M. DeConto, D. A. Bader, R. M. Horton, C. C. Hay, S. Kulp,
M. Oppenheimer, D. Pollard, and B. H. Strauss (2017). Implications of
Antarctic ice-cliff collapse and ice-shelf hydrofracturing mechanisms for
sea-level projections. Earth’s Future. doi: 10.1002/2017EF000663. 

Please cite the appropriate papers if making use of these features.

Overview

This code requires MATLAB with the Statistics Toolbox.

This MATLAB code is intended to help end-users who wish to work with the sea-level rise projections of Kopp et al. (2014) in greater detail than provided by the supplementary tables accompanying that table but without re-running the full global analysis using the supplementary code accompanying the paper. Key functionality these routines provide include:

  1. Local sea-level rise projections at decadal time points and arbitrary quantiles
  2. Localized Monte Carlo samples, disaggregatable by contributory process
  3. Localized variance decomposition plots

The IFILES directory contains the ~200 MB file SLRProjections140523core.mat, which stores 10,000 Monte Carlo samples for each of the processes contributing to global sea-level change, along with metadata. The code loads these samples without regenerating them and then localizes them. (Note that this files is stored in the Github archive using Git Large File Storage; if you do not have git-lfs set up, cloning the archive will only get you a pointer to this file, which you can download using the Github web interface.)

Functions are stored in the MFILES directory. Example scripts are stored in subdirectories of MFILES, labeled scripts*.

The most important function is LocalizeStoredProjections:

[sampslocrise,sampsloccomponents,siteids,sitenames,targyears,scens,cols] =
LocalizeStoredProjections(focussites,storefile)

LocalizeStoredProjections takes as input two parameters. STOREFILE is the path of the SLRProjections140523core.mat file. FOCUSSITES is the PSMSL ID or IDs of the site(s) of interest. (Please see psmsl.org or the supplementary tables to Kopp et al. (2014) to identify the IDs corresponding to your site of interest. Specify 0 if you want GSL samples returned in the same format.)

LocalizeStoredProjections outputs two M x N cell arrays of localized Monte Carlo samples, SAMPSLOCRISE and SAMPSLOCCOMPONENTS. In each cell array, the m rows correspond to the sites specified in FOCUSSITES and the N columns to different RCPs (specifically, RCP 8.5, RCP 6.0, RCP 4.5, and RCP 2.6).

The individual cells of SAMPSLOCRISE are P x Q arrays, with the P rows being 10,000 Monte Carlo samples and the Q columns corresponding to decadal time points. The individual cells of SAMPSLOCRISE are P x Q arrays, with the P rows being 10,000 Monte Carlo samples and the Q columns corresponding to decadal time points. The individual cells of SAMPSLOCCOMPONENTS are P x R x Q arrays. The 1st and 3rd dimensions correspond to the rows and columns of SAMPSLOCRISE; the R columns represent 24 different factors contributing to sea-level rise. Specifically, these factors are:

1 - GIC: Alaska
2 - GIC: Western Canada/US
3 - GIC: Arctic Canada North
4 - GIC: Arctic Canada South
5 - GIC: Greenland peripheral glaciers
6 - GIC: Iceland
7 - GIC: Svalbard
8 - GIC: Scandinavia
9 - GIC: Russian Arctic
10 - GIC: North Asia
11 - GIC: Central Europe
12 - GIC: Caucasus
13 - GIC: Central Asia
14 - GIC: South Asia West
15 - GIC: South Asia East
16 - GIC: Low Latitude
17 - GIC: Southern Andes
18 - GIC: New Zealand
19 - Greenland Ice Sheet
20 - West Antarctic Ice Sheet
21 - East Antarctic Ice Sheet
22 - Land water storage
23 - Oceanographic processes (thermal expansion and ocean dynamics)
24 - GIA, tectonics, and other background processes

The other outputs of LocalizeStoredProjections are identifying information that can be passed out to the output commands. SITEIDS returns the PSMSL site IDs of selected sites; SITENAMES the names of those sites; TARGYEARS the years of the output; SCENS the RCPs; and COLS are column labels.

Several other provided functions produce output, with detailed parameter specification described in the headers.

PlotSLRProjection generates a time series plot analogous to Figure 3 of Kopp et al. (2014).

PlotSLRProjectionVariance generates a variance decomposition plot analogous to Figure 4 of Kopp et al. (2014). WriteTableMC outputs Monte Carlo samples. WriteTableSLRProjection outputs desired quantiles of the projections.

An example script that produces localized sea-level rise projections for New York City is provided in scripts_Kopp2014/runLocalizeSL.m.


Copyright (C) 2017 by Robert E. Kopp

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.