dcwgaz - Search DCW worldwide basemap gazette file

Syntax

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

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 that 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 that do not automatically name the mounted disk.

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

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

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 can contain about 10,000 to 15,000 names. This function allows you to search the gazette for names beginning with a particular string.

Remarks

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

Examples

On a Macintosh computer,

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