wiki:MiniCSEP
Last modified 5 weeks ago

How to use mini-CSEP distribution

This page provides detailed instructions on how to use a so-called mini-CSEP distribution of the CSEP Testing Center software.

External Packages

CSEP V11.7.0 software depends on the following external packages that are part of FC14 distribution as of 2011-07-05:

CSEP Environment Variables

For convenience, we use CSEP environment variable that points to the top level directory with all CSEP related files: configuration files, source code directory, log files, etc. This is not a requirement, and mentioned files can be located anywhere on your file system. 

[csep@csep-op ~]$ cd $HOME
[csep@csep-op ~]$ mkdir miniCSEP
[csep@csep-op ~]$ setenv CSEP $HOME/miniCSEP

Please refer to the CSEP environment variables for the description of all required variables.

If using mini-CSEP distribution on the CSEP development server at SCEC (csep-devel.usc.edu, accessible through motion.usc.edu), it's recommended to copy environment variables of csep user account from /home/csep/.tcshrc into your ~/.tcshrc resource file. Please make sure that CENTERCODE environment variable points to the CSEP distribution you intend to use (/usr/local/csep or $HOME/miniCSEP/csep or some other directory you have placed the CSEP codes to).

Getting the Source Code

  • Please validate downloaded file by comparing it's md5sum value against the one posted in csep.tar.gz.meta file available at the same location. 
    [csep@csep-op ~]$ md5sum /download/location/csepmini-12.4.0.tar.gz >> /download/location/md5.txt
[csep@csep-op ~]$ diff /download/location/md5.txt /download/location/csepmini-12.4.0.tar.gz.meta
  • Please extract files from miniCSEP distribution archive to the $CSEP directory 
    [csep@csep-op ~]$ tar zxvf /download/location/csepmini-12.4.0.tar.gz -C $CSEP

Building the miniCSEP

ATTENTION: Please ignore this section if using /usr/local/csep installation on the CSEP development server at SCEC (csep-devel.usc.edu).

Before invoking the CSEP code, please make sure that you build the binaries, and pass acceptance tests defined for the mini-CSEP distribution.

By default, runtime directories generated by acceptance tests are placed under $CENTERCODE/src/generic/test directory (results-* sub-directory for each test). To change the default location, please update your environment to set up a top-level runtime directory for the tests: 

setenv CSEP_RESULTS_DIR /home/csep/path/to/CSEPTestsRuntimeDirs

Please use Makefile rules to build, install and test the distribution: 

[csep@csep-op csep]$ cd $CENTERCODE
[csep@csep-op csep]$ make
[csep@csep-op csep]$ make install
[csep@csep-op csep]$ make distcheck |& tee testlog.txt

Using the miniCSEP

Default geographical region within CSEP testing framework is set to California. The selection of geographical region controls (with provided examples for California):

Other testing regions, that are part of the distribution, are SWPacific, NWPacific and Global. Geographical region of interest and corresponding catalog filtering settings (aka post-processing) can be specified through following command-line options to the Python's processing module:

Geographical Region Selection
[csep@csep-op csep]$ python ProcessingModule --geographicalRegion=Global 
                                             --postProcessFactory=$CENTERCODE/configuration/testing-regions/Global/cronjobs/PostProcessFactory.init.xml

GeographicalRegions.py Module

GeographicalRegions Python module is used to create:

  • A plot of the spatial distribution of the forecast (i.e., map-view of the forecast)

Forecast.py Module

Forecast Python module is used to create:

  • A plot of the magnitude distribution of the forecast (i.e., magnitude versus normalized probability)

CSEPXMLGeneric.py Module

CSEPXMLGeneric Python module is used for forecasts conversions:

  • ASCII to XML
  • XML to ASCII

EvaluationTest.py Module

EvaluationTest Python module represents any evaluation test that is defined within CSEP testing framework and used to invoke any combination of:

  • Number (N) test
  • Log-likelihood (L) test
  • Ratio log-likelihood (R) test
  • Space (S) test
  • Magnitude (M) test