Difference between revisions of "UCVM FAQ"

From SCECpedia
Jump to navigationJump to search
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Profiles ==
+
== UCVM Documentation ==
 +
The current UCVM maintained documentation is posted on github at:
 +
*[https://github.com/SCECcode/UCVMC/wiki UCVM Wiki]
  
[[LA Vertical Profiles]]
+
== Vertical Profiles ==
 +
*[[LA Vertical Profiles]]
  
 
== Official Version of UCVM ==
 
== Official Version of UCVM ==
Line 7: Line 10:
  
 
== Naming of CVMs ==  
 
== Naming of CVMs ==  
First, we should confirm which CVM you would like to work with. The naming of CVM's can be confusing, because the names have not been used consistently over the last few years. As of 2017, the CVM names have settled, and CVM-S4.26 refers to a specific tomography improved CVM.
+
Velocity Models that can be accessed through the UCVM interface are identify by '''a scientific name''', and also by '''an internal UCVM short identifier''' that is used to identify the velocity model when using UCVM. A description of available velocity models, and their UCVM identifiers is posted here:
 +
*[https://github.com/SCECcode/UCVMC/wiki/Registered-CVMs UCVM CVMs]
  
CVM-S4.26 refers to a version of CVM-S4 that was developed using full 3D tomography by Po Chen and En-Jui Lee. It has a high min Vs (about 900m/s) and it defines Vp, Vs, and rho on a 500 meter spaced grid. It has no background model, and it is only defined to about 50km.
+
As an example, the scientific name '''CVM-S4.26''' refers to a version of CVM-S4 that was developed using full 3D tomography by Po Chen and En-Jui Lee. It has a high min Vs (about 900m/s) and it defines Vp, Vs, and rho on a 500 meter spaced grid. It has no background model, and it is only defined to about 50km. The '''internal UCVM short identifier''' for this model is "cvms5".  
  
When you query it, UCVM does trilnear interpolation to determine material properties between grid points. If this is the CVM model you want to work with, you can download it from a public repository at:
+
Velocity models can be selected during installation of UCVM, so not all UCVM installations will have access to all models.  
  
*[https://github.com/SCECcode/UCVMC/wiki UCVM Wiki]
+
== Interpolation of Models Defined on Regular Grid ==
 +
For discrete models like CVM-S4.26, which is defined on a 500m grid, UCVM uses trilnear interpolation to determine material properties between grid points.
  
Before you can query CVM-S4.26, UCVM must be built and installed on a Linux computer, such as USC HPC research computing center. If your group is used to building open-source software on Linux computers, then they may be able to work through the installation process described on the UCVM github wiki. I have gone through the UCVM installation process many times, and I know it can be challenging to new users.
+
== UCVM Software Installation Options ==
 +
Before you can query CVM-S4.26, UCVM must be built and installed on a Linux computer, such as USC HPC research computing center. If you are used to building open-source software on Linux computers, then they may be able to work through the installation process described on the UCVM github wiki.
  
 
*[https://github.com/SCECcode/UCVMC/wiki/Installation Installation Instructions]
 
*[https://github.com/SCECcode/UCVMC/wiki/Installation Installation Instructions]
  
If you are planning small-scale tests of the CVM-S4.26, we can provide a Virtual Box installation which would enable users to query CVM-S4.26 on a Mac.
+
We created a Virtual Box installation of UCVM which enables users to query common southern California Velocity models (CVM-S4, and CVM-S4.26) on a Mac. This virtual box image is posted it on a SCEC software workshop page [[Software_Workshop_2018]].
 +
 
 +
*[https://github.com/SCECcode/UCVMC/wiki UCVM Wiki]
 +
 
 +
== Related Entries ==
 +
*[[UCVM]]
 +
*[[Software_Workshop_2018]]

Latest revision as of 23:09, 1 November 2018

UCVM Documentation

The current UCVM maintained documentation is posted on github at:

Vertical Profiles

Official Version of UCVM

The current (May 2018) official release of UCVM is UCVM v17.1 which is the last release of the C-language version of UCVM. This can be obtained by cloning the UCVMC github repository. The UCVMP (Python language version of UCVM) release is under review, but is not currently used for research purposes.

Naming of CVMs

Velocity Models that can be accessed through the UCVM interface are identify by a scientific name, and also by an internal UCVM short identifier that is used to identify the velocity model when using UCVM. A description of available velocity models, and their UCVM identifiers is posted here:

As an example, the scientific name CVM-S4.26 refers to a version of CVM-S4 that was developed using full 3D tomography by Po Chen and En-Jui Lee. It has a high min Vs (about 900m/s) and it defines Vp, Vs, and rho on a 500 meter spaced grid. It has no background model, and it is only defined to about 50km. The internal UCVM short identifier for this model is "cvms5".

Velocity models can be selected during installation of UCVM, so not all UCVM installations will have access to all models.

Interpolation of Models Defined on Regular Grid

For discrete models like CVM-S4.26, which is defined on a 500m grid, UCVM uses trilnear interpolation to determine material properties between grid points.

UCVM Software Installation Options

Before you can query CVM-S4.26, UCVM must be built and installed on a Linux computer, such as USC HPC research computing center. If you are used to building open-source software on Linux computers, then they may be able to work through the installation process described on the UCVM github wiki.

We created a Virtual Box installation of UCVM which enables users to query common southern California Velocity models (CVM-S4, and CVM-S4.26) on a Mac. This virtual box image is posted it on a SCEC software workshop page Software_Workshop_2018.

Related Entries