## 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_calcofi

Autogenerated transformation function for Proj4 projection code calcofi.The full name for this projection is Cal Coop Ocean Fish Invest Lines/Stations.

## 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_qsc

Autogenerated transformation function for Proj4 projection code qsc.The full name for this projection is Quadrilateralized Spherical Cube.

## 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

- south_square

## 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

- alpha
- 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