Index   |   map > private > read_gmt.m
<<  ppunit recpar  >>
read_gmt
PURPOSE ^
READ_GMT Read GMT-Data from binned NetCDF-Files
SYNOPSIS ^
function [xy,lv] = read_gmt(file,varargin)
DESCRIPTION ^
 READ_GMT   Read GMT-Data from binned NetCDF-Files

 XY = READ_GMT( File , Area )

   Area:  Area, for wich Data are to Extract:
          [ LonMin LonMax  LatMin  LatMax ]

   XY:   Lines: [ Lon  Lat ] 
         (2 Columns, Lines separated by NaN)

 [ XY , Level ] = READ_GMT( File , Area , Levels )

  Returns only Lines with specified Levels, see below

 To use a ShortName for the File, use up to 3 Letters, specifies one
  of the DataTypes, the Resolution and the Level, descripted below.

 Example:  File = 'sh'  == Shore, High Resolution == binned_shore_h.cdf  
           File = 'sh2' == Shore, High Resolution, Level 2

 Special Feature of SquareKilometers of Feature for ShoreLines:

 [ XY , Level+i*SquareKilometer ] = READ_GMT( File , ... , +MinSkm*i )
 [ XY , Level+i*SquareKilometer ] = READ_GMT( File , ... , -MaxSkm*i )

 [ XY , Level+i*SquareKilometer ] = READ_GMT( File , ... , [Min Max]Skm*i )

  Returns only Lines with a Minimum/Maximum Value of 0.1*SquareKilometers,
    only valid for  Shore-(Coast)-LineData
  Note: A single ZERO-Number is also accepted, 
        the Area of the parent Segment is returned.


 see also:  LOOK_CDF (required), SHORE_GMT, WRT_GMT, GEBCO_WVS

**********************************************************************
 Description of GMT-DataBase

----------------------------------------------------------------------
 DataTypes:
                                  File
  s = Shore                    == binned_shore_#.cdf
  c = Coast (equal to shore)
  r = River                    == binned_river_#.cdf
  b = Boundaries               == binned_border_#.cdf
  t = Tectonics                == binned_tectonic_#.cdf


----------------------------------------------------------------------
 Resolutions "#" for DataTypes:
                                 Scale         Resolution at Eq.
  f = Full                  ==  1 :    100,000     100m
  h = High                  ==  1 :  1,000,000    1000m
  i = Intermediate          ==  1 :  3,000,000    3000m
  l = Low                   ==  1 : 10,000,000   10000m
  c = Crude                 ==  1 : 30,000,000   30000m


----------------------------------------------------------------------
 River Levels:

  1 = Permanent major rivers
  2 = Additional major rivers
  3 = Additional rivers
  4 = Minor rivers
  5 = Intermittent rivers - major
  6 = Intermittent rivers - additional
  7 = Intermittent rivers - minor
  8 = Major canals
  9 = Minor canals
 10 = Irrigation canals

  You can also use the following Letters in the ShortName for DataType:

  r = All permanent rivers (1-4)
  i = All intermittent rivers (5-7)
  c = All canals (8-10)

  Example:  File = 'rhc' == River, High Resolution, All canals
            File = 'rh1' == River, High Resolution, Permanent major rivers
            File = 'rh0' == River, High Resolution, Irrigation canals


----------------------------------------------------------------------
 CoastLine Levels:

   1 = WVS   land/ocean
   2 = WDBII land/lake
   3 = WDBII lake/island-in-lake
   4 = WDBII island-in-lake/lake-in-island-in-lake


----------------------------------------------------------------------
 Boundary Levels:

   1 = National boundaries
   2 = State boundaries within the Americas
   3 = Marine boundaries


----------------------------------------------------------------------
 Tectonic Levels:

    1 = Ridges
    2 = Trenches
    3 = Transform zones
    4 = Fracture zones
    5 = Magnetic lineations
    6 = Hotspots locations


DOWNLOAD M-File ^
21.1 KByte
CROSS-REFERENCE INFORMATION ^
This function calls:
CHKSTR Checks Input for String
GRP2IND Built IndexVector from StartIndex and Length
LOOK_CDF Reads Basic Informations from a CDF-File
NCMEX Driver for NetCDF C-Language interface.
STRHCAT Concatenates Strings into ONE
This function is called by:
SUBFUNCTIONS ^
 
 
 
 
 
 


Generated on Sat 09-May-2009 10:46:59 by m2html © 2003, Revision by Ch.Begler 2008
^