ucvm_plotting

Description:

This ucvm_plotting software was originally included in UCVM v19.4.0 which was released in June 2019. In 2021, the plotting utilities in UCVM v19.4 were moved into this standalone repository.

The UCVM plotting utilities make use of Python2 libraries which will must be converted to Python3 for continued development. The current plotting utilities rely on Python2, which must be installed on systems using these utilities.

UCVM_plotting is distributed as open-source scientific software. It can be installed compiled and run on most Linux-based computer systems if the system includes software development tools including Python, C, and Fortran compilers, and other software tools. The UCVM v19.4.0 source code is distributed using a github repository. On Github, users can find the source code, installation directions for Linux, and a wiki that provide examples and the expected results from UCVM.

Table of Contents:

1. Software Documentation
2. Installation
3. Usage
4. Support
5. Contributing
6. Credits
7. License

Installation:

Prerequisite : anaconda with python2 virtual environment. The python2 environment should include the following libraries. The required python2 environment can be added to an anaconda python3 installation with this command

• conda create -n python2 python=2.7 scipy pip numpy matplotlib basemap basemap-data-hires

• install UCVM per instruction, https://github.com/SCECcode/ucvm/wiki

• source ucvm's install_loc/conf/ucvm_env.sh

• git clone https://github.com/SCECcode/ucvm_plotting.git

• cd into ucvm_plotting

• ./unpack-dist

• This will build the ucvm_plotting utilities, and add the ucvm_plotting scripts to the users path.

Usage:

Once both ucvm and ucvm_plotting are installed, users can run ucvm_plotting scripts like this:

plot_depth_profile.py

The following command will produce a depth profile of CVM-H v15.1 for Vs, Vp and density at (34,-118) from depth of 0 to 50000m

./plot_depth_profile.py -s 34,-118 -b 0 -e 50000 -d vs,vp,density -v 500 -c cvmh -o depth_profile.png

plot_horizontal.py

The following command will produce a horizontal map view plot plot of Vs values from CVM-H v15.1 at a depth of 500m for the Los Angeles region.

./plot_horizontal_slice.py -b 33.5,-118.75 -u 34.5,-117.5 -s 0.01 -e 500 -d vs -a s -c cvmh

Please see the ucvm_plotting documetation for more information and examples.

Support:

Support for UCVM is provided by that Southern California Earthquake Center (SCEC) Research Computing Group. This group supports several research software distributions including UCVM. Users can report issues and feature requests using UCVM's github-based issue tracking link below. Developers will also respond to emails sent to the SCEC software contact listed below.

1. UCVM Github Issue Tracker:
2. Email Contact: [email protected]

Contributing:

We welcome contributions to the UCVM_plotting software utilities. An overview of the process for contributing seismic models or software updates to the UCVM_plotting Project is provided in the UCVM_plotting contribution guidelines. UCVM_plotting contributors agree to abide by the code of conduct found in our Code of Conduct guidelines.

Credits:

Development of UCVM_plotting is a group effort. A list of developers that have contributed to the UCVM Software framework are listed in the Credits.md file in this repository.

License:

The UCVM software is distributed under the BSD 3-Clause open-source license. Please see the LICENSE.txt file for more information.