View source for UCVM

The '''Unified Community Velocity Model (UCVM)''' software framework is a collection of software tools designed to provide standard interface to multiple, alternative, California 3D velocity models. One important use of UCVMC is in high resolution 3D wave propagation simulations for California. UCVM development is an interdisciplinary research collaboration involving geoscientists and computer scientists. UCVM geoscience research includes identification and assembly of existing California velocity models into a state-wide model and improvements to existing velocity models. UCVM computer science research includes definition of a easy-to-use CVM query interface, integration of regional 3D and geotechnical models, and automated CVM evaluation processing capabilities.

The original version of the software is written in the C-language. An updated, python language version, of UCVM is under development under the [[UCVMC]] name. 

[[File:UCVM_Models_paper.png|356px|thumb|right|Coverage region for UCVM 2D maps (cyan) overlayed upon regions of various California 3D velocity models (CVM-S4: red, CVM-H: blue, USGS Bay Area: white)]]

== UCVM Github Repository ==
The current UCVM software distribution has been moved to a public github repository. The UCVM Github repository is called UCVMC to identify it as the C-language version of the code. The github wiki also provides additional software documentation.
*[https://github.com/SCECcode/UCVMC/wiki UCVMC Github Wiki]

This current version version of UCVM on github is a simplified version of the UCVM v15.10.0 software that was released in 2015. Essential features of that release are maintained in this version, but several optional or experimental features and models are not included to make the software easier to install, use, and maintain.

== UCVM_Introduction ==
The Unified Community Velocity Model (UCVM) software is open-source scientific software designed to support earth scientists, civil engineers, and other groups interested in detailed information about earth properties. UCVM is primarily used by scientists to work with earth material properties on regional scales. 

UCVM software provides a software interface to one or more existing earth structure models. The earth structure models can be used directly without requiring UCVM. While UCVM adds complexity, it provides software capabilities that may be valuable to researchers. These UCVM specific capabilities include:

#Provides standard query interface to multiple CVM models with different projections.
#Converts query by elevation to query by depth to create comparable models.
#Provides standard methods for tri-linear interpolation, Vs30, and basin query from models.
#Provides plotting and analysis tools that make vertical profile, horizontal, and cross section plots.
#Provides tools to add gtl and ssh into models.
#Supports tiling of models and background models.
#Make AWP and ETree format meshes including parallel extractions.

== UCVM_System_Requirements ==
Reference computing environment is the USC HPC system.
* Centos 5.6
* gnu C, gfortran 4.5
* Python 2.7
* Anaconda Python packages
* Git client
* vi or emacs

Parallel UCVM Build Adds:
* MPI
* MPICH

== UCVM_Installation ==
UCVM installation does not require root access. It does require approximately 30G disk space for all the models to be installed.

The UCVM installation establishes two directory tree, the source tree, and the installation tree. The source tree is used during the installation process, but the bin directory is where the software is installed for use. Then the source tree can be removed. The UCVM install script will prompt you to enter an installation directory.

The UCVMC software and associated installation directions are now hosted as open-source software on SCEC's github account. Please visit this site to retrieve the software source code and additional detailed installation information.

*[https://github.com/SCECcode/UCVMC/wiki UCVMC Github Repository]

== Related Entries ==
*[[UCVM]]
*[[UCVM Users Guide]]
*[[USR]]
*[[CME Project]]