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.
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.
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.
The proj projection code to use (like ortho...)
Cartesian X offset for the output of the transformation
Cartesian Y offset for the output of the transformation
Central latitude for the projection. NOTE: This may mean other things depending on the projection selected, read the proj docs!
Central longitude for the projection. NOTE: This may mean other things depending on the projection selected, read the proj docs!
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.
Specify a file:unit for proj to use for its runtime defaults. See the proj docs.
Don't load any defaults. See the proj docs.
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.
Input values are geocentric coordinates.
Ellipsoid datum to use. Ex: WGS72, WGS74. See the proj docs and command line tool for list of possibilities ('proj -le').
Radius of the Earth.
Radius of a sphere with equivalent surface area of specified ellipse.
Radius of a sphere with equivalent volume of specified ellipse.
Arithmetic mean of the major and minor axis, Ra = (a + b)/2.
Geometric mean of the major and minor axis, Rg = (ab)1/2.
Harmonic mean of the major and minor axis, Rh = 2ab/(a + b).
Arithmetic mean of the principle radii at latitude phi.
Geometric mean of the principle radii at latitude phi.
Semiminor axis or polar radius
Flattening
Reciprocal flattening, +rf=1/f
Eccentricity +e=e
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.
Autogenerated transformation function for Proj4 projection code airy.
The full name for this projection is Airy.
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 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).
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 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 cea.
The full name for this projection is Equal Area Cylindrical.
Autogenerated transformation function for Proj4 projection code chamb.
The full name for this projection is Chamberlin Trimetric.
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 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).
Autogenerated transformation function for Proj4 projection code eqdc.
The full name for this projection is Equidistant Conic.
Autogenerated transformation function for Proj4 projection code etmerc.
The full name for this projection is Extended Transverse Mercator.
Autogenerated transformation function for Proj4 projection code euler.
The full name for this projection is Euler.
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 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.
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.
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).
Autogenerated transformation function for Proj4 projection code hammer.
The full name for this projection is Hammer & Eckert-Greifendorff.
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 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.
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.
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.
Autogenerated transformation function for Proj4 projection code lcc.
The full name for this projection is Lambert Conformal Conic.
Autogenerated transformation function for Proj4 projection code lcca.
The full name for this projection is Lambert Conformal Conic Alternative.
Autogenerated transformation function for Proj4 projection code leac.
The full name for this projection is Lambert Equal Area Conic.
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.
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.
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.
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.
Autogenerated transformation function for Proj4 projection code moll.
The full name for this projection is Mollweide.
Autogenerated transformation function for Proj4 projection code murd1.
The full name for this projection is Murdoch I.
Autogenerated transformation function for Proj4 projection code murd2.
The full name for this projection is Murdoch II.
Autogenerated transformation function for Proj4 projection code murd3.
The full name for this projection is Murdoch III.
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.
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.
Autogenerated transformation function for Proj4 projection code ocea.
The full name for this projection is Oblique Cylindrical Equal Area.
Autogenerated transformation function for Proj4 projection code oea.
The full name for this projection is Oblated Equal Area.
Autogenerated transformation function for Proj4 projection code omerc.
The full name for this projection is Oblique Mercator.
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.
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.
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.
Autogenerated transformation function for Proj4 projection code sch.
The full name for this projection is Spherical Cross-track Height.
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.
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.
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.
Autogenerated transformation function for Proj4 projection code tpers.
The full name for this projection is Tilted perspective.
Autogenerated transformation function for Proj4 projection code ups.
The full name for this projection is Universal Polar Stereographic.
Autogenerated transformation function for Proj4 projection code urm5.
The full name for this projection is Urmaev V.
Autogenerated transformation function for Proj4 projection code urmfps.
The full name for this projection is Urmaev Flat-Polar Sinusoidal.
Autogenerated transformation function for Proj4 projection code utm.
The full name for this projection is Universal Transverse Mercator (UTM).
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 vitk1.
The full name for this projection is Vitkovsky I.
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.
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 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.
Autogenerated transformation function for Proj4 projection code wink2.
The full name for this projection is Winkel II.
Autogenerated transformation function for Proj4 projection code wintri.
The full name for this projection is Winkel Tripel.
Judd Taylor, Orbital Systems, Ltd. judd dot t at orbitalsystems dot com
To install PDL, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PDL
CPAN shell
perl -MCPAN -e shell install PDL
For more information on module installation, please visit the detailed CPAN module installation guide.