Provided by: pdl_2.4.7+dfsg-2ubuntu5_amd64

**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 thet_proj()function. This object accepts all of the standard options described below, but mainly is there to be called with just theproj_paramsoption 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.ALIASEDINTERFACEOther thant_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**

GeneralParametersproj_paramsThis 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.projThe proj projection code to use (like ortho...)x_0Cartesian X offset for the output of the transformationy_0Cartesian Y offset for the output of the transformationlat_0Central latitude for the projection. NOTE: This may mean other things depending on the projection selected, read the proj docs!lon_0Central longitude for the projection. NOTE: This may mean other things depending on the projection selected, read the proj docs!unitsCartesian 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.initSpecify a file:unit for proj to use for its runtime defaults. See the proj docs.no_defsDon't load any defaults. See the proj docs.overNormally, the transformation limits the output to between -180 and 180 degrees (or the cartesian equivalent), but with this option that behavior is turned off.geocInput values are geocentric coordinates.EarthFigureParametersellpsEllipsoid datum to use. Ex: WGS72, WGS74. See the proj docs and command line tool for list of possibilities ('proj -le').RRadius of the Earth.R_ARadius of a sphere with equivalent surface area of specified ellipse.R_VRadius of a sphere with equivalent volume of specified ellipse.R_aArithmetic mean of the major and minor axis, Ra = (a + b)/2.R_gGeometric mean of the major and minor axis, Rg = (ab)1/2.R_hHarmonic mean of the major and minor axis, Rh = 2ab/(a + b).R_lat_a=phiArithmetic mean of the principle radii at latitude phi.R_lat_g=phiGeometric mean of the principle radii at latitude phi.bSemiminor axis or polar radiusfFlatteningrfReciprocal flattening, +rf=1/feEccentricity +e=eesEccentricity squared +es=e2

**FUNCTIONS**

t_projThis is the main entry point for the generalized interface. See above on its usage.t_proj_aeaAutogenerated transformation function for Proj4 projection code aea. The full name for this projection is Albers Equal Area. Projection Parameters lat_1 lat_2t_proj_aeqdAutogenerated transformation function for Proj4 projection code aeqd. The full name for this projection is Azimuthal Equidistant. Projection Parameters guam lat_0t_proj_airyAutogenerated transformation function for Proj4 projection code airy. The full name for this projection is Airy. Projection Parameters lat_b no_cutt_proj_aitoffAutogenerated transformation function for Proj4 projection code aitoff. The full name for this projection is Aitoff.t_proj_alskAutogenerated transformation function for Proj4 projection code alsk. The full name for this projection is Mod. Stererographics of Alaska.t_proj_apianAutogenerated transformation function for Proj4 projection code apian. The full name for this projection is Apian Globular I.t_proj_augustAutogenerated transformation function for Proj4 projection code august. The full name for this projection is August Epicycloidal.t_proj_baconAutogenerated transformation function for Proj4 projection code bacon. The full name for this projection is Bacon Globular.t_proj_bipcAutogenerated transformation function for Proj4 projection code bipc. The full name for this projection is Bipolar conic of western hemisphere.t_proj_boggsAutogenerated transformation function for Proj4 projection code boggs. The full name for this projection is Boggs Eumorphic.t_proj_bonneAutogenerated transformation function for Proj4 projection code bonne. The full name for this projection is Bonne (Werner lat_1=90). Projection Parameters lat_1t_proj_cassAutogenerated transformation function for Proj4 projection code cass. The full name for this projection is Cassini.t_proj_ccAutogenerated transformation function for Proj4 projection code cc. The full name for this projection is Central Cylindrical.t_proj_ceaAutogenerated transformation function for Proj4 projection code cea. The full name for this projection is Equal Area Cylindrical. Projection Parameters lat_tst_proj_chambAutogenerated 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_3t_proj_collgAutogenerated transformation function for Proj4 projection code collg. The full name for this projection is Collignon.t_proj_crastAutogenerated transformation function for Proj4 projection code crast. The full name for this projection is Craster Parabolic (Putnins P4).t_proj_denoyAutogenerated transformation function for Proj4 projection code denoy. The full name for this projection is Denoyer Semi-Elliptical.t_proj_eck1Autogenerated transformation function for Proj4 projection code eck1. The full name for this projection is Eckert I.t_proj_eck2Autogenerated transformation function for Proj4 projection code eck2. The full name for this projection is Eckert II.t_proj_eck3Autogenerated transformation function for Proj4 projection code eck3. The full name for this projection is Eckert III.t_proj_eck4Autogenerated transformation function for Proj4 projection code eck4. The full name for this projection is Eckert IV.t_proj_eck5Autogenerated transformation function for Proj4 projection code eck5. The full name for this projection is Eckert V.t_proj_eck6Autogenerated transformation function for Proj4 projection code eck6. The full name for this projection is Eckert VI.t_proj_eqcAutogenerated transformation function for Proj4 projection code eqc. The full name for this projection is Equidistant Cylindrical (Plate Caree). Projection Parameters lat_00 lat_tst_proj_eqdcAutogenerated transformation function for Proj4 projection code eqdc. The full name for this projection is Equidistant Conic. Projection Parameters lat_1 lat_2t_proj_eulerAutogenerated transformation function for Proj4 projection code euler. The full name for this projection is Euler. Projection Parameters lat_1 lat_2t_proj_faheyAutogenerated transformation function for Proj4 projection code fahey. The full name for this projection is Fahey.t_proj_foucAutogenerated transformation function for Proj4 projection code fouc. The full name for this projection is Foucaut.t_proj_fouc_sAutogenerated transformation function for Proj4 projection code fouc_s. The full name for this projection is Foucaut Sinusoidal.t_proj_gallAutogenerated transformation function for Proj4 projection code gall. The full name for this projection is Gall (Gall Stereographic).t_proj_geocentAutogenerated transformation function for Proj4 projection code geocent. The full name for this projection is Geocentric.t_proj_geosAutogenerated transformation function for Proj4 projection code geos. The full name for this projection is Geostationary Satellite View. Projection Parameters ht_proj_gins8Autogenerated transformation function for Proj4 projection code gins8. The full name for this projection is Ginsburg VIII (TsNIIGAiK).t_proj_gn_sinuAutogenerated transformation function for Proj4 projection code gn_sinu. The full name for this projection is General Sinusoidal Series. Projection Parameters m nt_proj_gnomAutogenerated transformation function for Proj4 projection code gnom. The full name for this projection is Gnomonic.t_proj_goodeAutogenerated transformation function for Proj4 projection code goode. The full name for this projection is Goode Homolosine.t_proj_gs48Autogenerated transformation function for Proj4 projection code gs48. The full name for this projection is Mod. Stererographics of 48 U.S..t_proj_gs50Autogenerated transformation function for Proj4 projection code gs50. The full name for this projection is Mod. Stererographics of 50 U.S..t_proj_gstmercAutogenerated 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_0t_proj_hammerAutogenerated transformation function for Proj4 projection code hammer. The full name for this projection is Hammer & Eckert-Greifendorff. Projection Parameters M Wt_proj_hatanoAutogenerated transformation function for Proj4 projection code hatano. The full name for this projection is Hatano Asymmetrical Equal Area.t_proj_imw_pAutogenerated 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_1t_proj_kav5Autogenerated transformation function for Proj4 projection code kav5. The full name for this projection is Kavraisky V.t_proj_kav7Autogenerated transformation function for Proj4 projection code kav7. The full name for this projection is Kavraisky VII.t_proj_krovakAutogenerated transformation function for Proj4 projection code krovak. The full name for this projection is Krovak.t_proj_labrdAutogenerated transformation function for Proj4 projection code labrd. The full name for this projection is Laborde.t_proj_laeaAutogenerated transformation function for Proj4 projection code laea. The full name for this projection is Lambert Azimuthal Equal Area.t_proj_lagrngAutogenerated transformation function for Proj4 projection code lagrng. The full name for this projection is Lagrange. Projection Parameters Wt_proj_larrAutogenerated transformation function for Proj4 projection code larr. The full name for this projection is Larrivee.t_proj_laskAutogenerated transformation function for Proj4 projection code lask. The full name for this projection is Laskowski.t_proj_latlonAutogenerated transformation function for Proj4 projection code latlon. The full name for this projection is Lat/long (Geodetic alias).t_proj_latlongAutogenerated transformation function for Proj4 projection code latlong. The full name for this projection is Lat/long (Geodetic alias).t_proj_lccAutogenerated transformation function for Proj4 projection code lcc. The full name for this projection is Lambert Conformal Conic. Projection Parameters lat_0 lat_1 lat_2t_proj_lccaAutogenerated transformation function for Proj4 projection code lcca. The full name for this projection is Lambert Conformal Conic Alternative. Projection Parameters lat_0t_proj_leacAutogenerated transformation function for Proj4 projection code leac. The full name for this projection is Lambert Equal Area Conic. Projection Parameters lat_1 southt_proj_lee_osAutogenerated transformation function for Proj4 projection code lee_os. The full name for this projection is Lee Oblated Stereographic.t_proj_longlatAutogenerated transformation function for Proj4 projection code longlat. The full name for this projection is Lat/long (Geodetic alias).t_proj_lonlatAutogenerated transformation function for Proj4 projection code lonlat. The full name for this projection is Lat/long (Geodetic).t_proj_loximAutogenerated transformation function for Proj4 projection code loxim. The full name for this projection is Loximuthal.t_proj_lsatAutogenerated transformation function for Proj4 projection code lsat. The full name for this projection is Space oblique for LANDSAT. Projection Parameters lsat patht_proj_mbt_fpsAutogenerated 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_sAutogenerated transformation function for Proj4 projection code mbt_s. The full name for this projection is McBryde-Thomas Flat-Polar Sine (No. 1).t_proj_mbtfppAutogenerated transformation function for Proj4 projection code mbtfpp. The full name for this projection is McBride-Thomas Flat-Polar Parabolic.t_proj_mbtfpqAutogenerated transformation function for Proj4 projection code mbtfpq. The full name for this projection is McBryde-Thomas Flat-Polar Quartic.t_proj_mbtfpsAutogenerated transformation function for Proj4 projection code mbtfps. The full name for this projection is McBryde-Thomas Flat-Polar Sinusoidal.t_proj_mercAutogenerated transformation function for Proj4 projection code merc. The full name for this projection is Mercator. Projection Parameters lat_tst_proj_mil_osAutogenerated transformation function for Proj4 projection code mil_os. The full name for this projection is Miller Oblated Stereographic.t_proj_millAutogenerated transformation function for Proj4 projection code mill. The full name for this projection is Miller Cylindrical.t_proj_mollAutogenerated transformation function for Proj4 projection code moll. The full name for this projection is Mollweide.t_proj_murd1Autogenerated transformation function for Proj4 projection code murd1. The full name for this projection is Murdoch I. Projection Parameters lat_1 lat_2t_proj_murd2Autogenerated transformation function for Proj4 projection code murd2. The full name for this projection is Murdoch II. Projection Parameters lat_1 lat_2t_proj_murd3Autogenerated transformation function for Proj4 projection code murd3. The full name for this projection is Murdoch III. Projection Parameters lat_1 lat_2t_proj_nellAutogenerated transformation function for Proj4 projection code nell. The full name for this projection is Nell.t_proj_nell_hAutogenerated transformation function for Proj4 projection code nell_h. The full name for this projection is Nell-Hammer.t_proj_nicolAutogenerated transformation function for Proj4 projection code nicol. The full name for this projection is Nicolosi Globular.t_proj_nsperAutogenerated transformation function for Proj4 projection code nsper. The full name for this projection is Near-sided perspective. Projection Parameters ht_proj_nzmgAutogenerated transformation function for Proj4 projection code nzmg. The full name for this projection is New Zealand Map Grid.t_proj_ob_tranAutogenerated 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_projt_proj_oceaAutogenerated 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_2t_proj_oeaAutogenerated transformation function for Proj4 projection code oea. The full name for this projection is Oblated Equal Area. Projection Parameters m n thetat_proj_omercAutogenerated transformation function for Proj4 projection code omerc. The full name for this projection is Oblique Mercator. Projection Parameters alpha lat_1 lat_2 lon_1 lon_2 lonc no_rot no_uoff rot_convt_proj_ortelAutogenerated transformation function for Proj4 projection code ortel. The full name for this projection is Ortelius Oval.t_proj_orthoAutogenerated transformation function for Proj4 projection code ortho. The full name for this projection is Orthographic.t_proj_pconicAutogenerated transformation function for Proj4 projection code pconic. The full name for this projection is Perspective Conic. Projection Parameters lat_1 lat_2t_proj_polyAutogenerated transformation function for Proj4 projection code poly. The full name for this projection is Polyconic (American).t_proj_putp1Autogenerated transformation function for Proj4 projection code putp1. The full name for this projection is Putnins P1.t_proj_putp2Autogenerated transformation function for Proj4 projection code putp2. The full name for this projection is Putnins P2.t_proj_putp3Autogenerated transformation function for Proj4 projection code putp3. The full name for this projection is Putnins P3.t_proj_putp3pAutogenerated transformation function for Proj4 projection code putp3p. The full name for this projection is Putnins P3'.t_proj_putp4pAutogenerated transformation function for Proj4 projection code putp4p. The full name for this projection is Putnins P4'.t_proj_putp5Autogenerated transformation function for Proj4 projection code putp5. The full name for this projection is Putnins P5.t_proj_putp5pAutogenerated transformation function for Proj4 projection code putp5p. The full name for this projection is Putnins P5'.t_proj_putp6Autogenerated transformation function for Proj4 projection code putp6. The full name for this projection is Putnins P6.t_proj_putp6pAutogenerated transformation function for Proj4 projection code putp6p. The full name for this projection is Putnins P6'.t_proj_qua_autAutogenerated transformation function for Proj4 projection code qua_aut. The full name for this projection is Quartic Authalic.t_proj_robinAutogenerated transformation function for Proj4 projection code robin. The full name for this projection is Robinson.t_proj_roussAutogenerated transformation function for Proj4 projection code rouss. The full name for this projection is Roussilhe Stereographic.t_proj_rpolyAutogenerated transformation function for Proj4 projection code rpoly. The full name for this projection is Rectangular Polyconic. Projection Parameters lat_tst_proj_sinuAutogenerated transformation function for Proj4 projection code sinu. The full name for this projection is Sinusoidal (Sanson-Flamsteed).t_proj_somercAutogenerated transformation function for Proj4 projection code somerc. The full name for this projection is Swiss. Obl. Mercator.t_proj_stereAutogenerated transformation function for Proj4 projection code stere. The full name for this projection is Stereographic. Projection Parameters lat_tst_proj_stereaAutogenerated transformation function for Proj4 projection code sterea. The full name for this projection is Oblique Stereographic Alternative.t_proj_tccAutogenerated transformation function for Proj4 projection code tcc. The full name for this projection is Transverse Central Cylindrical.t_proj_tceaAutogenerated transformation function for Proj4 projection code tcea. The full name for this projection is Transverse Cylindrical Equal Area.t_proj_tissotAutogenerated transformation function for Proj4 projection code tissot. The full name for this projection is Tissot. Projection Parameters lat_1 lat_2t_proj_tmercAutogenerated transformation function for Proj4 projection code tmerc. The full name for this projection is Transverse Mercator.t_proj_tpeqdAutogenerated 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_2t_proj_tpersAutogenerated transformation function for Proj4 projection code tpers. The full name for this projection is Tilted perspective. Projection Parameters azi h tiltt_proj_upsAutogenerated transformation function for Proj4 projection code ups. The full name for this projection is Universal Polar Stereographic. Projection Parameters southt_proj_urm5Autogenerated transformation function for Proj4 projection code urm5. The full name for this projection is Urmaev V. Projection Parameters alphi n qt_proj_urmfpsAutogenerated transformation function for Proj4 projection code urmfps. The full name for this projection is Urmaev Flat-Polar Sinusoidal. Projection Parameters nt_proj_utmAutogenerated transformation function for Proj4 projection code utm. The full name for this projection is Universal Transverse Mercator (UTM). Projection Parameters south zonet_proj_vandgAutogenerated transformation function for Proj4 projection code vandg. The full name for this projection is van der Grinten (I).t_proj_vandg2Autogenerated transformation function for Proj4 projection code vandg2. The full name for this projection is van der Grinten II.t_proj_vandg3Autogenerated transformation function for Proj4 projection code vandg3. The full name for this projection is van der Grinten III.t_proj_vandg4Autogenerated transformation function for Proj4 projection code vandg4. The full name for this projection is van der Grinten IV.t_proj_vitk1Autogenerated transformation function for Proj4 projection code vitk1. The full name for this projection is Vitkovsky I. Projection Parameters lat_1 lat_2t_proj_wag1Autogenerated transformation function for Proj4 projection code wag1. The full name for this projection is Wagner I (Kavraisky VI).t_proj_wag2Autogenerated transformation function for Proj4 projection code wag2. The full name for this projection is Wagner II.t_proj_wag3Autogenerated transformation function for Proj4 projection code wag3. The full name for this projection is Wagner III. Projection Parameters lat_tst_proj_wag4Autogenerated transformation function for Proj4 projection code wag4. The full name for this projection is Wagner IV.t_proj_wag5Autogenerated transformation function for Proj4 projection code wag5. The full name for this projection is Wagner V.t_proj_wag6Autogenerated transformation function for Proj4 projection code wag6. The full name for this projection is Wagner VI.t_proj_wag7Autogenerated transformation function for Proj4 projection code wag7. The full name for this projection is Wagner VII.t_proj_werenAutogenerated transformation function for Proj4 projection code weren. The full name for this projection is Werenskiold I.t_proj_wink1Autogenerated transformation function for Proj4 projection code wink1. The full name for this projection is Winkel I. Projection Parameters lat_tst_proj_wink2Autogenerated transformation function for Proj4 projection code wink2. The full name for this projection is Winkel II. Projection Parameters lat_1t_proj_wintriAutogenerated 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