Home
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. 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.
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.
Researcher wants to use UCVM to query velocity model. Users have serveral options for accessing the software:
- No UCVM software installation required.
- 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.
- 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. This advanced usage requires the user to retrieve UCVM souce code from Github and compile it on a Linux-type system using GNU compilers.
- Casual UCVM users will probably find the UCVM Webviewer easier to use. Researcher may want to use UCVM Docker images if they want to 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.
Using UCVM Docker images to run UCVM requires basic command line computing skills from users. CaAbility to move 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.
The Docker images contain a two part test program. Without full explantion here's how to run in it.
- 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
- start docker image of ucvm plus one SCEC CVM.
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.
