dcwrhead - Read DCW worldwide basemap file headers

Syntax

dcwrhead dcwrhead(filepath,filename) dcwrhead(filepath,filename,fid) dcwrhead(...) str = dcwrhead(...)

Description

dcwrhead allows the user to select the header file interactively.

dcwrhead(filepath,filename) reads from the specified file. The combination [filepath filename] must form a valid complete filename.

dcwrhead(filepath,filename,fid) reads from the already open file associated with fid.

dcwrhead(...) with no output arguments displays the formatted header information on the screen.

str = dcwrhead(...) returns a string containing the DCW header.

Background

The Digital Chart of the World (DCW) uses header strings in most files to document the contents and format of that file. This function reads the header string, displays a formatted version in the command window, or returns it as a string.

Remarks

This function reads all DCW files except index files (files with names ending in 'X'), thematic index files (files with names ending in 'TI'), and spatial index files (files with names ending in 'SI').

File separators are platform dependent. The filepath input must use appropriate file separators, which you can determine using the MATLAB filesep function.

Examples

The following example uses the Macintosh file separators and pathname:

dcwrhead('NOAMER:DCW:NOAMER:AE:','AEPOINT.PFT')
Aeronautical Points
AEPOINT.DOC
ID=I,		 1,P,Row Identifier,-,-,
AEPTTYPE=I,	 1,N,Airport Type,INT.VDT,-,
AEPTNAME=T,	50,N,Airport Name,-,-,
AEPTVAL=I,	 1,N,Airport Elevation Value,-,-,
AEPTDATE=D,	 1,N,Aeronautical Information Date,-,-,
AEPTICAO=T,	 4,N,International Civil Organization Number,-,-,
AEPTDKEY=T,	 7,N,DAFIF Reference Number,-,-,
TILE_ID=S,	 1,F,Tile Reference Identifier,-,AEPOINT.PTI,
END_ID=I	 1,F,Entity Node Primitive Foreign Key,-,-,

s = dcwrhead('NOAMER:DCW:NOAMER:AE:','AEPOINT.PFT')
s =
;Aeronautical Points;AEPOINT.DOC;ID=I,		 1,P,Row 
Identifier,-,-,:AEPTTYPE=I,	 1,N,Airport 
Type,INT.VDT,-,:AEPTNAME=T,	50,N,Airport Name,-,-,:AEPTVAL=I,	 
1,N,Airport Elevation Value,-,-,:AEPTDATE=D,	 1,N,Aeronautical 
Information Date,-,-,:AEPTICAO=T,	 4,N,International Civil 
Organization Number,-,-,:AEPTDKEY=T,	 7,N,DAFIF Reference 
Number,-,-,:TILE_ID=S,	 1,F,Tile Reference 
Identifier,-,AEPOINT.PTI,:END_ID=I	 1,F,Entity Node Primitive 
Foreign Key,-,-,:;