Home

UCVM Docker Overview

SCEC's UCVM Software is scientific software used to query seismic velocity models for California and other regions. UCVM is designed to be compiled and run on Linux computers. UCVM involves C, C++, FORTRAN, and python software and uses open-source Linux operating systems and compilers.

Motivation for UCVM Docker Images

Geoscientists interested in crustal seismic velocity information may use SCEC UCVM software as a standard method for querying the models. Here we prototype Docker-based distributions of UCVM and SCEC seismic velocity models. Scientists interested in querying any of 9 U.S. seismic velocity models can retrieve UCVM Docker images including the model data.

Compiling the UCVM distribution can be a challenge for researchers. SCEC is evaluating Docker virtualization technology as a way to simplify the use of UCVM. By starting docker on their Linux, Mac, or PC, they can run a pre-built version of UCVM without installing it. We are using this repo to manage our docker prototypes.

Ways to Access UCVM Velocity Models

Users have serveral options for accessing the UCVM software:

1. SCEC Community Model Viewer (preliminary version)

• No UCVM software installation required.

2. Run UCVM Docker Images in a container on thier local computer

• Users must install a free Docker Docker software client on their computers. Then UCVM runs on the users computer.

3. UCVM is used to build large simulation meshes for ground motion simulations.

• The UCVM has parallel extensions that use MPI to signicantly speed-up the extraction of material properties from California velocity models by using parallel extractions. To build and run UCVM on Linux clusters, users can retrieve UCVM souce code from Github and compile it on a Linux-type system using GNU compilers.

Considerations before using UCVM Docker Images

• UCVM users may find the UCVM Webviewer easier to use than UCVM Docker images. However, researcher may want to use UCVM Docker images their extract material properties from UCVM models for 100-1M data points. Queries below 100 pts might be easier using the website. Points more then 1M may require native installation of UCVM on a Linux server.

Required Computer Capabilities for using UCVM Images

• Users install the Docker on their computer (Mac,Windows,Linux)
• Users create an account on dockerhub Dockerhub
• Users start the Docker client on their local computer
• Users open a terminal window on their local computer

Using UCVM Docker images to run UCVM requires basic command line computing skills from users. Users should be comfortable moving around (cd, ls, pwd) at a Linux bash shell. UCVM Docker image users also need to run UCVM command line interfaces with appropriate parameters, like ucvm_query and basin_query.

Example Use Case

The Docker images contain a two part test program. Using a user on a Mac, with Docker installed and running, here's how to run the UCVM Docker image.

• User moves to ucvm_docker directory on their Laptop cd /Users/maechlin/ucvm_docker
• User

Running UCVM Docker Images

docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/app/target  sceccode/ucvm_cvmh:07021555

Docker will look on your local system, and will look on dockerhub and retrieve it from there when it is not found locally.

Contact

software@scec.org