Statistical Seismology Library

The Statistical Seismology Library (SSLib) is a collection of earthquake hypocentral catalogues and R functions to analyse the catalogues. The analyses include graphical data displays, fitting of point process models, estimation of fractal dimensions, and routines to apply the M8 Algorithm to given datasets. The Statistical Seismology Library is written in the R Language, and consists of a number of R packages. Each package has its own Reference Manual that contains documentation for all functions within that package.

The software has been developed in the UNIX and Linux operating systems though versions compatible with the Microsoft Windows operating system are also available. Recent changes made to each package are listed in the manual for each package under the topic “changes”.

Package Index

Packages with a name prefixed by “ss” are specific to statistical seismology. Other packages have wider statistical applications.

  1. Software Packages

    sslib, ssBase, ssEDA, ssM8, Fractal, HiddenMarkov, PtProcess

  2. Earthquake Catalogue Packages

    ssItaly, ssItalyHist, ssNZ, ssPDE, ssSCEC

Users Guide

The Users Guide for the Statistical Seismology Library (guide.pdf, 623 Kb, 20 Nov 2007) contains a sequence of examples, showing how the functions can be implemented and how they are related to each other. The guide is divided into three parts. The first part gives an introduction to the R language, emphasising those features that are important for an understanding of SSLib. In the second part, examples are given for each package in SSLib, showing how the functions are related to each other. The third part is more technical and relates to system administration: installation of software, software modification, and inclusion of local earthquake catalogues.

Note that the PtProcess package (versions ≥ 3.0) has had a major revision. The example code in the Users Guide has not yet been revised and will not work with version 3.0 and greater. Please read the PtProcess reference manual and follow the examples within that manual.

Software Packages

Installation instructions for packages can be found in the Users Guide (§11.2). Package source code can be difficult to install on a MS Windows system, so some windows binaries are also available.

  1. Load SSLib Packages

    Name sslib
    Title Load SSLib Packages
    Description Provides a mechanism to attach the packages listed under Dependencies for use in a particular R session.
    Version 1.2-10
    Date 31 May 2009
    Dependencies ssBase, ssEDA, ssM8, Fractal, PtProcess
    Suggests ssNZ
    (attached if installed onto the system)
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual sslib.pdf (85 Kb)
    Source Code sslib_1.2-10.tar.gz (2.8 Kb)
    Windows Binary Pre-compiled zip file

  2. Base Functions for SSLib

    Name ssBase
    Title Base Functions for SSLib
    Version 2.2-2
    Date 31 May 2009
    Dependencies chron (≥ 2.3-8)
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual base.pdf (276 Kb)
    Source Code ssBase_2.2-2.tar.gz (35 Kb)
    Windows Binary Pre-compiled zip file

  3. Exploratory Data Analysis for Earthquake Data

    Name ssEDA
    Title Exploratory Data Analysis for Earthquake Data
    Version 2.2-4
    Date 13 Nov 2009
    Dependencies ssBase, maps (≥ 2.0-32)
    Suggests ssNZ, ssPDE, ssSCEC, mapdata, rggobi
    (see Notes below)
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual eda.pdf (267 Kb)
    Source Code ssEDA_2.2-4.tar.gz (65 Kb)
    Windows Binary Pre-compiled zip file

    Notes

    1. The package rggobi is required to run the function threeD. The rggobi package (available from CRAN) requires the ggobi system software (available from GGobi); see topic threeD for further installation notes. The rest of the ssEDA package will run normally without the rggobi package installed.
    2. The packages ssNZ, ssPDE and ssSCEC are required to run a number of the examples on the manual pages. However, the ssEDA package will run normally (except for these examples) without these catalogues installed.
    3. The “maps” package contains the geographical mapping software, but only low resolution versions of maps. High resolution map data are contained in the complementary “mapdata” package. Both are available from CRAN.

  4. M8 Earthquake Forecasting Algorithm

    Name ssM8
    Title M8 Earthquake Forecasting Algorithm
    Version 2.1-6
    Date 17 Nov 2009
    Dependencies ssBase
    Suggests ssNZ
    (see Notes below)
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual m8.pdf (187 Kb)
    Source Code ssM8_2.1-6.tar.gz (20 Kb)
    Windows Binary Pre-compiled zip file

    Notes

    The package ssNZ is required to run a number of the examples. However, the ssM8 package will run normally (except for these examples) without ssNZ installed.

  5. Fractal Analyses

    Name Fractal
    Title Fractal Analyses
    Version 1.3-8
    Date 31 May 2009
    Dependencies -
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual fractal.pdf (181 Kb)
    Source Code Fractal_1.3-8.tar.gz (13 Kb)
    Windows Binary Pre-compiled zip file

  6. Hidden Markov Models

    Name HiddenMarkov
    Title Hidden Markov Models
    Version 1.2-8
    Date 10 Oct 2009
    Dependencies -
    Tested With
    (R CMD check)
    Results on CRAN
    Reference Manual HiddenMarkov.pdf
    Supplementary Notes notes.pdf (166 Kb)
    Source Code Available from CRAN
    Windows/Mac Binary Available from CRAN

    WARNING: Version 1.1 and higher contain a number of changes to the package. You should read the topics "Changes" and "Overview" in the reference manual before replacing earlier versions. Version 1.2 uses Fortran in some of the more numerically intensive routines, giving a considerable increase in speed.

  7. Time Dependent Point Process Modelling

    Name PtProcess
    Title Time Dependent Point Process Modelling
    Version 3.2-1
    Date 11 Oct 2009
    Dependencies -
    Tested With
    (R CMD check)
    Results on CRAN
    Reference Manual PtProcess.pdf
    Source Code Available from CRAN
    Windows/Mac Binary Available from CRAN

    WARNING: Version 3 of the package has some major changes from Version 2, and code for Version 2 will not work in Version 3 without modification. You should read the topics "Changes" and "PtProcess" in the reference manual before replacing earlier versions.

Earthquake Catalogue Packages

The following packages each contain a catalogue of earthquake events. Each record represents one event, and contains the spatial location (hypocentre), event time, and event magnitude. The data contained in these SSLib versions of the catalogues are compiled by the seismological observatory given under “Data Source”. Detailed information about the source datasets can be found on the provider's web site listed under “Data Source”. No changes are made to the data contained in these packages. However, some of the datasets available from the seismological observatories contain more variables that have not been included in these SSLib packages.

While the data in these SSLib packages are regularly updated, the providers always retain the right to change their data without notice, and are at all times the only definitive source of the data.

Installation instructions for packages can be found in the Users Guide (§11.2). Package source code can be difficult to install on a MS Windows system, so some windows binaries are also available.

  1. Italy Earthquake Catalogue

    Name ssItaly
    Title Italy Catalogue of Earthquake Events (Catalogo Della Sismicita Strumentale)
    Data Source Istituto Nazionale di Geofisica e Vulcanologia
    Data Range 1983 – 2006
    Version 1.0-12
    Date 31 May 2009
    Dependencies ssBase, utils
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual italy.pdf (108 Kb)
    Source Code ssItaly_1.0-12.tar.gz (803 Kb)
    Windows Binary Pre-compiled zip file

  2. Italy Historical Earthquake Catalogue

    Catalogo Parametrico Dei Terremoti Italiani (CPTI04)

    Name ssItalyHist
    Title Italy Historical Catalogue of Earthquake Events
    Data Source Gruppo di Lavoro CPTI
    Data Range 217BC – 2002AD (CPTI04)
    Version 1.0-7
    Date 31 May 2009
    Dependencies ssBase, utils
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual italyhist.pdf (101 Kb)
    Source Code ssItalyHist_1.0-7.tar.gz (160 Kb)
    Windows Binary Pre-compiled zip file

  3. NZ Earthquake Catalogue

    Name ssNZ
    Title Catalogue of NZ Earthquake Events
    Data Source Institute of Geological and Nuclear Sciences
    Data Range 1460 – 23 Aug 2009*
    (* data are provisional, or incomplete, after 31 Mar 2009)
    Version 2.2-5
    Date 24 Aug 2009
    Dependencies ssBase, utils
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual nz.pdf (124 Kb)
    Source Code ssNZ_2.2-5.tar.gz (7.0 Mb)
    Windows Binary Pre-compiled zip file

  4. PDE Earthquake Catalogue

    Name ssPDE
    Title PDE Catalogue of Earthquake Events
    Data Source US Geological Survey
    Data Range 1 Jan 1964 – 31 Dec 2008
    Version 2.0-41
    Date 13 Sep 2009
    Dependencies ssBase, utils
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual pde.pdf (126 Kb)
    Source Code ssPDE_2.0-41.tar.gz (8.7 Mb)

  5. Southern California Earthquake Center (SCEC) Catalogue

    Name ssSCEC
    Title SCEC Catalogue of Earthquake Events
    Data Source Southern California Earthquake Center (SCEC)
    Data Range 1 Jan 1932 – 23 Aug 2009
    Version 1.0-15
    Date 24 Aug 2009
    Dependencies ssBase, utils
    Tested With
    (R CMD check)
    R version 2.10.0 for Linux
    Reference Manual scec.pdf (109 Kb)
    Source Code ssSCEC_1.0-15.tar.gz (6.7 Mb)

Contacts

Visits since May 2005: