UCVM Docker

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
• Using the Docker Desktop configuration, Select Resources, Select File Sharing, and make sure the installation directory you will use on your local computer is shared with Docker.

2. 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

3. Create a "target" directory where UCVM files are input/output

• cd /Users/maechlin/ucvm_docker
• mkdir target
• ls /Users/maechlin/ucvm_docker/target

4. 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. Here are examples for three available images. You only need to run the command that retrieves the model you are interested in querying. You don't need to run all three of these commands.

• docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/home/ucvmuser/target sceccode/ucvm_257_cvmsi:0801
• docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/home/ucvmuser/target sceccode/ucvm_257_cvmh:0801
• docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/home/ucvmuser/target sceccode/ucvm_257_sfcvm:0802

or

• docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/home/ucvmuser/target sceccode/ucvm_257_cvmsi:latest
• docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/home/ucvmuser/target sceccode/ucvm_257_cvmh:latest
• docker run --rm -it --mount type=bind,source="$(pwd)"/target,destination=/home/ucvmuser/target sceccode/ucvm_257_sfcvm:latesy

5. The images starts and users sees a Linux bash shell command line prompt as user "ucvmuser" in directory:

• /home/ucvmuser/target

7. Run a ucvm_query test query

• $ucvm_query -f /home/ucvmuser/app/ucvm/conf/ucvm.conf -m cvmsi < /home/ucvmuser/app/ucvm/tests/inputs/test_latlons.txt

8. 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 /home/ucvmuser/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.