Mapping Toolbox

dcwgaz

Search for entries in the Digital Chart of the World gazette

Syntax

• dcwgaz(library,object)
  dcwgaz(devicename,library,object)
  mtextstruc = dcwgaz(...)
  [mtextstruc,mpointstruc] = dcwgaz(...)
  

Background

In addition to the geographic data, the Digital Chart of the World (DCW) also includes an extensive gazette feature. The gazette is a collection of the names of geographic items mentioned in the various themes of a DCW disk. One DCW disk may contain about 10,000 to 15,000 names. This function allows the gazette to be searched for names beginning with a particular string.

Description

dcwgaz(library,object) searches the DCW library for items beginning with the object string. There are four CDs, one for each of the libraries: 'NOAMER' (North America), 'SASAUS' (Southern Asia and Australia), 'EURNASIA' (Europe and Northern Asia), and 'SOAMAFR' (South America and Africa). Items which exactly match or begin with the object string are displayed on screen.

dcwgaz(devicename,library,object) specifies the logical device name of the CD-ROM for computers which do not automatically name the mounted disk.

mtextstruc = dcwgaz(...) displays the matched items on screen and returns a Mapping Toolbox geographic data structure with the matches as text entries.

[mtextstruc,mpointstruc] = dcwgaz(...) returns the matches in structures formatted both as text and as points.

Remarks

The search is not case sensitive. Items that match are those that begin with the object string. Spaces are significant.

Examples

On the Macintosh:

• s = dcwgaz('EURNASIA','apatin')
  APATIN
  s = 
               type: 'text'
      otherproperty: {1x2 cell}
                tag: 'Built up area'
             string: 'APATIN'
           altitude: []
                lat: 45.6660
               long: 18.9830
  

On a UNIX operating system with the CD-ROM mounted as '\cdrom':

• [mtextstruc,mpointstruc] = dcwgaz('\cdrom','SOAMAFR',...
      'cape good')
  Cape Goodenough
  Cape Goodenough
  Cape Goodenough
  mtextstruc = 
  1x3 struct array with fields:
      type
      otherproperty
      tag
      string
      altitude
      lat
      long
  mpointstruc = 
  1x3 struct array with fields:
      type
      otherproperty
      tag
      string
      altitude
      lat
      long
  

See Also

dcwdata	Read selected data from the Digital Chart of the World
dcwread	Read a Digital Chart of the World file
dcwrhead	Read a Digital Chart of the World file header
displaym	Project data contained in a map structure
mlayers	GUI for manipulating map layers

dcwdata

dcwread