DOKK / manpages / debian 10 / pdl / PDL::Transform::Proj4.3pm.en
Proj4(3pm) User Contributed Perl Documentation Proj4(3pm)

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

 # 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());

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.

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.

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.

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

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

Autogenerated transformation function for Proj4 projection code aea.

The full name for this projection is Albers Equal Area.

Projection Parameters

Autogenerated transformation function for Proj4 projection code aeqd.

The full name for this projection is Azimuthal Equidistant.

Projection Parameters

Autogenerated transformation function for Proj4 projection code airy.

The full name for this projection is Airy.

Projection Parameters

Autogenerated transformation function for Proj4 projection code aitoff.

The full name for this projection is Aitoff.

Autogenerated transformation function for Proj4 projection code alsk.

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

Autogenerated transformation function for Proj4 projection code apian.

The full name for this projection is Apian Globular I.

Autogenerated transformation function for Proj4 projection code august.

The full name for this projection is August Epicycloidal.

Autogenerated transformation function for Proj4 projection code axisswap.

The full name for this projection is Axis ordering.

Autogenerated transformation function for Proj4 projection code bacon.

The full name for this projection is Bacon Globular.

Autogenerated transformation function for Proj4 projection code bipc.

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

Autogenerated transformation function for Proj4 projection code boggs.

The full name for this projection is Boggs Eumorphic.

Autogenerated transformation function for Proj4 projection code bonne.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code calcofi.

The full name for this projection is Cal Coop Ocean Fish Invest Lines/Stations.

Autogenerated transformation function for Proj4 projection code cart.

The full name for this projection is Geodetic/cartesian conversions.

Autogenerated transformation function for Proj4 projection code cass.

The full name for this projection is Cassini.

Autogenerated transformation function for Proj4 projection code cc.

The full name for this projection is Central Cylindrical.

Autogenerated transformation function for Proj4 projection code ccon.

The full name for this projection is Central Conic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code cea.

The full name for this projection is Equal Area Cylindrical.

Projection Parameters

Autogenerated transformation function for Proj4 projection code chamb.

The full name for this projection is Chamberlin Trimetric.

Projection Parameters

Autogenerated transformation function for Proj4 projection code collg.

The full name for this projection is Collignon.

Autogenerated transformation function for Proj4 projection code comill.

The full name for this projection is Compact Miller.

Autogenerated transformation function for Proj4 projection code crast.

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

Autogenerated transformation function for Proj4 projection code deformation.

The full name for this projection is Kinematic grid shift.

Autogenerated transformation function for Proj4 projection code denoy.

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

Autogenerated transformation function for Proj4 projection code eck1.

The full name for this projection is Eckert I.

Autogenerated transformation function for Proj4 projection code eck2.

The full name for this projection is Eckert II.

Autogenerated transformation function for Proj4 projection code eck3.

The full name for this projection is Eckert III.

Autogenerated transformation function for Proj4 projection code eck4.

The full name for this projection is Eckert IV.

Autogenerated transformation function for Proj4 projection code eck5.

The full name for this projection is Eckert V.

Autogenerated transformation function for Proj4 projection code eck6.

The full name for this projection is Eckert VI.

Autogenerated transformation function for Proj4 projection code eqc.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code eqdc.

The full name for this projection is Equidistant Conic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code eqearth.

The full name for this projection is Equal Earth.

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)

Autogenerated transformation function for Proj4 projection code euler.

The full name for this projection is Euler.

Projection Parameters

Autogenerated transformation function for Proj4 projection code fahey.

The full name for this projection is Fahey.

Autogenerated transformation function for Proj4 projection code fouc.

The full name for this projection is Foucaut.

Autogenerated transformation function for Proj4 projection code fouc_s.

The full name for this projection is Foucaut Sinusoidal.

Autogenerated transformation function for Proj4 projection code gall.

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

Autogenerated transformation function for Proj4 projection code geoc.

The full name for this projection is Geocentric Latitude.

Autogenerated transformation function for Proj4 projection code geocent.

The full name for this projection is Geocentric.

Autogenerated transformation function for Proj4 projection code geos.

The full name for this projection is Geostationary Satellite View.

Projection Parameters

Autogenerated transformation function for Proj4 projection code gins8.

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

Autogenerated transformation function for Proj4 projection code gn_sinu.

The full name for this projection is General Sinusoidal Series.

Projection Parameters

Autogenerated transformation function for Proj4 projection code gnom.

The full name for this projection is Gnomonic.

Autogenerated transformation function for Proj4 projection code goode.

The full name for this projection is Goode Homolosine.

Autogenerated transformation function for Proj4 projection code gs48.

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

Autogenerated transformation function for Proj4 projection code gs50.

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

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

Autogenerated transformation function for Proj4 projection code hammer.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code hatano.

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

Autogenerated transformation function for Proj4 projection code healpix.

The full name for this projection is HEALPix.

Autogenerated transformation function for Proj4 projection code helmert.

The full name for this projection is 3(6)-, 4(8)- and 7(14)-parameter Helmert shift.

Autogenerated transformation function for Proj4 projection code hgridshift.

The full name for this projection is Horizontal grid shift.

Autogenerated transformation function for Proj4 projection code horner.

The full name for this projection is Horner polynomial evaluation.

Autogenerated transformation function for Proj4 projection code igh.

The full name for this projection is Interrupted Goode Homolosine.

Autogenerated transformation function for Proj4 projection code imw_p.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code isea.

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

Autogenerated transformation function for Proj4 projection code kav5.

The full name for this projection is Kavraisky V.

Autogenerated transformation function for Proj4 projection code kav7.

The full name for this projection is Kavraisky VII.

Autogenerated transformation function for Proj4 projection code krovak.

The full name for this projection is Krovak.

Autogenerated transformation function for Proj4 projection code labrd.

The full name for this projection is Laborde.

Autogenerated transformation function for Proj4 projection code laea.

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

Autogenerated transformation function for Proj4 projection code lagrng.

The full name for this projection is Lagrange.

Projection Parameters

Autogenerated transformation function for Proj4 projection code larr.

The full name for this projection is Larrivee.

Autogenerated transformation function for Proj4 projection code lask.

The full name for this projection is Laskowski.

Autogenerated transformation function for Proj4 projection code latlon.

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

Autogenerated transformation function for Proj4 projection code latlong.

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

Autogenerated transformation function for Proj4 projection code lcc.

The full name for this projection is Lambert Conformal Conic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code lcca.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code leac.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code lee_os.

The full name for this projection is Lee Oblated Stereographic.

Autogenerated transformation function for Proj4 projection code longlat.

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

Autogenerated transformation function for Proj4 projection code lonlat.

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

Autogenerated transformation function for Proj4 projection code loxim.

The full name for this projection is Loximuthal.

Autogenerated transformation function for Proj4 projection code lsat.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code mbt_fps.

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

Autogenerated transformation function for Proj4 projection code mbt_s.

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

Autogenerated transformation function for Proj4 projection code mbtfpp.

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

Autogenerated transformation function for Proj4 projection code mbtfpq.

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

Autogenerated transformation function for Proj4 projection code mbtfps.

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

Autogenerated transformation function for Proj4 projection code merc.

The full name for this projection is Mercator.

Projection Parameters

Autogenerated transformation function for Proj4 projection code mil_os.

The full name for this projection is Miller Oblated Stereographic.

Autogenerated transformation function for Proj4 projection code mill.

The full name for this projection is Miller Cylindrical.

Autogenerated transformation function for Proj4 projection code misrsom.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code moll.

The full name for this projection is Mollweide.

Autogenerated transformation function for Proj4 projection code molodensky.

The full name for this projection is Molodensky transform.

Autogenerated transformation function for Proj4 projection code murd1.

The full name for this projection is Murdoch I.

Projection Parameters

Autogenerated transformation function for Proj4 projection code murd2.

The full name for this projection is Murdoch II.

Projection Parameters

Autogenerated transformation function for Proj4 projection code murd3.

The full name for this projection is Murdoch III.

Projection Parameters

Autogenerated transformation function for Proj4 projection code natearth.

The full name for this projection is Natural Earth.

Autogenerated transformation function for Proj4 projection code natearth2.

The full name for this projection is Natural Earth 2.

Autogenerated transformation function for Proj4 projection code nell.

The full name for this projection is Nell.

Autogenerated transformation function for Proj4 projection code nell_h.

The full name for this projection is Nell-Hammer.

Autogenerated transformation function for Proj4 projection code nicol.

The full name for this projection is Nicolosi Globular.

Autogenerated transformation function for Proj4 projection code nsper.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code nzmg.

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

Autogenerated transformation function for Proj4 projection code ob_tran.

The full name for this projection is General Oblique Transformation.

Projection Parameters

Autogenerated transformation function for Proj4 projection code ocea.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code oea.

The full name for this projection is Oblated Equal Area.

Projection Parameters

Autogenerated transformation function for Proj4 projection code omerc.

The full name for this projection is Oblique Mercator.

Projection Parameters

Autogenerated transformation function for Proj4 projection code ortel.

The full name for this projection is Ortelius Oval.

Autogenerated transformation function for Proj4 projection code ortho.

The full name for this projection is Orthographic.

Autogenerated transformation function for Proj4 projection code patterson.

The full name for this projection is Patterson Cylindrical.

Autogenerated transformation function for Proj4 projection code pconic.

The full name for this projection is Perspective Conic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code pipeline.

The full name for this projection is Transformation pipeline manager.

Autogenerated transformation function for Proj4 projection code poly.

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

Autogenerated transformation function for Proj4 projection code putp1.

The full name for this projection is Putnins P1.

Autogenerated transformation function for Proj4 projection code putp2.

The full name for this projection is Putnins P2.

Autogenerated transformation function for Proj4 projection code putp3.

The full name for this projection is Putnins P3.

Autogenerated transformation function for Proj4 projection code putp3p.

The full name for this projection is Putnins P3'.

Autogenerated transformation function for Proj4 projection code putp4p.

The full name for this projection is Putnins P4'.

Autogenerated transformation function for Proj4 projection code putp5.

The full name for this projection is Putnins P5.

Autogenerated transformation function for Proj4 projection code putp5p.

The full name for this projection is Putnins P5'.

Autogenerated transformation function for Proj4 projection code putp6.

The full name for this projection is Putnins P6.

Autogenerated transformation function for Proj4 projection code putp6p.

The full name for this projection is Putnins P6'.

Autogenerated transformation function for Proj4 projection code qsc.

The full name for this projection is Quadrilateralized Spherical Cube.

Autogenerated transformation function for Proj4 projection code qua_aut.

The full name for this projection is Quartic Authalic.

Autogenerated transformation function for Proj4 projection code rhealpix.

The full name for this projection is rHEALPix.

Projection Parameters

Autogenerated transformation function for Proj4 projection code robin.

The full name for this projection is Robinson.

Autogenerated transformation function for Proj4 projection code rouss.

The full name for this projection is Roussilhe Stereographic.

Autogenerated transformation function for Proj4 projection code rpoly.

The full name for this projection is Rectangular Polyconic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code sch.

The full name for this projection is Spherical Cross-track Height.

Projection Parameters

Autogenerated transformation function for Proj4 projection code sinu.

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

Autogenerated transformation function for Proj4 projection code somerc.

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

Autogenerated transformation function for Proj4 projection code stere.

The full name for this projection is Stereographic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code sterea.

The full name for this projection is Oblique Stereographic Alternative.

Autogenerated transformation function for Proj4 projection code tcc.

The full name for this projection is Transverse Central Cylindrical.

Autogenerated transformation function for Proj4 projection code tcea.

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

Autogenerated transformation function for Proj4 projection code times.

The full name for this projection is Times.

Autogenerated transformation function for Proj4 projection code tissot.

The full name for this projection is Tissot.

Projection Parameters

Autogenerated transformation function for Proj4 projection code tmerc.

The full name for this projection is Transverse Mercator.

Autogenerated transformation function for Proj4 projection code tpeqd.

The full name for this projection is Two Point Equidistant.

Projection Parameters

Autogenerated transformation function for Proj4 projection code tpers.

The full name for this projection is Tilted perspective.

Projection Parameters

Autogenerated transformation function for Proj4 projection code unitconvert.

The full name for this projection is Unit conversion.

Autogenerated transformation function for Proj4 projection code ups.

The full name for this projection is Universal Polar Stereographic.

Projection Parameters

Autogenerated transformation function for Proj4 projection code urm5.

The full name for this projection is Urmaev V.

Projection Parameters

Autogenerated transformation function for Proj4 projection code urmfps.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code utm.

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

Projection Parameters

Autogenerated transformation function for Proj4 projection code vandg.

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

Autogenerated transformation function for Proj4 projection code vandg2.

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

Autogenerated transformation function for Proj4 projection code vandg3.

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

Autogenerated transformation function for Proj4 projection code vandg4.

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

Autogenerated transformation function for Proj4 projection code vgridshift.

The full name for this projection is Vertical grid shift.

Autogenerated transformation function for Proj4 projection code vitk1.

The full name for this projection is Vitkovsky I.

Projection Parameters

Autogenerated transformation function for Proj4 projection code wag1.

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

Autogenerated transformation function for Proj4 projection code wag2.

The full name for this projection is Wagner II.

Autogenerated transformation function for Proj4 projection code wag3.

The full name for this projection is Wagner III.

Projection Parameters

Autogenerated transformation function for Proj4 projection code wag4.

The full name for this projection is Wagner IV.

Autogenerated transformation function for Proj4 projection code wag5.

The full name for this projection is Wagner V.

Autogenerated transformation function for Proj4 projection code wag6.

The full name for this projection is Wagner VI.

Autogenerated transformation function for Proj4 projection code wag7.

The full name for this projection is Wagner VII.

Autogenerated transformation function for Proj4 projection code webmerc.

The full name for this projection is Web Mercator / Pseudo Mercator.

Autogenerated transformation function for Proj4 projection code weren.

The full name for this projection is Werenskiold I.

Autogenerated transformation function for Proj4 projection code wink1.

The full name for this projection is Winkel I.

Projection Parameters

Autogenerated transformation function for Proj4 projection code wink2.

The full name for this projection is Winkel II.

Projection Parameters

Autogenerated transformation function for Proj4 projection code wintri.

The full name for this projection is Winkel Tripel.

Projection Parameters

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

2018-11-02 perl v5.28.0