COPRA – Constructing Proxy Records From Age Models

Version 1.16, last mod. 29-Jun-2022 23:24:01

(MATLAB^® and Octave Toolbox)

General Notes

COPRA is a depth-age modeling program that creates chronologies with uncertainties and can transform age-uncertainties to proxy-uncertainties.

Usage

In MATLAB (or Octave) use one of the following (type it in the console window):

• commandline tool: copra
  
• GUI based tool: copraGUI
  

Detailed information

Unfortunately, we have missed the opportunity to write down the user manual timely.

Example scripts

Import COPRA output and export ensemble data (time and proxy)

Download and Installation

1. Download the file: install.m (for older MATLAB than R2014 install.m)
2. Execute the install.m file from the console in MATLAB or Octave. This script will automatically install the toolbox in the user's toolbox folder (usually a folder called matlab in the users home directory) and register it for regular use.
3. To uninstall COPRA simply call copraclean at the Matlab commandline.
4. Requirements:

   • To use the graphical user interface of COPRA in MATLAB you must install the GUI Layout Toolbox. This toolbox is only necessary if the GUI in Matlab is used (the GUI is not working in Octave). The commandline functionality will work without this GUI toolbox. For your convinience we provide an installation script for the GUI Layout Toolbox that you can use instead of the Matlab Central Fileexchange version: layoutInstall.m (for older MATLAB than R2014 layoutInstall.m). Simply call the script layoutInstall from the commandline. It will automatically install the toolbox in the user's toolbox folder.

     As starting with release R2014b, MATLAB is using a new graphics engine and the GUI Layout Toolbox has serious compatibility issues. Therefore, COPRA might face serious errors with the GUI. You can thank Mathwork and the developer of the GUI Layout Toolbox for this unneccessary incompatibility.

   • For Octave, please install the packages io and statistics (from the Octave console, required only once):
     

     pkg install -forge io statistics

     and load it into the Octave workspace:

     pkg load statistics

     If copra is not found at the commandline in Octave, you can add it manually to the search path by (actually should not be necessary when regularly installed using the install.m file):

     addpath('/FOLDER/OF/COPRA/INSTALLATION')

References

• Breitenbach, S. F. M., Rehfeld, K., Goswami, B., Baldini, J. U. L., Ridley, H. E., Kennett, D., Prufer, K., Aquino, V. V., Asmerom, Y., Polyak, V. J., Cheng, H., Kurths, J., Marwan, N.: COnstructing Proxy Records from Age models (COPRA), Climate of the Past, 8, 2012, 1765-1779
  doi:10.5194/cp-8-1765-2012.

Authors

Kira Rehfeld, Bedartha Goswami, Daniel Juncu, Norbert Marwan, Sebastian Breitenbach