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 10 U.S. seismic velocity models can retrieve UCVM Docker images that include the model data, and query the model using the ucvm interface.

Compiling the UCVM distribution can be a challenge for researchers. SCEC is using Docker virtualization technology to simplify access to UCVM. By using Docker on their Linux, Mac, or PC, computer, users can run a pre-built version of UCVM easily.

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

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.

Overview of Running an UCVM Image

• User installs Docker client software on their computer (Mac,Windows,Linux)
• User creates an Dockerhub Dockerhub user account
• User starts the Docker client on their local computer
• User open a terminal window on their local computer
• User creates a "target" directory where files will be saved after ** mkdir target
• User run UCVM Docker image ** docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/app/target sceccode/ucvm_cvmh:07021555 Docker will look on your local system for the specific image "sceccode/ucvm_1210_cvms5:09131139" and it will look on Dockerhub and retrieve it from there when the image is not found locally.

Example UCVM Image 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

Contact

[email protected]