Difference between revisions of "UCVM FAQ"

From SCECpedia
Jump to navigationJump to search
(Created page with " 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 year...")
 
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
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.
+
== UCVM Documentation ==
 +
The current UCVM maintained documentation is posted on github at:
 +
*[https://github.com/SCECcode/UCVMC/wiki UCVM Wiki]
  
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.
+
== Vertical Profiles ==
 +
*[[LA Vertical Profiles]]
  
A recent release of UCVM includes this model. 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:
+
== 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.
  
https://github.com/SCECcode/UCVMC/wiki
+
== 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:
 +
*[https://github.com/SCECcode/UCVMC/wiki/Registered-CVMs UCVM CVMs]
  
  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.
+
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".  
  
https://github.com/SCECcode/UCVMC/wiki/Installation
+
Velocity models can be selected during installation of UCVM, so not all UCVM installations will have access to all models.  
  
  Let me know if this is the model you wish to work with, and if your group has Linux computers where they can install it. If so, I would recommend we have a telecon to walk one, or more, of your group through the installation process.
+
== 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.
  
  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. However, it might take us a few more days to create this kind of distribution.
+
== 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.
  
Hope this helps. Let me know if you'd like help getting a working version installed on a local Linux system.
+
*[https://github.com/SCECcode/UCVMC/wiki/Installation Installation Instructions]
 +
 
 +
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