CreateContourDB()
Summary
Creates a line or area geographic file of the contours derived from a TIN.
Syntax
CreateContourDB(tin t, string db_name, array options)
| Argument | Contents |
|---|---|
| t | A TIN |
| db_name | The name of the output geographic file |
| Option | Type | Contents |
|---|---|---|
| Areas | String | "Yes" to create an area geographic file, "No" to create a line geographic file |
| Layer Name | String | The name for the new layer |
| Label | String | The label for the new layer |
| Automatic | Integer | The number of contour levels desired, 2 or more; if null use the Fixed and Major options to set the contour intervals |
| Fixed | Real | The minor contour interval |
| Major | Real | The major contour interval; there will be thicker contours at the major contour intervals unless the major contour interval equals the minor contour interval |
| Max Contour | Real | The maximum contour value |
| Enclose | String | "Yes" to enclose the convex hull of the points, "No" otherwise |
Notes
-
The Major option is only available for line geographic files.
-
Based on the data, there may be more or less contour levels than the number chosen with the Automatic option.
-
Use the Max Contour option to limit the contours to lower elevations, in areas where there are abrupt peaks.
Example
// Open Elevdata.cdf in the Tutorial folder
SetLayer("Elevation Layer")
point_tin = CreateTriangulation("Elevation Layer|", {{"Field","Elevation"}})
folder = RunMacro("G30 Tutorial Folder")
CreateContourDB(point_tin, folder + "contours.dbd",
{{"Automatic", 10},{"Layer Name","Elevation Contours"}})
Error Codes
| Error Type | Meaning |
|---|---|
| Error | The TIN compound variable is null, or the options are not of the required type |
See Also
| Function | Summary |
|---|---|
| CreateTriangulation() | Creates a Triangulated Irregular Network (TIN) |
| CreateTriangulationAreaDB() | Creates an area geographic file from the facets in a TIN, with slope and aspect values |
| CreateVisibilityMap() | Creates an area geographic file from a TIN to show the area that is visible from a certain height at a viewpoint |