UCVM Docker - SCECcode/ucvm GitHub Wiki

UCVM Docker Installation:

UCVM Docker images contains UCVM software which can be run without a significant installation process. Users install the Docker client on their Laptops, and then use the Docker client software to run UCVM Docker images. Docker client software is available as a free software download for several operating systems including MacOS, Windows, and Linux.

  1. Install Docker Client on User Computer and Start Docker Client
  • Docker Client download from Dockerhub
  • Increase Docker configuration to 2 CPUs and 50GB memory
  1. Open a terminal window on your local computer, and create a directory where you will run UCVM.
  • mkdir /Users/maechlin/ucvm_docker
  • cd /Users/maechlin/ucvm_docker
  1. Create a "target" directory where UCVM files are input/output
  • cd /Users/maechlin/ucvm_docker
  • mkdir target
  • ls /Users/maechlin/ucvm_docker/target
  1. Open a terminal window and start the UCVM Docker image using the docker run command below. The UCVM image will be downloaded from Dockerhub. The image is about 6GB so download time may be minutes or longer.
  • docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/app/target sceccode/ucvm_1210_cvms5:09131731

  1. The images starts and users sees a Linux bash shell command line prompt as user "ucvm" in directory: /app/target

  2. Run a ucvm_query test query

  • $ucvm_query -f /app/ucvm/conf/ucvm.conf -m cvmh < /app/test_latlons.txt
  1. Create your own test_latlons.txt in your "target" directory
  • Files saved to "target" will be saved after container exits. So put any input or outputs in the "target" directory.
  • If you edit the /app/ucvm/conf/ucvm.conf file, since that file is in the container file system, file edits will be lost when the container exits.

Once installed, UCVM provides an executable program, called ucvm_query, that implements a query interface to multiple seismic velocity models.