ExportGeography()

Summary

Converts a geographic file between standard and compact format, or creates a new geographic file from a selection set.

 

Syntax

ExportGeography(string lyr_set_name, string db_name, array options)

 

Argument	Contents
lyr_set_name	The name of the layer or selection set to export
db_name	A complete path and file name for the new geographic file. The extension indicates the file type: .DBD for standard format, .CDF for compact format

 

Option	Type	Contents
Centroid	Boolean	If "True" export area centroids; if "False" (default), export area borders
Field Spec	Array	An array of full field spec strings; these are the fields to be exported
Field Name	Array	An array of strings to be used as field names in the new database; the default is to use the original names
ID Field	String	The field spec of the field to use as the master record ID in the new file. When exporting to a standard format file, this field must be an integer field
Indexed Field	Array	An array of full field specs of those fields to be indexed
Indexed Node Field	Array	An array of full field specs of those node fields to be indexed
Internal Data	Boolean	A flag used only when backward compatibility with Caliper Version 2.X products is required
Label	String	Descriptive label for the new geographic file
Layer Name	String	The desired layer name
Median Split	Boolean	If "True" special handling insures that entities which cross the 180 degree longitude line are exported properly; if "False" (the default), no special handling is invoked and the export is faster
Node Name	String	The desired name for the endpoint layer (only when exporting a line layer)
NAD Conversion	3 strings	Input datum, output datum, and conversion file (if needed); the input and output datums should be different
Node Field Spec	Array	An array of full field spec strings for the node layer field; these are the fields to be exported for the nodes in a line database
Node Field Name	Array	An array of strings to be used as node field names in the new line database; the default is to use the original names
Node ID Field	String	The field spec of the node field to use as the master record ID in the new file; when exporting to a standard format file, this field must be an integer field
Overlap	String	Describes what to do with areas that overlap; takes one of the following values:"Ignore" - Leave overlaps as-is and simply create a non-topological database, possibly containing overlapping areas"Merge" (the default) - Where two areas overlap, merge the intersection into one of them; which one is arbitrarily decided"New" - Create a new area where the two areas overlap

 

Notes

• Use CopyDatabase() to make an exact copy of a geographic file. Use ExportGeography() to create a smaller database from a selection set, or to convert between formats.

• When exporting standard point databases to the compact format, an error may occur if some of the coordinates are missing values.

• When exporting to the compact format, errors may occur if the field name specified by "Field Name" is an expression field.

• For more details on the NAD Conversion option, see Datum Conversions.

Example

SetLayer("States")

qry = "Select * where Population/Area > 100"

SelectByQuery("Selection", "Several", qry, )

ExportGeography("States|Selection", "highdesn.cdf", )

 

Error Codes

Error Type	Meaning
Error	An error occured while creating the geographic file (e.g., out of disk space)
NotFound	The specified layer or set name does not exist

 

See Also

Function	Summary
CopyDatabase()	Copies either a standard- or compact-format geographic file
CreateStreetCDF()	Creates a compact format address-matchable street file
ExportGeoJson()	Exports features in a geographic file to a GeoJson file
ExportDXF()	Exports features in a geographic file to a DXF file