UCVM 15.10.0
Contents
Virtual Box with Latest CVMs
- CCA - CCA05 (iteration five mesh with trilinear interpolation)
- CVM-H - CVM-H v15.1 (as described in USR paper. No background Model)
- CVM-S4 - CVM-S4 (best available version of final SCEC rule-based CVM (Kohler et al 2001))
- CVM-S4.26 - CVM-S4.26 (final mesh from CVM-S4.26 inversion and trilinear interpolation between points. No background model)
- CVM-S4.26.M01 - CVM-S4.26.M01 (iteration 26 plus rule-based GTL for top 300m)
UCVM Installation Notes
Checking an UCVM Installation
After installing UCVM, edit your ~/.bash_profile to include the following lines:
DYLD_LIBRARY_PATH=/Users/maechlin/ucvm-15.10.0/lib/euclid3/lib:$DYLD_LIBRARY_PATH DYLD_LIBRARY_PATH=/Users/maechlin/ucvm-15.10.0/lib/proj-4/lib:$DYLD_LIBRARY_PATH export DYLD_LIBRARY_PATH
To try out ucvm, type the following commands into your shell:
cd /Users/maechlin/ucvm-15.10.0/bin ./ucvm_query -f ../conf/ucvm.conf -m [model] < list_of_points.txt (where model is one of the models you installed: cvms, cvmsi, cvmh, or cencal)
Please try this example:
cd /Users/maechlin/ucvm-15.10.0/bin ./ucvm_query -f ../conf/ucvm.conf -m cvms < ../tests/cvms_input.txt
You will then see the following output:
Using Geo Depth coordinates as default mode. -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
A copy of all the commands to setup UCVM has been saved at ./setup_log.sh
You can view man pages for each command by typing man -M ./man [command name].
We strongly encourage you to run the UCVM tests by typing 'make check' without quotation marks.
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 Vs velocity).
- plot_z25_map.py - Plots a horizontal slice of Z2.5 depths (depth to 2500m/s Vs velocity).
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
