Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

dcwread

Read DCW worldwide basemap file

dcwread will be removed in a future release. The VMAP0 dataset has replaced DCW and can be read using vmap0read.

Syntax

dcwread(filepath,filename)
dcwread(filepath,filename,recordIDs)
dcwread(filepath,filename,recordIDs,field,varlen)
struc = dcwread(...)
[struc,field] = dcwread(...)
[struc,field,varlen] = dcwread(...)
[struc,field,varlen,description] = dcwread(...)
[struc,field,varlen,description,narrativefield] = dcwread(...)

Description

dcwread reads a DCW file. The user selects the file interactively.

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

dcwread(filepath,filename,recordIDs) reads selected records or fields from the file. If recordIDs is a scalar or a vector of integers, the function returns the selected records. If recordIDs is a cell array of integers, all records of the associated fields are returned.

dcwread(filepath,filename,recordIDs,field,varlen) uses previously read field and variable-length record information to skip parsing the file header (see below).

struc = dcwread(...) returns the file contents in a structure.

[struc,field] = dcwread(...) returns the file contents and a structure describing the format of the file.

[struc,field,varlen] = dcwread(...) also returns a vector describing the fields that have variable-length records.

[struc,field,varlen,description] = dcwread(...) also returns, description, a character vector that describes the contents of the file.

[struc,field,varlen,description,narrativefield] = dcwread(...) also returns the name of the narrative file for the current file.

Background

The Digital Chart of the World (DCW) uses binary files in a variety of formats. This function determines the format of the file and returns the contents in a structure. The field names of this structure are the same as the field names in the DCW file.

Examples

The following examples use the Macintosh directory system and file separators for the pathname:

s = dcwread('NOAMER:DCW:NOAMER:','GRT')
s = 
                  ID: 1
           DATA_TYPE: 'GEO'
               UNITS: '014'
           ELLIPSOID: 'WGS 84'
    ELLIPSOID_DETAIL: 'A=6378137,B=6356752 Meters'
      VERT_DATUM_REF: 'MEAN SEA LEVEL'
     VERT_DATUM_CODE: '015'
         SOUND_DATUM: 'MEAN SEA LEVEL'
    SOUND_DATUM_CODE: '015'
      GEO_DATUM_NAME: 'WGS 84'
      GEO_DATUM_CODE: 'WGE'
     PROJECTION_NAME: 'DECIMAL DEGREES'

s = dcwread('NOAMER:DCW:NOAMER:AE:','INT.VDT')
s = 
5x1 struct array with fields:
    ID
    TABLE
    ATTRIBUTE
    VALUE
    DESCRIPTION
for i = 1:length(s); disp(s(i)); end
             ID: 1
          TABLE: 'AEPOINT.PFT'
      ATTRIBUTE: 'AEPTTYPE'
          VALUE: 1
    DESCRIPTION: 'Active civil'

             ID: 2
          TABLE: 'AEPOINT.PFT'
      ATTRIBUTE: 'AEPTTYPE'
          VALUE: 2
    DESCRIPTION: 'Active civil and military'
			ID: 3
          TABLE: 'AEPOINT.PFT'
      ATTRIBUTE: 'AEPTTYPE'
          VALUE: 3
    DESCRIPTION: 'Active military'

             ID: 4
          TABLE: 'AEPOINT.PFT'
      ATTRIBUTE: 'AEPTTYPE'
          VALUE: 4
    DESCRIPTION: 'Other'

             ID: 5
          TABLE: 'AEPOINT.PFT'
      ATTRIBUTE: 'AEPTTYPE'
          VALUE: 5
    DESCRIPTION: 'Added from ONC when not available from DAFIF'
s = dcwread('NOAMER:DCW:NOAMER:AE:','AEPOINT.PFT',1)
s = 
          ID: 1
    AEPTTYPE: 4
    AEPTNAME: 'THULE AIR BASE'
     AEPTVAL: 251
    AEPTDATE: '19900502000000000000'
    AEPTICAO: '1261'
    AEPTDKEY: 'BR17652'
     TILE_ID: 94
      END_ID: 1

s = dcwread('NOAMER:DCW:NOAMER:AE:','AEPOINT.PFT',{1,2})
s = 
4678x1 struct array with fields:
    ID
    AEPTTYPE

More About

collapse all

Tips

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 you can determine using the MATLAB® filesep function.

See Also

| |

Introduced before R2006a

Was this topic helpful?