UCVM Model Integration Guide

Introduction

UCVM 14.7.0 introduced a new interface designed to make installing and adding new models easier. Unlike previous versions of UCVM, starting with UCVM 14.7.0, UCVM will not need to know about the model at compile-time in order to make use of it. This means that model developers can more readily use UCVM's plotting utilities, meshing utilities, and other capabilities with their models.

Interface Description

Basic Structures

All UCVM models work in the following basic manner:

1) Take as input latitude, longitude, and depth, with spherical earth co-ordinates using the WGS84 ellipsoid.
2) Return material properties for that point. The material properties consist of one or more of Vp (m/s), Vs (m/s), Density (g/cm^3), Qp, and/or Qs.

UCVM passes the input latitude, longitude, and depth through a structure which is defined as follows:

typedef struct basic_point_t {
    double longitude;
    double latitude;
    double depth;
} basic_point_t;