GeoTools->GDF Viewer

Prev: Animation Tools

Table of Contents

Next: Installation


The Geographic Data Files (GDF) are used to model road network data for navigation purposes. For a brief introduction and explanation of GDF, read this page, What is a GDF file?.

The GDFViewer comprises of a set of routines that run as an add-on module within the GeoTools environment and are used to  view, query, analyze and compare GDF files within the AutoCAD environment.

All commands within this module start with the prefix IG_




Menu : GeoTools GDF Viewer Import GDF file
Command line : IG_IMPORTGDF 

The IG_IMPORTGDF command is used to import GDF files and display the contents of the GDF file within AutoCAD. You can import the Level 1 Point (GDF Record 51),  Line (GDF Record 52) and Area (GDF Record 53) features with this command as well as Level 2 features like Complex Features (GDF Record 54), Conversion Features (GDF Record 46) and Relationship Records (GDF Record  50).

Input GDF file :

Select: Click on the Select button to specify the name and location of an GDF file that you wish to import.

GDF Variant : From the drop down box you can choose the required GDF Variant. i.e. TeleAtlas, NavTech or CEN. Currently, the program is tested only with the TeleAtlas variant.

Point Feature Import :

Import Method: You can import the Point Features in different ways. Specify your Import Method here.

All : Imports all Point Features found in the GDF file. No filters or checks are applied.

Object ID : Imports the point feature with specified Object ID (s).

Feat Code : Imports the point feature with specified Feature Codes.

None : Does not Import the point feature.

Feature Code's [comma delimited]  : Specify the point feature code in the text box provided, if multiple point features have to be imported then multiple feature codes can be provided by comma separator. 
Note: The feature code text box is highlighted only when you select Feat Code in the import method 


Object ID's [comma delimited] 
: Specify the Object ID in the text box provided, if multiple point objects have to be imported then multiple Object ID's  can be provided by comma separator. 
Note: The Object ID's text box is highlighted only when you select Object ID in the import method 


Line Feature Import
:

Import Method: Allows to choose the required import method.

All : Imports with all details like Feature code, Object ID etc.

Object ID : Imports the line feature with specified Object ID.

Feat Code : Imports the line feature with specified Feature Code.

None : Does not Import the line feature.

Feature Code's [comma delimited]  : Specify the line feature code in the text box provided, if multiple line features have to be imported then multiple feature codes can be provided by comma separator. 
Note: The feature code text box is highlighted only when you select Feat Code in the import method 


Object ID's [comma delimited] 
: Specify the Object ID in the text box provided, if multiple line objects have to be imported then multiple Object ID's  can be provided by comma separator. 
Note: The Object ID's text box is highlighted only when you select Object ID in the import method 


Area Feature Import
:

Import Method: Allows to choose the required import method.

All : Imports with all details like Feature code, Object ID etc.

Object ID : Imports the line feature with specified Object ID.

Feat Code : Imports the line feature with specified Feature Code.

None : Does not Import the line feature.

Feature Code's [comma delimited]  : Specify the area feature code in the text box provided, if multiple area features have to be imported then multiple feature codes can be provided by comma separator. 
Note: The feature code text box is highlighted only when you select Feat Code in the import method 


Object ID's [comma delimited] 
: Specify the Object ID in the text box provided, if multiple area objects have to be imported then multiple Object ID's  can be provided by comma separator. 
Note: The Object ID's text box is highlighted only when you select Object ID in the import method 


Conversion Feature Import Method : Allows to choose the required conversion feature method.

All : Imports with all Features like Point, Line, Area, Complex.

Point : Imports only point feature.

Line : Imports only line feature.

Complex : Imports only complex feature.

None : Imports no Conversion feature.


Complex Features Import Method:
Allows to choose the required import method.

All : Imports with all details like Feature code, Object ID etc.

Object ID : Imports the line feature with specified Object ID.

Feat Code : Imports the line feature with specified Feature Code.

None : Does not Import any Complex Features.


Relationships Record Import Method:
Allows to choose the required import method.

All : Imports with all details like Feature code, Object ID etc.

Object ID : Imports the line feature with specified Object ID.

Feat Code : Imports the line feature with specified Feature Code.

None : Does not Import any relationship features.

Miscellaneous

Annotation Text Height : Specify the required text height the the text box provided.

Trace Report GDF Linkages : Check this box to trace the GDF linkages.

Create Individual Edges of LINE Features : Checking this box creates individual edges of LINE feature.

Create Individual Edges of AREA Features : Checking this box creates individual edges of AREA feature.
.
Label GDF Objects : Checking this box labels all the GDF objects.

Import Relationship Record Data : Checking this box imports the relationship record data. With selected relationship method.
 
Import GDF into memory only (do not draw in AutoCAD): Checking this box causes the GDF data to be imported and stored in transient  memory only. No AutoCAD entities will be created during the import. This option is especially useful to reduce processing time and system resources while dealing with large GDF data-sets wherein you only would like to import the data into memory and query only selected objects from memory using commands like IG_PNTQUERY, IG_LINEQUERY, IG_AREAQUERY etc (see below for explanation of these commands).

OK : Click on OK button to import the GDF file with specified parameters.

Note: When you are Importing the GDF file, the program will need to parse through the entire GDF file and build the data structure in memory. When you run this command, the program will display a message box as shown below, asking you whether you want to parse the GDF file or not. If you are sure that the GDF input file is alerady parsed and in-memory, click on the Yes button, else click on the No button to use the information from memory.


Menu : GeoTools GDF Viewer Draw/Query GDF Point Feature
Command line : IG_PNTQUERY 
The IG_PNTQUERY command is used to draw and query a GDF point feature from memory. This command works on the memory-built list of  GDF Point features and helps you to select and view/query/draw  a specific point feature.

Analyze/query a point feature:
Enter Point Feature ID to draw/query [ or 'S' to select from list] <>:
(do so)


Menu : GeoTools GDF Viewer Draw/Query GDF Line Feature
Command line : IG_LINEQUERY
The IG_LINEQUERY command is used to draw and query a GDF line feature from memory. This command works on the memory-built list of  GDF Line features and helps you to select and view/query/draw a specific line feature.

Draw/Analyze/query a line feature:
Enter Line Feature ID to draw/query [ or 'S' to select from list] <>:
(do so)


Menu : GeoTools GDF Viewer Draw/Query GDF Area Feature
Command line : IG_AREAQUERY
The IG_AREAQUERY command is used to draw and query a GDF area feature from memory. This command works on the memory-built list of  GDF Area features and helps you to select and view/query/draw  a specific area feature.

Draw/Analyze/query an area feature:
Enter Area Feature ID to draw/query [ or 'S' to select from list] <>: 
(do so)


Menu : GeoTools GDF Viewer Draw/Query GDF Complex Features
Command line : IG_COMPQUERY
The IG_COMPQUERY command is used to draw and query a GDF complext feature from memory. This command works on the memory-built list of  GDF Complex features and helps you to select and view/query/draw  a specific complex feature.

Draw/Analyze/query a complex feature:
Enter Complex Feature ID to draw/query [ or 'S' to select from list] <>: 
(do so)



Menu : GeoTools GDF Viewer Draw/Query GDF Relationship Features
Command line : IG_RELQUERY 
The IG_RELQUERY command is used to draw and query a GDF Relationship feature from memory. This command works on the memory-built list of  GDF Relationship features and helps you to select and view/query/draw  a specific relationship feature.

Draw/Analyze/query a Relationship feature:
Enter Relationship Feature ID to draw/query [ or 'S' to select from list] <>: 
(do so)


Menu : GeoTools GDF Viewer View GDF data
Command line : IG_VIEWGDF
The IG_VIEWGDF command is used to view complete GDF information from a selected AutoCAD object. the detail information of selected object like Point feature, Line feature or Area feature. For example a Point feature is selected from the .GDF file shows the following information.

The screen dumps below show typical information that is produced from a query / view of Point, Line and Area GDF Features.

Command: ig_viewgdf

Select object to query:
Point Feature
--------------------------------------------------------
ObjectType = Point
---------------------------------------------
GDF POINT Id = 2206
GDF FEATURE Code = 8040
Number of GDF Nodes =1
GDF NODE ID : 2231
GDF XYZ ID: 4980, Number of points stored=1

There are 1 segmented attribute ID's attached to this Point Feature
-----------------------------------------------------------------
Segmented Attribute ID = 3036

Building Name(BN): FoodWorld SuperMarket
City(CT): Bangalore
Country(CN): India
State (ST): Karnataka
Point Feature Code(FD): Others
BDA Building Number(B#): 568932G

Command: ig_viewgdf

Select object to query:
Line Feature
--------------------------------------------------------
ObjectType = Line
---------------------------------------------
GDF LINE Id = 2077
GDF FEATURE Code = 4110
from GDF NODE ID : 698
to GDF NODE ID : 1687

Number of GDF EDGE's = 1
GDF EDGE ID : 2077
(edge)from GDF NODE ID : 698
(edge)to GDF NODE ID : 1687
(edge) GDF XYZID : 3763, number of points = 6

There are 1 segmented attribute ID's attached to this Line Feature
-----------------------------------------------------------------
Segmented Attribute ID = 2077

Official Name(ON): CMH Road
Alternate Name(AN): 100 feet Road
Area Name(AR): Indirangar
Functional Road Class(FC): Commerical
Carriageway(CW): Dual Carriageway
Surface Type(SF): Asphalt
Number of lanes(NL): 2
Direction of Traffic Flow(DF): Two-Way
Length of segment(LN): 3399
 

Command: ig_viewgdf

Select object to query:
Area Feature
--------------------------------------------------------
ObjectType = Area
---------------------------------------------
GDF AREA Id = 1505
GDF FEATURE Code = 7121

Number of GDF FACE's =1
GDF FaceId = 1505
Number of GDF Edges = 1
GDF EdgeId = 4239, EdgeOrient = 0
(from) Node = 3134
(from) Node = 3134
GDF XYZId = 7547, Number of points = 35

There are 1 segmented attribute ID's attached to this Area Feature
-----------------------------------------------------------------
Segmented Attribute ID = 4671

City(CT): Bangalore
Country(CN): India
Land Use class(LC): Residential
State Name(SN): Karnataka
Area Name(AR): Indiranagar


Menu : GeoTools GDF Viewer Extract Section
Command line : IG_SECTEXTRACT
The IG_SECTEXTRACT command is used to extract the data section wise from a very large GDF file. And each section is stored as a separate file. This is will be useful when you want to work on some part of data from the very large GDF file. The command has the following syntax and command sequence.

Command: IG_SECTEXTRACT
Enter master GDF file-name(~ for list) <F:\Projects\GDFViewer\UC2\UC2.gdf>: Type ? mark, this will pop-up a dialog box which prompts you to select the .GDF file

Extract which sections? [ Selected/All ] <All>: Type All, this will read the data section wise from the .GDF file and writes each section in the form of a separate file
.  


Menu : GeoTools GDF Viewer Search GDF file
Command line : IG_SEARCHGDF
The IG_SEARCHGDF command is used to search a selection of AutoCAD objects for a matching GDF record.

IG_SEARCHGDF
Search for GDF object type: [ Point/Line/Area ] <Point>: (do so)

Select objects to search:
Select objects: Specify opposite corner: 1503 found
807 were filtered out.

Select objects:

Enter Object ID to search and zoom to: <1889>:

Object was found. '#ename' Lisp variable exposed

Object placed in active [previous] selection.


Menu : GeoTools GDF Viewer   Compare GDF files
Command line : IG_GDFCOMPARE
The IG_GDFCOMPARE command is used to compare two .gdf files of different variants. It basically compares the record names and structure of two .gdf files, and generates a report of unmatched values the report is stored in a separate file with extension .rpt. The command has the following syntax and command sequence.

Command: IG_GDFCompare
Enter first GDF file-name(~ for list) <F:\Projects\GDFViewer\TeleAtlas.gdf>: Type ? mark, this will pop-up a dialog box which prompts you to select the .GDF file

Enter second GDF file-name(~ for list) <F:\Projects\GDFViewer\TeleAtlas2.gdf>: Type ? mark, this will pop-up a dialog box which prompts you to select the .GDF file

Enter GDF compare report file-name(~ for list) <F:\Projects\Sanjay\Compare_GDF.rpt>:Type ? mark, this will pop-up a dialog box which prompts you to specify the path for storing the report file.
 

Prev: Animation Tools

Table of Contents

Next: Installation