Command Reference
The basic UCVM interface is an command line executable called
- ucvm_query
The input parameters to this query include:
- Path to the location of UCVM configuraiton file (called ucvm.conf)
- The model name of the seismic velocity model the user wants to query
- The input data points in lon lat depth (or elevation), with lon and lat in decimal degrees, and depth or elevation in meters. Depth is given as positive meters below earth surface. Elevation is given as positive above sea level, and negative below sea level in meters.
- The default query mode is query by depth. This is assumed if no query mode parameter is used. If the input data points are given in elevation, ucvm_query requires a command line parameter -p ge to indicate that the inputs are in elevation.
- An example query by depth input file:
-118.0 34.0 0.0 -118.0 34.0 50.0 -118.0 34.0 100.0 -118.0 34.0 500.0 -118.0 34.0 1000.0
- The seismic velocity model name to be queried is passed into the ucvm_query as an abbreviation. The correct abbrevation for each model is not obvious, particulary to new users of ucvm. The table below provides a mapping from Scientific velocity model name to UCVM model abbreviation.
The following California velocity models packages are included as part of a standard UCVM installation. Each model is assigned an abbreviation, and these abbreviations are used to specify the models when making UCVM queries. The model abbreviations used by UCVM are defined in following tables:
| Model Name | Description | UCVM Abbreviation | Size |
|---|---|---|---|
| CVM-H v15.1 | Southern California Velocity Model developed by Harvard Structural Geology Group with optional geotechnical layer | cvmh | 1.6G |
| CVM-S4 | Southern California Velocity Model developed by SCEC, Caltech, USGS Group with geotechnical layer | cvms | 326M |
| CVM-S4.26 | Tomography improved version of CVM-S4 with optional geotechnical layer(Ely-Jordan GTL, default is off) | cvms5 | 1.2G |
| CVM-S4.26.M01 | CVM-S4.26 with added geotechnical layer | cvmsi | 1.6G |
| CCA06 | Central California Velocity Model with optional geotechnical layer (Ely-Jordan GTL, default is off) | cca | 9.2G |
| CS17.3 | Cypershake study 17.3 Central California Velocity Model and optional geotechincal layer (Ely-Jordan GTL, default is off) | cs173 | 72G |
| CS17.3-H | Cypershake study 17.3 Central California Velocity Model with San Joaquin and Santa Maria Basins data from Havard's group and optional geoptechnical layer (Ely-Jordan GTL, default is off) | cs173h | 72G |
| USGS Bay Area Velocity Model 0.8.3 | USGS developed San Francisco and Central California velocity model | cencal | 17G |
| Albacore | Albacore California off-shore Velocity Model | albacore | 2.3M |
| IVLSU | SSIP Imperial Valley Velocity Model developed by LSU | ivlsu | 1M |
| CVLSU | SSIP Coachella Valley Velocity Model developed by LSU | ivlsu | 1M |
| WFCVM | Wasatch Front Community Velocity Model | wfcvm | 50M |
| Southern California 1D | Modified Hadley Kanamori 1D model based on Hadley-Kanamori model | 1d | 8k |
| Northridge Region 1D | Los Angeles Region 1D model used in SCEC Broadband Platform | bbp1d | - |
This is the basic UCVM interface that queries velocity model of interest.
*A command line query
ucvm_query -f /usr/local/opt/ucvm/conf/ucvm.conf -m cvmh -l 33.84007,-117.95683,0.0 Using Geo Depth coordinates as default mode. -117.9568 33.8401 0.000 34.438 293.500 cvmh 1238.170 120.690 1450.659 none 0.000 0.000 0.000 crust 1238.170 120.690 1450.65
- Review input file as:
-bash-4.2$ cat ./tests/inputs/test_latlons.txt -118.0 34.0 0.0 -118.0 34.0 50.0 -118.0 34.0 100.0 -118.0 34.0 500.0 -118.0 34.0 1000.0
- Invoke basic ucvm_query, specifying CVM-S4.26.M01 (as cvmsi):
-bash-4.2$ ./bin/ucvm_query -f ./conf/ucvm.conf -m cvmsi < ./tests/inputs/test_latlons.txt > ./ucvm_query_results.txt
cat ucvm_query_results.txt
The results are in a column oriented format. Abbreviations are like this:
tput format is: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 lon lat Z surf vs30 crustal cr_vp cr_vs cr_rho gtl gtl_vp gtl_vs gtl_rho cmb_algo cmb_vp cmb_vs cmb_rho
The first three colums are input values, the remaining columns are information about the velocity model used provide the material properties. Crustal models, and Geotechnical Models can be stored and used seperately in UCVM. The contributions of each model are shown in columns 5-8 and 10-12, but the combined results returned in 14-16 are typically used by modelers.
-118.0000 34.0000 0.000 280.896 390.000 cvmsi 696.491 213.000 1974.976 none 0.000 0.000 0.000 crust 696.491 213.000 1974.976 -118.0000 34.0000 50.000 280.896 390.000 cvmsi 1669.540 548.000 2128.620 none 0.000 0.000 0.000 crust 1669.540 548.000 2128.620 -118.0000 34.0000 100.000 280.896 390.000 cvmsi 1683.174 603.470 2130.773 none 0.000 0.000 0.000 crust 1683.174 603.470 2130.773 -118.0000 34.0000 500.000 280.896 390.000 cvmsi 2701.217 1475.609 2354.105 none 0.000 0.000 0.000 crust 2701.217 1475.609 2354.105 -118.0000 34.0000 1000.000 280.896 390.000 cvmsi 3330.909 1945.594 2443.042 none 0.000 0.000 0.000 crust 3330.909 1945.594 2443.042
