Mapping Toolbox

vmap0rhead

Read the header of a VMAP0 file

Syntax

• vmap0rhead
  vmap0rhead(filepath,filename)
  vmap0rhead(filepath,filename,fid)
  
  str = vmap0rhead(...)
  

Background

The Vector Map Level 0 (VMAP0) uses header strings in most files to document the contents and format of that file. This function reads the header string and displays a formatted version in the command window, or returns it as a string.

Description

vmap0rhead allows the user to select the header file interactively.

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

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

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

str = vmap0rhead(...) returns a string containing the VMAP0 header.

Remarks

This function reads all VMAP0 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 pathname:

• s = vmap0rhead('VMAP:VMAPLV0:NOAMER:','GRT')
  s =
  L;Geographic Reference Table;-;id=I,1,P,Row 
  Identifier,-,-,-,:data_type=T,3,N,Data 
  Type,-,-,-,:units=T,3,N,Units of Measure Code for 
  Library,-,-,-,:ellipsoid_name=T,15,N,Ellipsoid,-,-,-,:ellipsoid
  _detail=T,50,N,Ellipsoid 
  Details,-,-,-,:vert_datum_name=T,15,N,Datum Vertical 
  Reference,-,-,-,:vert_datum_code=T,3,N,Vertical Datum 
  Code,-,-,-,:sound_datum_name=T,15,N,Sounding 
  Datum,-,-,-,:sound_datum_code=T,3,N,Sounding Datum 
  Code,-,-,-,:geo_datum_name=T,15,N,Datum Geodetic 
  Name,-,-,-,:geo_datum_code=T,3,N,Datum Geodetic 
  Code,-,-,-,:projection_name=T,20,N,Projection Name,-,-,-,:;
  
  vmap0rhead('VMAP:VMAPLV0:NOAMER:TRANS:','AEROFACP.PFT')
  L
  Airport Point Feature Table
  aerofacp.doc
  id=I,1,P,Row Identifier,-,-,-,
  f_code=T,5,N,FACC Feature Code,char.vdt,-,-,
  iko=T,4,N,ICAO Designator,char.vdt,-,-,
  nam=T,*,N,Name,char.vdt,-,-,
  na3=T,*,N,Name,char.vdt,-,-,
  use=S,1,N,Usage,int.vdt,-,-,
  zv3=S,1,N,Airfield/Aerodrome Elevation (meters),int.vdt,-,-,
  tile_id=S,1,N,Tile Reference ID,-,tile1_id.pti,-,
  end_id=I,1,N,Entity Node Primitive ID,-,end1_id.pti,-,
  

See Also

vmap0data	Read selected data from the VMAP0
vmap0read	Read a VMAP0 file

vmap0read

vmap0ui