Proj4(3pm)

NAME
PDL::Transform::Proj4 - PDL::Transform interface to the Proj4 projection library

SYNOPSIS
 # Using the generalized proj interface:
 # Make an orthographic map of Earth
 use PDL::Transform::Cartography;
 use PDL::Transform::Proj4;
 $a = earth_coast();
 $a = graticule(10,2)->glue(1,$a);
 $t = t_proj( proj_params => "+proj=ortho +ellps=WGS84 +lon_0=-90 +lat_0=40" );
 $w = pgwin(xs);
 $w->lines($t->apply($a)->clean_lines());

 # Using the aliased functions:
 # Make an orthographic map of Earth
 use PDL::Transform::Cartography;
 use PDL::Transform::Proj4;
 $a = earth_coast();
 $a = graticule(10,2)->glue(1,$a);
 $t = t_proj_ortho( ellps => 'WGS84', lon_0 => -90, lat_0 => 40 )
 $w = pgwin(xs);
 $w->lines($t->apply($a)->clean_lines());

DESCRIPTION
Works like PDL::Transform::Cartography, but using the proj library in the background.

Please see the proj library docs at <http://www.remotesensing.org/proj> for more information on proj, and how to use the library.

GENERALIZED INTERFACE
The main object here is the PDL::Transform::Proj4 object, aliased to the t_proj() function.

This object accepts all of the standard options described below, but mainly is there to be called with just the proj_params option defined.

When options are used, they must be used with a '+' before them when placed in the proj_params string, but that is not required otherwise. See the SYNOPSIS above.

  ALIASED INTERFACE
Other than t_proj(), all of the other transforms below have been autogenerated, and may not work properly. The main problem is determining the parameters a projection requires from the proj library itself.

Due to the difficulties in doing this, there may be times when the proj docs specify a parameter for a projection that won't work using the anon-hash type specification. In that case, just throw that parameter in the proj_params string, and everything should work fine.

PARAMETERS AVAILABLE IN ALL PROJECTIONS

  General Parameters
proj_params

This is a string containing the proj "plus style" parameters. This would be similar to what you would put on the command line for the 'proj' tool. Like "+proj=ortho +ellps=WGS84 +lon_0=-90 +lat_0=40".

This parameter overrides the others below when it contains parameters that are also specified explicitly.

proj

The proj projection code to use (like ortho...)

x_0

Cartesian X offset for the output of the transformation

y_0

Cartesian Y offset for the output of the transformation

lat_0

Central latitude for the projection. NOTE: This may mean other things depending on the projection selected, read the proj docs!

lon_0

Central longitude for the projection. NOTE: This may mean other things depending on the projection selected, read the proj docs!

units

Cartesian units used for the output of the projection. NOTE: Like most of the options here, this is likely useless in the current implementation of this library.

init

Specify a file:unit for proj to use for its runtime defaults. See the proj docs.

no_defs

Don't load any defaults. See the proj docs.

over

Normally, the transformation limits the output to between -180 and 180 degrees (or the cartesian equivalent), but with this option that behavior is turned off.

geoc

Input values are geocentric coordinates.

  Earth Figure Parameters
ellps

Ellipsoid datum to use. Ex: WGS72, WGS74. See the proj docs and command line tool for list of possibilities ('proj -le').

R

Radius of the Earth.

R_A

Radius of a sphere with equivalent surface area of specified ellipse.

R_V

Radius of a sphere with equivalent volume of specified ellipse.

R_a

Arithmetic mean of the major and minor axis, Ra = (a + b)/2.

R_g

Geometric mean of the major and minor axis, Rg = (ab)1/2.

R_h

Harmonic mean of the major and minor axis, Rh = 2ab/(a + b).

R_lat_a=phi

Arithmetic mean of the principle radii at latitude phi.

R_lat_g=phi

Geometric mean of the principle radii at latitude phi.

b

Semiminor axis or polar radius

f

Flattening

rf

Reciprocal flattening, +rf=1/f

e

Eccentricity +e=e

es

Eccentricity squared +es=e2

FUNCTIONS

  t_proj
This is the main entry point for the generalized interface. See above on its usage.

  t_proj_aea
Autogenerated transformation function for Proj4 projection code aea.

The full name for this projection is Albers Equal Area.

Projection Parameters

lat_1
lat_2

  t_proj_aeqd
Autogenerated transformation function for Proj4 projection code aeqd.

The full name for this projection is Azimuthal Equidistant.

Projection Parameters

guam
lat_0

  t_proj_airy
Autogenerated transformation function for Proj4 projection code airy.

The full name for this projection is Airy.

Projection Parameters

lat_b
no_cut

  t_proj_aitoff
Autogenerated transformation function for Proj4 projection code aitoff.

The full name for this projection is Aitoff.

  t_proj_alsk
Autogenerated transformation function for Proj4 projection code alsk.

The full name for this projection is Mod. Stererographics of Alaska.

  t_proj_apian
Autogenerated transformation function for Proj4 projection code apian.

The full name for this projection is Apian Globular I.

  t_proj_august
Autogenerated transformation function for Proj4 projection code august.

The full name for this projection is August Epicycloidal.

  t_proj_bacon
Autogenerated transformation function for Proj4 projection code bacon.

The full name for this projection is Bacon Globular.

  t_proj_bipc
Autogenerated transformation function for Proj4 projection code bipc.

The full name for this projection is Bipolar conic of western hemisphere.

  t_proj_boggs
Autogenerated transformation function for Proj4 projection code boggs.

The full name for this projection is Boggs Eumorphic.

  t_proj_bonne
Autogenerated transformation function for Proj4 projection code bonne.

The full name for this projection is Bonne (Werner lat_1=90).

Projection Parameters

lat_1

  t_proj_cass
Autogenerated transformation function for Proj4 projection code cass.

The full name for this projection is Cassini.

  t_proj_cc
Autogenerated transformation function for Proj4 projection code cc.

The full name for this projection is Central Cylindrical.

  t_proj_cea
Autogenerated transformation function for Proj4 projection code cea.

The full name for this projection is Equal Area Cylindrical.

Projection Parameters

lat_ts

  t_proj_chamb
Autogenerated transformation function for Proj4 projection code chamb.

The full name for this projection is Chamberlin Trimetric.

Projection Parameters

lat_1
lat_2
lat_3
lon_1
lon_2
lon_3

  t_proj_collg
Autogenerated transformation function for Proj4 projection code collg.

The full name for this projection is Collignon.

  t_proj_crast
Autogenerated transformation function for Proj4 projection code crast.

The full name for this projection is Craster Parabolic (Putnins P4).

  t_proj_denoy
Autogenerated transformation function for Proj4 projection code denoy.

The full name for this projection is Denoyer Semi-Elliptical.

  t_proj_eck1
Autogenerated transformation function for Proj4 projection code eck1.

The full name for this projection is Eckert I.

  t_proj_eck2
Autogenerated transformation function for Proj4 projection code eck2.

The full name for this projection is Eckert II.

  t_proj_eck3
Autogenerated transformation function for Proj4 projection code eck3.

The full name for this projection is Eckert III.

  t_proj_eck4
Autogenerated transformation function for Proj4 projection code eck4.

The full name for this projection is Eckert IV.

  t_proj_eck5
Autogenerated transformation function for Proj4 projection code eck5.

The full name for this projection is Eckert V.

  t_proj_eck6
Autogenerated transformation function for Proj4 projection code eck6.

The full name for this projection is Eckert VI.

  t_proj_eqc
Autogenerated transformation function for Proj4 projection code eqc.

The full name for this projection is Equidistant Cylindrical (Plate Caree).

Projection Parameters

lat_00
lat_ts

  t_proj_eqdc
Autogenerated transformation function for Proj4 projection code eqdc.

The full name for this projection is Equidistant Conic.

Projection Parameters

lat_1
lat_2

  t_proj_etmerc
Autogenerated transformation function for Proj4 projection code etmerc.

The full name for this projection is Extended Transverse Mercator.

Projection Parameters

lat_0(0)
lat_ts(0)

  t_proj_euler
Autogenerated transformation function for Proj4 projection code euler.

The full name for this projection is Euler.

Projection Parameters

lat_1
lat_2

  t_proj_fahey
Autogenerated transformation function for Proj4 projection code fahey.

The full name for this projection is Fahey.

  t_proj_fouc
Autogenerated transformation function for Proj4 projection code fouc.

The full name for this projection is Foucaut.

  t_proj_fouc_s
Autogenerated transformation function for Proj4 projection code fouc_s.

The full name for this projection is Foucaut Sinusoidal.

  t_proj_gall
Autogenerated transformation function for Proj4 projection code gall.

The full name for this projection is Gall (Gall Stereographic).

  t_proj_geocent
Autogenerated transformation function for Proj4 projection code geocent.

The full name for this projection is Geocentric.

  t_proj_geos
Autogenerated transformation function for Proj4 projection code geos.

The full name for this projection is Geostationary Satellite View.

Projection Parameters

h

  t_proj_gins8
Autogenerated transformation function for Proj4 projection code gins8.

The full name for this projection is Ginsburg VIII (TsNIIGAiK).

  t_proj_gn_sinu
Autogenerated transformation function for Proj4 projection code gn_sinu.

The full name for this projection is General Sinusoidal Series.

Projection Parameters

m
n

  t_proj_gnom
Autogenerated transformation function for Proj4 projection code gnom.

The full name for this projection is Gnomonic.

  t_proj_goode
Autogenerated transformation function for Proj4 projection code goode.

The full name for this projection is Goode Homolosine.

  t_proj_gs48
Autogenerated transformation function for Proj4 projection code gs48.

The full name for this projection is Mod. Stererographics of 48 U.S..

  t_proj_gs50
Autogenerated transformation function for Proj4 projection code gs50.

The full name for this projection is Mod. Stererographics of 50 U.S..

  t_proj_gstmerc
Autogenerated transformation function for Proj4 projection code gstmerc.

The full name for this projection is Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion).

Projection Parameters

k_0
lat_0
lon_0

  t_proj_hammer
Autogenerated transformation function for Proj4 projection code hammer.

The full name for this projection is Hammer & Eckert-Greifendorff.

Projection Parameters

M
W

  t_proj_hatano
Autogenerated transformation function for Proj4 projection code hatano.

The full name for this projection is Hatano Asymmetrical Equal Area.

  t_proj_healpix
Autogenerated transformation function for Proj4 projection code healpix.

The full name for this projection is HEALPix.

  t_proj_igh
Autogenerated transformation function for Proj4 projection code igh.

The full name for this projection is Interrupted Goode Homolosine.

  t_proj_imw_p
Autogenerated transformation function for Proj4 projection code imw_p.

The full name for this projection is International Map of the World Polyconic.

Projection Parameters

lat_1
lat_2
lon_1

  t_proj_isea
Autogenerated transformation function for Proj4 projection code isea.

The full name for this projection is Icosahedral Snyder Equal Area.

  t_proj_kav5
Autogenerated transformation function for Proj4 projection code kav5.

The full name for this projection is Kavraisky V.

  t_proj_kav7
Autogenerated transformation function for Proj4 projection code kav7.

The full name for this projection is Kavraisky VII.

  t_proj_krovak
Autogenerated transformation function for Proj4 projection code krovak.

The full name for this projection is Krovak.

  t_proj_labrd
Autogenerated transformation function for Proj4 projection code labrd.

The full name for this projection is Laborde.

  t_proj_laea
Autogenerated transformation function for Proj4 projection code laea.

The full name for this projection is Lambert Azimuthal Equal Area.

  t_proj_lagrng
Autogenerated transformation function for Proj4 projection code lagrng.

The full name for this projection is Lagrange.

Projection Parameters

W

  t_proj_larr
Autogenerated transformation function for Proj4 projection code larr.

The full name for this projection is Larrivee.

  t_proj_lask
Autogenerated transformation function for Proj4 projection code lask.

The full name for this projection is Laskowski.

  t_proj_latlon
Autogenerated transformation function for Proj4 projection code latlon.

The full name for this projection is Lat/long (Geodetic alias).

  t_proj_latlong
Autogenerated transformation function for Proj4 projection code latlong.

The full name for this projection is Lat/long (Geodetic alias).

  t_proj_lcc
Autogenerated transformation function for Proj4 projection code lcc.

The full name for this projection is Lambert Conformal Conic.

Projection Parameters

lat_0
lat_1
lat_2

  t_proj_lcca
Autogenerated transformation function for Proj4 projection code lcca.

The full name for this projection is Lambert Conformal Conic Alternative.

Projection Parameters

lat_0

  t_proj_leac
Autogenerated transformation function for Proj4 projection code leac.

The full name for this projection is Lambert Equal Area Conic.

Projection Parameters

lat_1
south

  t_proj_lee_os
Autogenerated transformation function for Proj4 projection code lee_os.

The full name for this projection is Lee Oblated Stereographic.

  t_proj_longlat
Autogenerated transformation function for Proj4 projection code longlat.

The full name for this projection is Lat/long (Geodetic alias).

  t_proj_lonlat
Autogenerated transformation function for Proj4 projection code lonlat.

The full name for this projection is Lat/long (Geodetic).

  t_proj_loxim
Autogenerated transformation function for Proj4 projection code loxim.

The full name for this projection is Loximuthal.

  t_proj_lsat
Autogenerated transformation function for Proj4 projection code lsat.

The full name for this projection is Space oblique for LANDSAT.

Projection Parameters

lsat
path

  t_proj_mbt_fps
Autogenerated transformation function for Proj4 projection code mbt_fps.

The full name for this projection is McBryde-Thomas Flat-Pole Sine (No. 2).

  t_proj_mbt_s
Autogenerated transformation function for Proj4 projection code mbt_s.

The full name for this projection is McBryde-Thomas Flat-Polar Sine (No. 1).

  t_proj_mbtfpp
Autogenerated transformation function for Proj4 projection code mbtfpp.

The full name for this projection is McBride-Thomas Flat-Polar Parabolic.

  t_proj_mbtfpq
Autogenerated transformation function for Proj4 projection code mbtfpq.

The full name for this projection is McBryde-Thomas Flat-Polar Quartic.

  t_proj_mbtfps
Autogenerated transformation function for Proj4 projection code mbtfps.

The full name for this projection is McBryde-Thomas Flat-Polar Sinusoidal.

  t_proj_merc
Autogenerated transformation function for Proj4 projection code merc.

The full name for this projection is Mercator.

Projection Parameters

lat_ts

  t_proj_mil_os
Autogenerated transformation function for Proj4 projection code mil_os.

The full name for this projection is Miller Oblated Stereographic.

  t_proj_mill
Autogenerated transformation function for Proj4 projection code mill.

The full name for this projection is Miller Cylindrical.

  t_proj_moll
Autogenerated transformation function for Proj4 projection code moll.

The full name for this projection is Mollweide.

  t_proj_murd1
Autogenerated transformation function for Proj4 projection code murd1.

The full name for this projection is Murdoch I.

Projection Parameters

lat_1
lat_2

  t_proj_murd2
Autogenerated transformation function for Proj4 projection code murd2.

The full name for this projection is Murdoch II.

Projection Parameters

lat_1
lat_2

  t_proj_murd3
Autogenerated transformation function for Proj4 projection code murd3.

The full name for this projection is Murdoch III.

Projection Parameters

lat_1
lat_2

  t_proj_natearth
Autogenerated transformation function for Proj4 projection code natearth.

The full name for this projection is Natural Earth.

  t_proj_nell
Autogenerated transformation function for Proj4 projection code nell.

The full name for this projection is Nell.

  t_proj_nell_h
Autogenerated transformation function for Proj4 projection code nell_h.

The full name for this projection is Nell-Hammer.

  t_proj_nicol
Autogenerated transformation function for Proj4 projection code nicol.

The full name for this projection is Nicolosi Globular.

  t_proj_nsper
Autogenerated transformation function for Proj4 projection code nsper.

The full name for this projection is Near-sided perspective.

Projection Parameters

h

  t_proj_nzmg
Autogenerated transformation function for Proj4 projection code nzmg.

The full name for this projection is New Zealand Map Grid.

  t_proj_ob_tran
Autogenerated transformation function for Proj4 projection code ob_tran.

The full name for this projection is General Oblique Transformation.

Projection Parameters

o_alpha
o_lat_1
o_lat_2
o_lat_c
o_lat_p
o_lon_1
o_lon_2
o_lon_c
o_lon_p
o_proj

  t_proj_ocea
Autogenerated transformation function for Proj4 projection code ocea.

The full name for this projection is Oblique Cylindrical Equal Area.

Projection Parameters

lat_1
lat_2
lon_1
lon_2

  t_proj_oea
Autogenerated transformation function for Proj4 projection code oea.

The full name for this projection is Oblated Equal Area.

Projection Parameters

m
n
theta

  t_proj_omerc
Autogenerated transformation function for Proj4 projection code omerc.

The full name for this projection is Oblique Mercator.

Projection Parameters

alpha
gamma
lat_1
lat_2
lon_1
lon_2
lonc
no_off

  t_proj_ortel
Autogenerated transformation function for Proj4 projection code ortel.

The full name for this projection is Ortelius Oval.

  t_proj_ortho
Autogenerated transformation function for Proj4 projection code ortho.

The full name for this projection is Orthographic.

  t_proj_pconic
Autogenerated transformation function for Proj4 projection code pconic.

The full name for this projection is Perspective Conic.

Projection Parameters

lat_1
lat_2

  t_proj_poly
Autogenerated transformation function for Proj4 projection code poly.

The full name for this projection is Polyconic (American).

  t_proj_putp1
Autogenerated transformation function for Proj4 projection code putp1.

The full name for this projection is Putnins P1.

  t_proj_putp2
Autogenerated transformation function for Proj4 projection code putp2.

The full name for this projection is Putnins P2.

  t_proj_putp3
Autogenerated transformation function for Proj4 projection code putp3.

The full name for this projection is Putnins P3.

  t_proj_putp3p
Autogenerated transformation function for Proj4 projection code putp3p.

The full name for this projection is Putnins P3'.

  t_proj_putp4p
Autogenerated transformation function for Proj4 projection code putp4p.

The full name for this projection is Putnins P4'.

  t_proj_putp5
Autogenerated transformation function for Proj4 projection code putp5.

The full name for this projection is Putnins P5.

  t_proj_putp5p
Autogenerated transformation function for Proj4 projection code putp5p.

The full name for this projection is Putnins P5'.

  t_proj_putp6
Autogenerated transformation function for Proj4 projection code putp6.

The full name for this projection is Putnins P6.

  t_proj_putp6p
Autogenerated transformation function for Proj4 projection code putp6p.

The full name for this projection is Putnins P6'.

  t_proj_qua_aut
Autogenerated transformation function for Proj4 projection code qua_aut.

The full name for this projection is Quartic Authalic.

  t_proj_rhealpix
Autogenerated transformation function for Proj4 projection code rhealpix.

The full name for this projection is rHEALPix.

Projection Parameters

npole
spole

  t_proj_robin
Autogenerated transformation function for Proj4 projection code robin.

The full name for this projection is Robinson.

  t_proj_rouss
Autogenerated transformation function for Proj4 projection code rouss.

The full name for this projection is Roussilhe Stereographic.

  t_proj_rpoly
Autogenerated transformation function for Proj4 projection code rpoly.

The full name for this projection is Rectangular Polyconic.

Projection Parameters

lat_ts

  t_proj_sinu
Autogenerated transformation function for Proj4 projection code sinu.

The full name for this projection is Sinusoidal (Sanson-Flamsteed).

  t_proj_somerc
Autogenerated transformation function for Proj4 projection code somerc.

The full name for this projection is Swiss. Obl. Mercator.

  t_proj_stere
Autogenerated transformation function for Proj4 projection code stere.

The full name for this projection is Stereographic.

Projection Parameters

lat_ts

  t_proj_sterea
Autogenerated transformation function for Proj4 projection code sterea.

The full name for this projection is Oblique Stereographic Alternative.

  t_proj_tcc
Autogenerated transformation function for Proj4 projection code tcc.

The full name for this projection is Transverse Central Cylindrical.

  t_proj_tcea
Autogenerated transformation function for Proj4 projection code tcea.

The full name for this projection is Transverse Cylindrical Equal Area.

  t_proj_tissot
Autogenerated transformation function for Proj4 projection code tissot.

The full name for this projection is Tissot.

Projection Parameters

lat_1
lat_2

  t_proj_tmerc
Autogenerated transformation function for Proj4 projection code tmerc.

The full name for this projection is Transverse Mercator.

  t_proj_tpeqd
Autogenerated transformation function for Proj4 projection code tpeqd.

The full name for this projection is Two Point Equidistant.

Projection Parameters

lat_1
lat_2
lon_1
lon_2

  t_proj_tpers
Autogenerated transformation function for Proj4 projection code tpers.

The full name for this projection is Tilted perspective.

Projection Parameters

azi
h
tilt

  t_proj_ups
Autogenerated transformation function for Proj4 projection code ups.

The full name for this projection is Universal Polar Stereographic.

Projection Parameters

south

  t_proj_urm5
Autogenerated transformation function for Proj4 projection code urm5.

The full name for this projection is Urmaev V.

Projection Parameters

alphi
n
q

  t_proj_urmfps
Autogenerated transformation function for Proj4 projection code urmfps.

The full name for this projection is Urmaev Flat-Polar Sinusoidal.

Projection Parameters

n

  t_proj_utm
Autogenerated transformation function for Proj4 projection code utm.

The full name for this projection is Universal Transverse Mercator (UTM).

Projection Parameters

south
zone

  t_proj_vandg
Autogenerated transformation function for Proj4 projection code vandg.

The full name for this projection is van der Grinten (I).

  t_proj_vandg2
Autogenerated transformation function for Proj4 projection code vandg2.

The full name for this projection is van der Grinten II.

  t_proj_vandg3
Autogenerated transformation function for Proj4 projection code vandg3.

The full name for this projection is van der Grinten III.

  t_proj_vandg4
Autogenerated transformation function for Proj4 projection code vandg4.

The full name for this projection is van der Grinten IV.

  t_proj_vitk1
Autogenerated transformation function for Proj4 projection code vitk1.

The full name for this projection is Vitkovsky I.

Projection Parameters

lat_1
lat_2

  t_proj_wag1
Autogenerated transformation function for Proj4 projection code wag1.

The full name for this projection is Wagner I (Kavraisky VI).

  t_proj_wag2
Autogenerated transformation function for Proj4 projection code wag2.

The full name for this projection is Wagner II.

  t_proj_wag3
Autogenerated transformation function for Proj4 projection code wag3.

The full name for this projection is Wagner III.

Projection Parameters

lat_ts

  t_proj_wag4
Autogenerated transformation function for Proj4 projection code wag4.

The full name for this projection is Wagner IV.

  t_proj_wag5
Autogenerated transformation function for Proj4 projection code wag5.

The full name for this projection is Wagner V.

  t_proj_wag6
Autogenerated transformation function for Proj4 projection code wag6.

The full name for this projection is Wagner VI.

  t_proj_wag7
Autogenerated transformation function for Proj4 projection code wag7.

The full name for this projection is Wagner VII.

  t_proj_weren
Autogenerated transformation function for Proj4 projection code weren.

The full name for this projection is Werenskiold I.

  t_proj_wink1
Autogenerated transformation function for Proj4 projection code wink1.

The full name for this projection is Winkel I.

Projection Parameters

lat_ts

  t_proj_wink2
Autogenerated transformation function for Proj4 projection code wink2.

The full name for this projection is Winkel II.

Projection Parameters

lat_1

  t_proj_wintri
Autogenerated transformation function for Proj4 projection code wintri.

The full name for this projection is Winkel Tripel.

Projection Parameters

lat_1

AUTHOR & MAINTAINER
Judd Taylor, Orbital Systems, Ltd. judd dot t at orbitalsystems dot com