View source for CVM Toolkit

SCEC CVM-Toolkit (CVM-T) – High Performance Meshing Tools for SCEC Community Velocity Models

The SCEC Community Velocity Model Toolkit (CVM-T) enables earthquake modelers to quickly build, visualize, and validate large-scale meshes using SCEC CVM-H or CVM-4. CVM-T is comprised of three main components:

#An updated community velocity model for Southern California based on SCEC CVM-H 
#Tools for extracting 3D regular meshes from this model and visualizing them 
#An automated test framework for evaluating new releases of CVMs using SCEC’s AWP-ODC forward wave propagation software and one, or more, ground motion goodness of fit (GoF) algorithms.


== Summary ==

The SCEC Community Velocity Model Toolkit (CVM-T) enables earthquake modelers to quickly build, visualize, and validate large-scale meshes using SCEC CVM-H or CVM-4. CVM-T is comprised of three main components: (1) an updated community velocity model for Southern California, (2) tools for extracting meshes from this model and visualizing them, and (3) an automated test framework for evaluating new releases of CVM’s using SCEC’s AWP-ODC forward wave propagation software and one, or more, ground motion goodness of fit (GoF) algorithms.

CVM-T is designed to help SCEC modelers build large-scale velocity meshes by extracting material properties from an extended version of Harvard University's Community Velocity Model (CVM-H). The CVM-T software provides a highly-scalable interface to CVM-H 6.2 (and later) voxets. Along with an improved interface to CVM-H material properties, the CVM-T software adds a geotechnical layer (GTL) to CVM-H 6.2+ based on Ely’s Vs30-derived GTL. The initial release of CVM-T also extends the coverage region for CVM-H 6.2 with a Hadley-Kanamori 1D background. Smoothing is performed within the transition boundary between the core model and the 1D background. The user interface now includes a C API that allows applications to query the model either by elevation or depth.

The Extraction and Visualization Tools (EVT) include a parallelized 3D mesh generator which can quickly generate meshes (consisting of Vp, Vs, and density) from either CVM-H or CVM-4 with over 100 billion points. Python plotting scripts can be employed to plot horizontal or profile slices from existing meshes or directly from either CVM.

The Automated Test Framework (ATF) is a system for quantitatively evaluating new versions of CVM-H and ensuring that the model improves against prior versions. The ATF employs the CruiseControl build and test framework to run an AWP-ODC simulation for the 2008 Chino Hills event (Mw = 5.39) and perform a goodness of fit statistics calculation on the generated synthetic and recorded observed seismograms using the GoF algorithm, based on comparison of synthetic peak amplitudes to observed peak amplitudes, used in the SCEC Broadband platform. CVM-T produced plots include comparisons of synthetic and observed seismograms, plots of bias versus period, and spatial plots of the pseudo-AA bias over the entire region. 


== Evaluations and Results ==

*ATF Goodness of Fit Results
**[http://earth.usc.edu/~patrices/cvm-t/ Most Recent CVM-T Comparison of CVM-4, CVM-H 62, and CVM-H 10.11.0 RC]


{| class="wikitable" | border="0"
|-
|-
| [[Image:ch_cvm4_gof.png|256px|thumb|right|Fig 1: Chino Hills 1Hz GOF with CVM-4.]]
| [[Image:ch_cvmh62_gof.png|256px|thumb|right|Fig 2: Chino Hills 1Hz GOF with CVM-6.2]]
| [[Image:ch_cvmh62gtl_gof.png|256px|thumb|right|Fig 3: Chino Hills 1Hz GOF with CVM6.2+GTL]]
|}


*Visualizations
**[http://earth.usc.edu/~patrices/viz-m8/viz-m8-cvmt.html M8 1Hz Mesh Visualizations (GTL on 1D background)]
**[http://earth.usc.edu/~patrices/viz-m8/viz-m8-cvmt-old.html M8 1Hz Mesh Visualizations (No GTL on 1D background)]


== Documentation ==

*[[CVM-T User Guide]]
*[[CVM-T Release Process]]


== Posters, Publications, and Presentations ==

*[http://earth.usc.edu/~patrices/scec_am_2010.html 2010 SCEC Annual Meeting CVM-T poster ]
*[http://earth.usc.edu/~patrices/scec_cvmt_walkthrough.ppt CVM-T Walkthrough powerpoint ]


==Issue Tracking==

* CVM-H https://intensity.usc.edu/trac/cvmh/
* cvm2mesh
* viz-cvm
* cvmtest


== Software Architecture ==

* Dependency Diagram

{| class="wikitable" | border="0"
|-
|-
| [[Image:CVM-T-Dependency-Diagram.png|256px|thumb|left|Fig 4: CVM-T Dependency Diagram]]
|}


* Architecture Diagrams

{| class="wikitable" | border="0"
|-
|-
| [[Image:CVM-T-CVM-H-Architecture-Diagram.png|256px|thumb|left|Fig 5: CVM-T CVM-H Architecture]]
| [[Image:CVM-T-cvm2mesh-Architecture-Diagram.png|256px|thumb|left|Fig 6: CVM-T cvm2mesh Architecture]]
|}



== Code Repositories ==

* CVM-H https://source.usc.edu/svn/cvmh/
* cvm2mesh https://source.usc.edu/svn/cvm2mesh/
* viz-cvm https://source.usc.edu/svn/viz-cvm/
* cvmtest https://source.usc.edu/svn/cvmtest/


== Contributors ==

*[http://earth.usc.edu/~patrices/ P. Small]
*P. Maechling
*[http://earth.usc.edu/~gely/ G. Ely]
*K. Olsen
*K. Withers
*R. Graves
*[http://earth.usc.edu/~tjordan/ T. Jordan]
*A. Plesch
*J. Shaw


== References ==

*'''Suess, M. P., and J. H. Shaw, 2003:''' P-wave seismic velocity structure derived from sonic logs and industry reflection data in the Los Angeles basin, California, Journal of Geophysical Research, 108/B3.
*'''Plesch, A., C. Tape, J. H. Shaw, and members of the USR working group, 2009, CVM-H 6.0:''' Inversion integration, the San Joaquin Valley and other advances in the community velocity model, in 2009 Southern California Earthquake Center Annual Meeting, Proceedings and Abstracts, vol. 19, pp. 260–261. 
*'''Tape, C., Q. Liu, A. Maggi, and J. Tromp, 2009:''' Adjoint tomography of the southern California crust, Science, v. 325, p. 988-992.
*'''Magistrale, H., S. Day, R. W. Clayton, and R. Graves, 2000:''' The SCEC southern California reference 3D seismic velocity model Version 2, Bull. Seismol. Soc. Am., v. 90, no. 6B, p. S65-S76
*''' Ely, G., 2010:''' [http://earth.usc.edu/~gely/cvmh/ Vs30 Derived GTL]