Mapping Toolbox™

dcwdata - Read selected DCW worldwide basemap data

Syntax

struct = dcwdata(library,latlim,lonlim,theme,topolevel) struct = dcwdata(devicename,library,...) [struct1, struct2,...] = dcwdata(...,{topolevel1,topolevel2,...})

struct = dcwdata(library,latlim,lonlim,theme,topolevel) reads data for the specified theme and topology level directly from the DCW CD-ROM. 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). The desired theme is specified by a two-letter code string. A list of valid codes is displayed when an invalid code, such as '?', is entered. The region of interest can be given as a point latitude and longitude or as a region with two-element vectors of latitude and longitude limits. The units of latitude and longitude are degrees. The data covering the requested region is returned, but will include data extending to the edges of the 5-by-5 degree tiles. The result is returned as a Version 1 Mapping Toolbox™ display structure.

struct = dcwdata(devicename,library,...) specifies the logical device name of the CD-ROM for computers that do not automatically name the mounted disk.

[struct1, struct2,...] = dcwdata(...,{topolevel1,topolevel2,...}) reads several topology levels. The levels must be specified as a cell array with the entries 'patch', 'line', 'point', or 'text'. Entering {'all'} for the topology level argument is equivalent to {'patch', 'line', 'point', 'text'}. Upon output, the data structures are returned in the output arguments by topology level in the same order as they were requested.

Background

The Digital Chart of the World (DCW) is a detailed and comprehensive source of publicly available global vector data. It was digitized from the Operational Navigation Charts (scale 1:1,000,000) and Jet Navigation Charts (1:2,000,000), compiled by the U.S. Defense Mapping Agency (DMA) along with mapping agencies in Australia, Canada, and the United Kingdom. The digitized data was published on four CD-ROMS by the DMA and is distributed by the U.S. Geological Survey (USGS).

The DCW is out of print and has been succeeded by the Vector Map Level 0 (VMAP0).

The DCW organizes data into 17 different themes, such as political/oceans (PO), drainage (DN), roads (RD), or populated places (PP). The data is further tiled into 5-by-5 degree tiles and separated by topology level (patches, lines, points, and text).

Remarks

Latitudes and longitudes use WGS84 as a horizontal datum. Elevations are in feet above mean sea level. The data set does not contain bathymetric data.

Some DCW themes do not contain all topology levels. In those cases, empty matrices are returned.

The data is tagged with strings describing the objects. Some data is provided with alternate tags in tag2 and tag3 fields. These alternate tags contain information that supplements the standard tag, such as the names of political entities or values of elevation. The tag2 field generally has the actual values or codes associated with the data. If the information in the tag2 field expands to more verbose descriptions, these are provided in the tag3 field.

Point data for which there are descriptions of both the type and the individual names of objects is returned twice within the structure. The first set is a collection of points of the same type with appropriate tag. The second is a set of individual points with the tag 'Individual Points' and the name of the object in the tag2 field.

Patches are broken at the tile boundaries. Setting the EdgeColor to 'none' and plotting the lines gives the map a normal appearance.

The DCW was published in 1992 based on data compiled some years earlier. The political boundaries do not reflect recent changes such as the dissolution of the Soviet Union, Czechoslovakia, and Yugoslavia. In some cases, the boundaries of the successor nations are present as lower level political units. A new version, called VMAP0.

For information about the format of display structures, see Version 1 Display Structures in the reference page for displaym.

Examples

On a Macintosh^® computer,

s = dcwdata('NOAMER',41,-69,'?','patch');

??? Error using ==> dcwdata
Theme not present in library NOAMER
Valid two-letter theme identifiers are: 
PO: Political/Oceans        
PP: Populated Places        
LC: Land Cover              
VG: Vegetation              
RD: Roads                   
RR: Railroads               
UT: Utilities               
AE: Aeronautical            
DQ: Data Quality            
DN: Drainage                
DS: Supplemental Drainage   
HY: Hypsography             
HS: Supplemental Hypsography
CL: Cultural Landmarks      
OF: Ocean Features          
PH: Physiography            
TS: Transportation Structure
POpatch = dcwdata('NOAMER',[41 44],[-72 -69],'PO','patch')
POpatch = 
1x234 struct array with fields:
    type
    otherproperty
    tag
    altitude
    lat
    long
    tag2
    tag3

On an MS-DOS based operating system with the CD-ROM as the 'd:' drive,

[RDtext,RDline] = dcwdata('d:','SASAUS',[-48 -34],[164 180],...
     'RD',{'text','line'});

On a UNIX^® operating system with the CD-ROM mounted as '\cdrom',

[POpatch,POline,POpoint,POtext] = dcwdata('\cdrom',...
     'EURNASIA',-48 ,164,'PO',{'all'});

References