Mapping Toolbox

dcwrhead

Read the header of a Digital Chart of the World file

Syntax

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

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.

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.

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 may be determined using the MATLAB filesep function.

Examples

The following example uses the Macintosh file separators and path name:

• 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,-,-,:;
  

See Also

dcwdata	Read selected data from the Digital Chart of the World
dcwgaz	Search for entries in the Digital Chart of the World gazette
dcwread	Read a Digital Chart of the World file

dcwread

demdataui