GISInverseProj


Synopsis

inputs a data array of projected (x,y,z) tuplets and output a array of latitude, longitude, and altitude coordinates after performing an inverse map projection

Input Ports

inXYZ

Data_Array

InverseTransform

string

GlobalRadius

double

baseLat

double

baseLon

double

firstPar

double

secondPar

double

 

Output Ports

outLLA

Data_Array

InverseTransform

string

GlobalRadius

double

baseLat

double

baseLon

double

firstPar

double

secondPar

double

 

Description

GISInverseProj takes an n x 3 Data_Array of (x,y,z) coordinates and performs an inverse mapping transformation to produce an n x 3 array of latitude, longitude, altitude tuplets representing the original coordinates from the projected spherical surface. The mapping transformation is such that

f ( x j , y j , z j ) = ( lon j , lat j , alt j )

where j runs from 1 to n.

The mapping transform is specified by user string input to the InverseTransform input port. Currently, only several common map inverse transforms are available; those transforms are explained in Transforms .

Input Ports

inXYZ

Data_Array. A port which allows another network component to provide (x,y,z) tuplet information as a Data_Array.

InverseTransform

String. A string specifying the map transformation to be performed on the input data set. The allowed map transforms are listed here, and explained in Transforms :

Cartesian

Mercator

Lambert Cylindrical

Stereographic

Orthographic

Lambert Azimuthal

Lambert Conic Conformal

Albers

Globe

GlobalRadius

Double. Several map transformations need access to pieces of information about the space they are projecting into, one of which is the distance from the projection surface to the center of the projection. As these map transformation do their work in three dimensions, the coordinate tuplet (0,0,0) is at the center of the projection space. The GlobalRadius value is the number of units from the surface of the projection to (0,0,0). This value is initially set to 6,378,000 meters, the average distance from the surface of the earth to the center of the earth.

This value can be changed to any non-zero value, but keep in mind that the units represented in this value are the units that will be used throughout the projection network. (e.g. if the value is changed to 6,378 kilometers, all coordinate output from the projection module will be in units of a kilometer.)

baseLat
baseLon

Double. Another piece of information that needs to be provided to most map transformations is the center of projection. This is a fixed point on the surface of the projection that becomes the geometric center of the projection. Typically, the base latitude and longitude is defined as the point that cartographer wants to be the least distorted. The default for baseLat and baseLon are the coordinates for Boston, Massachusetts.

firstPar
secondParallel

Double. On conic projections, the map projection is performed by mapping the coordinates onto the surface of a cone. The size and shape of the cone can be forced to be conceptually secant at two parallels. The resulting projection has distances preserved at these parallels. As conic projections tend to distort distances wildly as you approach either pole (+/- 90 o ), projections of high latitude areas are corrected by adjusting the first and second parallels. Navigational maps used in Alaska, for example, have the first and second parallels set to 55 o and 65 o . This produces a relatively distortion free projection of the state.

Output Ports

outLLA

Data_Array. An output port where another module can obtain a Data_Array of the inverse projected latitude, longitude and altitude values.

Transform
baseLat
baseLon
firstPar
secondPar

String. These ports correspond exactly to the corresponding input ports. They are provided merely as a convenience for passing parameter information to other modules.

Transforms

The GIS tools in AVS/Express do not include all available map transformations, only common transformations that are used widely in various industries for cartographic purposes, and map transformations that are of historical interest. This section discusses each of the map transformation available via the GISInverseProj module. For a reference for map transformation equations that were used in designing this module, please see Map Projections Used by the U.S. Geological Survey, Geological Survey Bulletin 1532 by John P. Snyder.

Projection Classification: Sphere

A spherical map transformation is the only true 1-1 mapping of positions on a spherical body to corresponding positions on a representation Parallels are parallel and equally spaced along the meridians. Meridians and other arcs of the great circles are straight lines. Meridians properly converge towards the poles and are spaced the same as parallels at the equator. On spherical projections, the shortest distance between any two surface points is a great circle.

Spherical Transforms Provided with GISInverseProj: