ImportNTF()
Summary
Imports features from one or more Ordnance Survey NTF volumes into a geographic file.
Syntax
ImportNTF(array filenames, string data_product, string level, string new_db_name, string layer_type, string table_name, array options)
| Argument |
Contents |
| filenames |
An array of path and file names of the file (volumes) to import, starting with volume 1 and listed in increasing volume order |
| data_product |
The data product to import; one of the following: "ADDRESS-POINT", "BaseData.GB", "Boundary-Line", "Land-Line", "Land-Form PANORAMA Contours", "Land-Form PANORAMA DTM", "Land-Form PROFILE Contours", "Land-Form PROFILE DTM", "OSCAR Asset-Manager", "OSCAR Network-Manager", "OSCAR Route-Manager", "Strategi", "Urban-Areas" |
| level |
level or feature type name, as returned in the levels array from GetNTFInfo (this may be null for some products) |
| new_db_name |
The path and file name of the new geographic file |
| layer_type |
The type of features to import: "Point", "Line", or "Area" |
| table_name |
The path and file name of the new table file |
| Option |
Type |
Contents |
| Label |
String |
A descriptive label for the geographic file |
| Layer Name |
String |
The name of the layer in the geographic file |
| Median Split |
Boolean |
If "True" special handling ensures that entities which cross the 180 degree longitude line are imported properly; if "False" (the default), no special handling is invoked |
| Node Layer Name |
String |
The desired name for the endpoint layer (only when importing a line layer) |
| Node Table |
String |
The path and file name of a table to store node attributes (only if layer_type is Line) |
| Optimize |
Boolean |
Whether to optimize the geographic file automatically after the import; defaults to "True" |
Example
ImportNTF({"c:\\ntf\\2112_1.ntf, "c:\\ntf\\2112_2.ntf"}, "Boundary-Line",
"Civil Parish","parish.dbd", "Area", "parish.dbf", {
{"Label", "Ordnance Survey Data"},
{"Layer Name", "Parishes"}})
Error Codes
| Error Type |
Meaning |
| NotFound |
There is no file by this name; or there are no entities in the files of the desired type |
| Error |
The file is not a valid NTF file; the files are out of sequence; or the files are not from the same data series |
See Also
| Function |
Summary |
| GetNTFInfo() |
Provides information on a dataset of Ordnance Survey NTF volumes |
| GetNTFVolume() |
Returns information on an Ordnance Survey NTF file (volume) |