intrinsicToGeographic

Transform intrinsic to geographic coordinates

Description

example

[lat,lon] = intrinsicToGeographic(R,xIntrinsic,yIntrinsic) returns the geographic coordinates corresponding to intrinsic coordinates (xIntrinsic, yIntrinsic) in geographic raster R.

Examples

collapse all

Find the geographic coordinates of cells within a raster by specifying a raster reference object and intrinsic coordinates.

First, load a geographic cells reference object for the Korean peninsula. To do this, load the korea5cR variable from the korea5c MAT-file. Then, specify the intrinsic coordinates of the cell in the lower-left corner. For this example, the lower-left corner is also the southwest corner because the ColumnsStartFrom property of the reference object has a value of 'south' and the RowsStartFrom property has a value of 'west'. Integer coordinates such as (1,1) indicate the center of a cell.

xIntrinsic = 1;
yIntrinsic = 1;

Find the geographic coordinates.

[lat,lon] = intrinsicToGeographic(korea5cR,xIntrinsic,yIntrinsic)
lat = 30.0417
lon = 115.0417

You can reverse the operation by using the geographicToIntrinsic function.

[xIntrinsic,yIntrinsic] = geographicToIntrinsic(korea5cR,lat,lon)
xIntrinsic = 1.0000
yIntrinsic = 1.0000

Input Arguments

collapse all

Geographic raster, specified as a GeographicCellsReference or GeographicPostingsReference object.

x-coordinates in intrinsic coordinate system, specified as a numeric array. xIntrinsic coordinates can be outside the bounds of the raster R.

Data Types: single | double

y-coordinates in intrinsic coordinate system, specified as a numeric array. yIntrinsic is the same size as xIntrinsic. yIntrinsic coordinates can be outside the bounds of the raster R.

Data Types: single | double

Output Arguments

collapse all

Latitude coordinates, returned as a numeric array. lat is the same size as xIntrinsic.

When a point (xIntrinsic(k), yIntrinsic(k)) is outside the bounds of raster R, lat(k) and lon(k) are extrapolated in the geographic coordinate system. However, for any point that extrapolates to a latitude beyond the poles (latitude outside the range [-90, 90] degrees), lat(k) and lon(k) are set to NaN.

Data Types: double

Longitude coordinates, returned as a numeric array. lon is the same size as xIntrinsic.

When a point (xIntrinsic(k), yIntrinsic(k)) is outside the bounds of raster R, lat(k) and lon(k) are extrapolated in the geographic coordinate system. However, for any point that extrapolates to a latitude beyond the poles (latitude outside the range [-90, 90] degrees), lat(k) and lon(k) are set to NaN.

Data Types: double 