UCVM 15.10.0
Contents
Virtual Box with Latest CVMs
- CVM-H v15.1 (as described in USR paper) CVM-H
- CVM-S4 (best available version of kohler et al 2001) CVM-S
- CVM-S4.26 (iteration plus gtl for top 300m) CVM-S
- CVM-S5 (final mesh from CVM-S4.26 inversion) CVM-S5
- CCA05 (iteration five mesh with trilinear interpolation) CCA
Basic UCVM Usage
UCVM includes many utilities for querying velocity models for various research purposes. The following example describes a common use of UCVM. This instructions assume UCVM installed to /home/scec/ucvm-15.10.0, as in the virtual box image.
Querying Material Properties
In order to get material properties from any model, you simply need to run the cvm_query utility for model CVM-S4 (cvms)
cd /home/scec/ucvm-15.10.0/bin ./ucvm_query -f ../conf/ucvm.conf -m cvms
UCVM prints "Using Geo Depth coordinates as default mode"
The user input queries at in decimal degrees and depth in meters. (e.g. -118.0 34.0 at 0m depth)
-118.0 34.0 0
Carriage return, then control D and UCVM will then return:
-118.0000 34.0000 0.000 280.896 390.000 cvms 696.491 213.000 1974.976 none 0.000 0.000 0.000 crust 696.491 213.000 1974.976
This means that according to the CVM-S4 model, at -118,34, 0 meters depth, the Vp is 696.491, Vs is 213.00, and Rho (density) is 1974.976. You can query any point with any model (cvms, cvmsi, cvmh, cencal) to see what the material properties are at that latitude, longitude, and depth.
The above query is "by depth" meaning that we are querying from the surface level down. To query by elevation, add the flag "-c ge". Therefore, to query the Central California velocity model, we would do:
./ucvm_query -f ../conf/ucvm.conf -m cca -c ge
The full model list is below.
CVM-H - cvmh CVM-S4 - cvms CVM-S4.26 - cvmsi CVM-S5 - cvms5 CCA - cca USGS Bay Area - cencal 1D Hadley Kanamori - 1d Broadband Whittier Narrows 1d - bbp1d
Plotting Utilities
There are five different plotting utilities that are included within the VirtualBox UCVM distribution. The plotting utilities are all located in /home/scec/ucvm-15.10.0/utilities.
- plot_cross_section.py - Plots a cross section of a model.
- plot_horizontal_slice.py - Plots a horizontal slice of a model.
- plot_vs30_map.py - Plots a horizontal slice of Vs30 data.
- plot_z10_map.py - Plots a horizontal slice of Z1.0 depths (depth to 1000m/s).
- plot_z25_map.py - Plots a horizontal slice of Z2.5 depths (depth to 2500m/s).
Each plotting script is interactive, meaning that it will ask you all the questions required to generate the plot.
The VirtualBox also includes the prototype Python API for interacting with UCVM. This API is called PyCVM. The API (files) are defined in:
/home/scec/ucvm-15.10.0/utilities/pycvm/pycvm
Source Code Distribution
Install Script for Linux
Virtual Box Distribution
- Virtual Box Image with UCVM and California CVM Models (40Gb Image)
- Boots in Virtual Box as Ubuntu 15.10 system
- Username: scec
- password: cme
Installed Software:
- GNU Compilers
- California CVMs
- UCVM Software
