Difference between revisions of "UCVM 15.10.0"

From SCECpedia
Jump to navigationJump to search
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== CVM Models in Distribution ==
+
== Virtual Box with Latest CVMs ==
*CVMS4
+
*[[CCA]] - CCA05 (iteration five mesh with trilinear interpolation)
*CVMS4.26
+
*[[CVM-H]] - CVM-H v15.1 (as described in USR paper. No background Model)
*CVM-S5
+
*[[CVM-S4]] - CVM-S4 (best available version of final SCEC rule-based CVM (Kohler et al 2001))
*CVM-H 15.1.0
+
*[[CVM-S4.26]] - CVM-S4.26 (final mesh from CVM-S4.26 inversion and trilinear interpolation between points. No background model)
*Cencal080
+
*[[CVM-S4.26.M01]] - CVM-S4.26.M01 (iteration 26 plus rule-based GTL for top 300m)
*CCA05
+
 
 +
 
 +
== UCVM Installation Notes ==
 +
*[[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 ==
 
== Basic UCVM Usage ==
Line 14: Line 44:
 
== Querying Material Properties ==
 
== Querying Material Properties ==
  
In order to get material properties from any model, you simply need to run the ucvm_query utility.
+
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
 
  cd /home/scec/ucvm-15.10.0/bin
 
  ./ucvm_query -f ../conf/ucvm.conf -m cvms
 
  ./ucvm_query -f ../conf/ucvm.conf -m cvms
Line 28: Line 58:
 
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.
 
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.
 
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 ==
 
== Source Code Distribution ==

Latest revision as of 06:54, 29 November 2016

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

Installed Software:

  • GNU Compilers
  • California CVMs
  • UCVM Software

Related Entries