UCVM Model Integration Guide - Revision history

Davidgil at 22:47, 2 July 2014

2014-07-02T22:47:27Z

2014-07-02T22:41:45Z

2014-07-02T22:37:05Z

2014-07-02T22:36:40Z

Compiling and Installing

2014-07-02T22:29:06Z

Compiling and Installing

2014-07-02T22:27:54Z

Compiling and Installing

2014-07-02T22:27:27Z

Compiling and Installing

2014-07-02T22:27:05Z

Code Description

2014-07-02T22:25:26Z

Basic Tutorial Model

2014-07-02T22:24:09Z

@@ 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.
-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 ==
@@ 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.

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

@@ Line 197: / Line 197: @@
 Using Geo Depth coordinates as default mode.<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).

@@ 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 />

@@ Line 144: / Line 144: @@
 <strong>acme.c</strong><br />
-<nowiki>#include <stdio.h></nowiki><br />
+<nowiki>#include <string.h></nowiki><br />
 typedef struct basic_point_t {<br />
 &nbsp;&nbsp;&nbsp;&nbsp;double longitude;&nbsp;&nbsp;&nbsp;&nbsp;// Longitude in degrees<br />

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

@@ 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 />