UCVM Model Integration Guide - Revision history

Davidgil at 22:47, 2 July 2014

2014-07-02T22:47:27Z

← Older revision		Revision as of 22:47, 2 July 2014
Line 3:		Line 3:
	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.		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.

	Please note that this guide is only for systems that support dynamic linking. ~~If you are on a system that only supports static~~ linking~~, you will need to follow~~ the ~~steps at the end~~ of ~~the~~ guide ~~to make the model work with UCVM~~.		Please note that this guide is only for systems that support dynamic linking, which is the vast majority of Linux and Mac OS X systems. Static linking is more complex and beyond the scope of this guide.

	== Interface Description ==		== Interface Description ==
Line 206:		Line 206:

	Advanced functionality will require other components than the basic model code. For example, to query by elevation, UCVM requires that an appropriate digital elevation model be installed. This guide is intended to show how most, but not necessarily all, models can be implemented into UCVM.		Advanced functionality will require other components than the basic model code. For example, to query by elevation, UCVM requires that an appropriate digital elevation model be installed. This guide is intended to show how most, but not necessarily all, models can be implemented into UCVM.

	~~== Static Linking ==~~

	~~The above code requires dynamic linking to function correctly.~~

Davidgil at 22:41, 2 July 2014

2014-07-02T22:41:45Z

← Older revision		Revision as of 22:41, 2 July 2014
Line 204:		Line 204:

	== Limitations ==		== Limitations ==

			Advanced functionality will require other components than the basic model code. For example, to query by elevation, UCVM requires that an appropriate digital elevation model be installed. This guide is intended to show how most, but not necessarily all, models can be implemented into UCVM.

			== Static Linking ==

			The above code requires dynamic linking to function correctly.

Davidgil at 22:37, 2 July 2014

2014-07-02T22:37:05Z

← Older revision		Revision as of 22:37, 2 July 2014
Line 197:		Line 197:
	Using Geo Depth coordinates as default mode.<br />		Using Geo Depth coordinates as default mode.<br />
	-118 34 0<br />		-118 34 0<br />
	-118.0000 34.0000 0.000 280.896 390.000 acme 2034.000 882.000 2000.000 none 0.000 0.000 0.000 crust 2034.000 882.000 2000.000<br />		-118.0000 34.0000 0.000 280.896 390.000 acme 2034.000 882.000 2000.000 none 0.000 0.000 0.000 crust 2034.000 882.000 2000.000<br />

	Note that this is correct (2034 = 2000 + latitude, 882 = 1000 + longitude, and 2000 = 2000 + depth).		Note that this is correct (2034 = 2000 + latitude, 882 = 1000 + longitude, and 2000 = 2000 + depth).

Davidgil: /* Compiling and Installing */

2014-07-02T22:36:40Z

Compiling and Installing

@@ Line 174: / Line 174: @@
 &nbsp;&nbsp;&nbsp;&nbsp;return 0;<br />
 }<br /><br />
-int model_ver(char *ver, int len) {<br />
+int model_version(char *ver, int len) {<br />
 &nbsp;&nbsp;&nbsp;&nbsp;int verlen;<br />
 &nbsp;&nbsp;&nbsp;&nbsp;verlen = strlen("Acme");<br />
@@ Line 184: / Line 184: @@
 &nbsp;&nbsp;&nbsp;&nbsp;return 0;<br />
 }<br /><br />
-To compile your code
+To compile your code, please run:<br />

Davidgil: /* Compiling and Installing */

2014-07-02T22:29:06Z

Compiling and Installing

← Older revision		Revision as of 22:29, 2 July 2014
Line 144:		Line 144:

	<strong>acme.c</strong><br />		<strong>acme.c</strong><br />
	<nowiki>#include <~~stdio~~.h></nowiki><br />		<nowiki>#include <string.h></nowiki><br />
	typedef struct basic_point_t {<br />		typedef struct basic_point_t {<br />
	double longitude;    // Longitude in degrees<br />		double longitude;    // Longitude in degrees<br />

Davidgil: /* Compiling and Installing */

2014-07-02T22:27:54Z

Compiling and Installing

← Older revision		Revision as of 22:27, 2 July 2014
Line 144:		Line 144:

	<strong>acme.c</strong><br />		<strong>acme.c</strong><br />
	#include <stdio.h><br />		<nowiki>#include <stdio.h></nowiki><br />
	typedef struct basic_point_t {<br />		typedef struct basic_point_t {<br />
	double longitude;    // Longitude in degrees<br />		double longitude;    // Longitude in degrees<br />

Davidgil: /* Compiling and Installing */

2014-07-02T22:27:27Z

Compiling and Installing

← Older revision		Revision as of 22:27, 2 July 2014
Line 144:		Line 144:

	<strong>acme.c</strong><br />		<strong>acme.c</strong><br />
			#include <stdio.h><br />
	typedef struct basic_point_t {<br />		typedef struct basic_point_t {<br />
	double longitude;    // Longitude in degrees<br />		double longitude;    // Longitude in degrees<br />
Line 163:		Line 164:
	for (i = 0; i < numpts; i++) {<br />		for (i = 0; i < numpts; i++) {<br />
	data[i].vp = 2000 + points[i].latitude;    // Set Vp for this point.<br />		data[i].vp = 2000 + points[i].latitude;    // Set Vp for this point.<br />
	data[i].vs = 1000 + points[i].longitude    // Set Vs for this point.<br />		data[i].vs = 1000 + points[i].longitude;    // Set Vs for this point.<br />
	data[i].rho = 2000 + points[i].depth    // Set density for this point.<br />		data[i].rho = 2000 + points[i].depth;    // Set density for this point.<br />
	data[i].qp = -1;    // Model does not have Qp.<br />		data[i].qp = -1;    // Model does not have Qp.<br />
	data[i].qs = -1;    // Model does not have Qs.<br />		data[i].qs = -1;    // Model does not have Qs.<br />

Davidgil: /* Code Description */

2014-07-02T22:27:05Z

Code Description

← Older revision		Revision as of 22:27, 2 July 2014
Line 112:		Line 112:
	for (i = 0; i < numpts; i++) {<br />		for (i = 0; i < numpts; i++) {<br />
	data[i].vp = 2000 + points[i].latitude;    // Set Vp for this point.<br />		data[i].vp = 2000 + points[i].latitude;    // Set Vp for this point.<br />
	data[i].vs = 1000 + points[i].longitude    // Set Vs for this point.<br />		data[i].vs = 1000 + points[i].longitude;    // Set Vs for this point.<br />
	data[i].rho = 2000 + points[i].depth    // Set density for this point.<br />		data[i].rho = 2000 + points[i].depth;    // Set density for this point.<br />
	data[i].qp = -1;    // Model does not have Qp.<br />		data[i].qp = -1;    // Model does not have Qp.<br />
	data[i].qs = -1;    // Model does not have Qs.<br />		data[i].qs = -1;    // Model does not have Qs.<br />

Davidgil: /* Basic Tutorial Model */

2014-07-02T22:25:26Z

Basic Tutorial Model

@@ Line 155: / Line 155: @@
 &nbsp;&nbsp;&nbsp;&nbsp;double qp;&nbsp;&nbsp;&nbsp;&nbsp;// Qp<br />
 &nbsp;&nbsp;&nbsp;&nbsp;double qs;&nbsp;&nbsp;&nbsp;&nbsp;// Qs<br />
-} basic_properties_t;
+} basic_properties_t;<br /><br />

Davidgil at 22:24, 2 July 2014

2014-07-02T22:24:09Z

← Older revision		Revision as of 22:24, 2 July 2014
Line 144:		Line 144:

	<strong>acme.c</strong><br />		<strong>acme.c</strong><br />
	~~<br />~~
	typedef struct basic_point_t {<br />		typedef struct basic_point_t {<br />
	double longitude;    // Longitude in degrees<br />		double longitude;    // Longitude in degrees<br />
	double latitude;    // Latitude in degrees<br />		double latitude;    // Latitude in degrees<br />
	double depth;    // Depth in meters<br />		double depth;    // Depth in meters<br />
	} basic_point_t;		} basic_point_t;<br /><br />
			typedef struct basic_properties_t {<br />
			double vp;    // Vp in meters per second<br />
			double vs;    // Vs in meters per second<br />
			double rho;    // Density in grams per cubic centimeter<br />
			double qp;    // Qp<br />
			double qs;    // Qs<br />
			} basic_properties_t;