Difference between revisions of "UCVM 13.9.0 User Guide"

From SCECpedia
Jump to navigationJump to search
Line 14: Line 14:
 
<br /><br />
 
<br /><br />
 
The API itself is written entirely in C. We will show how to query UCVM through both C and Fortran in this user guide.
 
The API itself is written entirely in C. We will show how to query UCVM through both C and Fortran in this user guide.
 +
<br /><br />
 +
Finally, UCVM requires either Linux or OS X, GCC 4.3+, Python 2.5+, and an active internet connection to download and retrieve the models. For parallel mesh or e-tree extraction, the MPI libraries are also required.
  
 
== Installation Instructions ==
 
== Installation Instructions ==
Line 24: Line 26:
 
<code style="font-size: 14px;">
 
<code style="font-size: 14px;">
 
tar zxvf ucvm-13.9.0.tar.gz
 
tar zxvf ucvm-13.9.0.tar.gz
 +
cd ./UCVM
 +
./ucvm_setup.py
 
</code>
 
</code>
 
</blockquote>
 
</blockquote>

Revision as of 15:29, 10 September 2013

Released on September 8th, 2013, UCVM 13.9.0 represents the second major release of the Unified Community Velocity Model (UCVM) framework. UCVM is a collection of software utilities that are designed to make querying velocity models, building meshes, and visualizing velocity models easier to do through a uniform software interface. UCVM has been used extensively to generate meshes and e-trees that are then used for 3D wave propagation simulations within California.

The full feature list is as follows:

  • Seamlessly combine two or more models into a composite model for querying
  • Optionally include a California statewide geotechnical layer and interpolate it with the crustal velocity models
  • Extract a 3D mesh or CVM Etree (octree) of material properties from any combination of models
  • Standard California statewide elevation and Vs30 data map is provided
  • Miscellaneous tools are provided for creating 2D etree maps, and optimizing etrees
  • Numerically smooth discontinuities at the interfaces between different regional models
  • Add support for future velocity models with the extendable interface


Currently, we support CVM-S4, CVM-H 11.9.1, CVM-S4.23, CenCal 0.8.0, and the Hadley-Kanamori as part of our automated installation package. Other models, such as SCEC CVM-NCI, Magistrale WFCVM, Graves Cape Mendocino, Lin-Thurber Statewide, and Tape SoCal are supported, however they will require a manual installation. We have also tested and include support for three major high-performance computing resources: NICS Kraken, TACC Stampede, and NCSA Blue Waters. It should work with other HPC machines as well.

The API itself is written entirely in C. We will show how to query UCVM through both C and Fortran in this user guide.

Finally, UCVM requires either Linux or OS X, GCC 4.3+, Python 2.5+, and an active internet connection to download and retrieve the models. For parallel mesh or e-tree extraction, the MPI libraries are also required.

Installation Instructions

Easy Method

If you are installing UCVM on Linux or OS X and only need CVM-S4, CVM-H 11.9.1, CVM-S4.23, and/or CenCal, we strongly recommend following the easy installation method. Simply download UCVM 13.9.0 and run the following commands:

tar zxvf ucvm-13.9.0.tar.gz cd ./UCVM ./ucvm_setup.py