read geo

From DavinciWiki
Jump to: navigation, search

Description

Read the data and metadata from a Geo-Aware file. This function relies on GDAL > 1.8.

This function nominally supports all formats GDAL can read, though it uses the native davinci reader first before trying GDAL.

Arguments and Return Values

Arguments: File name

Return Value: A davinci Geo-Struct with the data

Usage

Syntax: read_geo(filename [,data=BOOL][,struct=BOOL][,raw=BOOL][,subdata=INT][,band=INT])

filename - input full path to data

data - return the data (Default=1)

struct - return the struct (Default=1)

raw - return the raw gdalinfo (Default=0)

subdata-specify the number of the subdataset to read (Default is -32768). If none is specified it will be treated as if there are no subdatasets. If subdatasets exist and a subdata # is not specified the list of subdatasets is returned

band - read only the specified band 0=All (Default=0)

Examples

dv> a=read_geo($DV_EX+"/I01001001.cub")
Downloading...........................................done.
   anc: struct, 11 elements
       wkt: Text Buffer with 12 lines of text
           1: PROJCS["SIMPLE_CYLINDRICAL MARS",
           2:     GEOGCS["GCS_MARS",
           3:         DATUM["D_MARS",
           4:             SPHEROID["MARS",3396190,0]],
           5:         PRIMEM["Reference_Meridian",0],
           6:         UNIT["degree",0.0174532925199433]],
           7:     PROJECTION["Equirectangular"],
           8:     PARAMETER["latitude_of_origin",0],
           9:     PARAMETER["central_meridian",0],
           10:     PARAMETER["standard_parallel_1",0],
       proj4: "'+proj=eqc +lat_ts=0 +lat_0=0 +lon_0=0 +x_0=0 +y_0=0 +a=3396190 +b=3396190 +units=m +no_defs '"
       origin: 1x2x1 array of double, bsq format [16 bytes]
       pixel_size: 1x2x1 array of double, bsq format [16 bytes]
       x: 186699.0000
       y: -3541.000000
       lat: 1x5x1 array of float, bsq format [20 bytes]
       lon: 1x5x1 array of float, bsq format [20 bytes]
       lpo: 1x5x1 array of float, bsq format [20 bytes]
       spo: 1x5x1 array of float, bsq format [20 bytes]
       center: 2x1x1 array of float, bsq format [8 bytes]
   ignore: -3.402822655e+38
   projection: "Equirectangular"
   spheroid: struct, 3 elements
       name: "MARS"
       radius: "3396190"
       iflattening: "0"
   resolution: 100.0000000
   x: 186699.0000
   y: -3541.000000
   ul: 2x1x1 array of float, bsq format [8 bytes]
   ur: 2x1x1 array of float, bsq format [8 bytes]
   ll: 2x1x1 array of float, bsq format [8 bytes]
   lr: 2x1x1 array of float, bsq format [8 bytes]
   w: 661
   h: 2391
   data: 661x2391x10 array of float, bsq format [63,218,040 bytes]

DavinciWiki Mini-Nav Bar

Contents


Contact Developers

  • davinci-dev [AT] mars.asu.edu

All other topics

  • See navigation on the left

Major Sub-Functions

Recent Library Changes

Created On: 04-11-2013
Modified On: 07-29-2013

Personal tools