UCVM 15.10.0

From SCECpedia
Revision as of 06:01, 25 March 2016 by Maechlin (talk | contribs)
Jump to navigationJump to search

Virtual Box with Latest CVMs

  • CCA - CCA05 (iteration five mesh with trilinear interpolation)
  • CVM-H - CVM-H v15.1 (as described in USR paper)
  • CVM-S4.26 - CVM-S4.26 (final mesh from CVM-S4.26 inversion)
  • CVM-S4.26.GTL - CVM-S4.26.GTL (iteration plus gtl for top 300m)
  • CVM-S4 - CVM-S4 (best available version of kohler et al 2001)

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

Installed Software:

  • GNU Compilers
  • California CVMs
  • UCVM Software

Related Entries