NAME¶
PDL::Transform::Proj4 - PDL::Transform interface to the Proj4 projection library
SYNOPSIS¶
# Using the generalized proj interface:
# Make an orthographic map of Earth
use PDL::Transform::Cartography;
use PDL::Transform::Proj4;
$a = earth_coast();
$a = graticule(10,2)->glue(1,$a);
$t = t_proj( proj_params => "+proj=ortho +ellps=WGS84 +lon_0=-90 +lat_0=40" );
$w = pgwin(xs);
$w->lines($t->apply($a)->clean_lines());
# Using the aliased functions:
# Make an orthographic map of Earth
use PDL::Transform::Cartography;
use PDL::Transform::Proj4;
$a = earth_coast();
$a = graticule(10,2)->glue(1,$a);
$t = t_proj_ortho( ellps => 'WGS84', lon_0 => -90, lat_0 => 40 )
$w = pgwin(xs);
$w->lines($t->apply($a)->clean_lines());
DESCRIPTION¶
Works like PDL::Transform::Cartography, but using the proj library in the
background.
Please see the proj library docs at <
http://www.remotesensing.org/proj>
for more information on proj, and how to use the library.
GENERALIZED INTERFACE¶
The main object here is the PDL::Transform::Proj4 object, aliased to the
t_proj() function.
This object accepts all of the standard options described below, but mainly is
there to be called with just the
proj_params option defined.
When options are used, they must be used with a '+' before them when placed in
the proj_params string, but that is not required otherwise. See the SYNOPSIS
above.
ALIASED INTERFACE¶
Other than
t_proj(), all of the other transforms below have been
autogenerated, and may not work properly. The main problem is determining the
parameters a projection requires from the proj library itself.
Due to the difficulties in doing this, there may be times when the proj docs
specify a parameter for a projection that won't work using the anon-hash type
specification. In that case, just throw that parameter in the proj_params
string, and everything should work fine.
PARAMETERS AVAILABLE IN ALL PROJECTIONS¶
General Parameters¶
proj_params
This is a string containing the proj "plus style" parameters. This
would be similar to what you would put on the command line for the 'proj'
tool. Like "+proj=ortho +ellps=WGS84 +lon_0=-90 +lat_0=40".
This parameter overrides the others below when it contains parameters that are
also specified explicitly.
proj
The proj projection code to use (like ortho...)
x_0
Cartesian X offset for the output of the transformation
y_0
Cartesian Y offset for the output of the transformation
lat_0
Central latitude for the projection. NOTE: This may mean other things depending
on the projection selected, read the proj docs!
lon_0
Central longitude for the projection. NOTE: This may mean other things depending
on the projection selected, read the proj docs!
units
Cartesian units used for the output of the projection. NOTE: Like most of the
options here, this is likely useless in the current implementation of this
library.
init
Specify a file:unit for proj to use for its runtime defaults. See the proj docs.
no_defs
Don't load any defaults. See the proj docs.
over
Normally, the transformation limits the output to between -180 and 180 degrees
(or the cartesian equivalent), but with this option that behavior is turned
off.
geoc
Input values are geocentric coordinates.
ellps
Ellipsoid datum to use. Ex: WGS72, WGS74. See the proj docs and command line
tool for list of possibilities ('proj -le').
R
Radius of the Earth.
R_A
Radius of a sphere with equivalent surface area of specified ellipse.
R_V
Radius of a sphere with equivalent volume of specified ellipse.
R_a
Arithmetic mean of the major and minor axis, Ra = (a + b)/2.
R_g
Geometric mean of the major and minor axis, Rg = (ab)1/2.
R_h
Harmonic mean of the major and minor axis, Rh = 2ab/(a + b).
R_lat_a=phi
Arithmetic mean of the principle radii at latitude phi.
R_lat_g=phi
Geometric mean of the principle radii at latitude phi.
b
Semiminor axis or polar radius
f
Flattening
rf
Reciprocal flattening, +rf=1/f
e
Eccentricity +e=e
es
Eccentricity squared +es=e2
FUNCTIONS¶
t_proj¶
This is the main entry point for the generalized interface. See above on its
usage.
t_proj_aea¶
Autogenerated transformation function for Proj4 projection code aea.
The full name for this projection is Albers Equal Area.
Projection Parameters
- lat_1
- lat_2
t_proj_aeqd¶
Autogenerated transformation function for Proj4 projection code aeqd.
The full name for this projection is Azimuthal Equidistant.
Projection Parameters
- guam
- lat_0
t_proj_airy¶
Autogenerated transformation function for Proj4 projection code airy.
The full name for this projection is Airy.
Projection Parameters
- lat_b
- no_cut
t_proj_aitoff¶
Autogenerated transformation function for Proj4 projection code aitoff.
The full name for this projection is Aitoff.
t_proj_alsk¶
Autogenerated transformation function for Proj4 projection code alsk.
The full name for this projection is Mod. Stererographics of Alaska.
t_proj_apian¶
Autogenerated transformation function for Proj4 projection code apian.
The full name for this projection is Apian Globular I.
t_proj_august¶
Autogenerated transformation function for Proj4 projection code august.
The full name for this projection is August Epicycloidal.
t_proj_bacon¶
Autogenerated transformation function for Proj4 projection code bacon.
The full name for this projection is Bacon Globular.
t_proj_bipc¶
Autogenerated transformation function for Proj4 projection code bipc.
The full name for this projection is Bipolar conic of western hemisphere.
t_proj_boggs¶
Autogenerated transformation function for Proj4 projection code boggs.
The full name for this projection is Boggs Eumorphic.
t_proj_bonne¶
Autogenerated transformation function for Proj4 projection code bonne.
The full name for this projection is Bonne (Werner lat_1=90).
Projection Parameters
- lat_1
t_proj_cass¶
Autogenerated transformation function for Proj4 projection code cass.
The full name for this projection is Cassini.
t_proj_cc¶
Autogenerated transformation function for Proj4 projection code cc.
The full name for this projection is Central Cylindrical.
t_proj_cea¶
Autogenerated transformation function for Proj4 projection code cea.
The full name for this projection is Equal Area Cylindrical.
Projection Parameters
- lat_ts
t_proj_chamb¶
Autogenerated transformation function for Proj4 projection code chamb.
The full name for this projection is Chamberlin Trimetric.
Projection Parameters
- lat_1
- lat_2
- lat_3
- lon_1
- lon_2
- lon_3
t_proj_collg¶
Autogenerated transformation function for Proj4 projection code collg.
The full name for this projection is Collignon.
t_proj_crast¶
Autogenerated transformation function for Proj4 projection code crast.
The full name for this projection is Craster Parabolic (Putnins P4).
t_proj_denoy¶
Autogenerated transformation function for Proj4 projection code denoy.
The full name for this projection is Denoyer Semi-Elliptical.
t_proj_eck1¶
Autogenerated transformation function for Proj4 projection code eck1.
The full name for this projection is Eckert I.
t_proj_eck2¶
Autogenerated transformation function for Proj4 projection code eck2.
The full name for this projection is Eckert II.
t_proj_eck3¶
Autogenerated transformation function for Proj4 projection code eck3.
The full name for this projection is Eckert III.
t_proj_eck4¶
Autogenerated transformation function for Proj4 projection code eck4.
The full name for this projection is Eckert IV.
t_proj_eck5¶
Autogenerated transformation function for Proj4 projection code eck5.
The full name for this projection is Eckert V.
t_proj_eck6¶
Autogenerated transformation function for Proj4 projection code eck6.
The full name for this projection is Eckert VI.
t_proj_eqc¶
Autogenerated transformation function for Proj4 projection code eqc.
The full name for this projection is Equidistant Cylindrical (Plate Caree).
Projection Parameters
- lat_00
- lat_ts
t_proj_eqdc¶
Autogenerated transformation function for Proj4 projection code eqdc.
The full name for this projection is Equidistant Conic.
Projection Parameters
- lat_1
- lat_2
t_proj_etmerc¶
Autogenerated transformation function for Proj4 projection code etmerc.
The full name for this projection is Extended Transverse Mercator.
Projection Parameters
- lat_0(0)
- lat_ts(0)
t_proj_euler¶
Autogenerated transformation function for Proj4 projection code euler.
The full name for this projection is Euler.
Projection Parameters
- lat_1
- lat_2
t_proj_fahey¶
Autogenerated transformation function for Proj4 projection code fahey.
The full name for this projection is Fahey.
t_proj_fouc¶
Autogenerated transformation function for Proj4 projection code fouc.
The full name for this projection is Foucaut.
t_proj_fouc_s¶
Autogenerated transformation function for Proj4 projection code fouc_s.
The full name for this projection is Foucaut Sinusoidal.
t_proj_gall¶
Autogenerated transformation function for Proj4 projection code gall.
The full name for this projection is Gall (Gall Stereographic).
t_proj_geocent¶
Autogenerated transformation function for Proj4 projection code geocent.
The full name for this projection is Geocentric.
t_proj_geos¶
Autogenerated transformation function for Proj4 projection code geos.
The full name for this projection is Geostationary Satellite View.
Projection Parameters
- h
t_proj_gins8¶
Autogenerated transformation function for Proj4 projection code gins8.
The full name for this projection is Ginsburg VIII (TsNIIGAiK).
t_proj_gn_sinu¶
Autogenerated transformation function for Proj4 projection code gn_sinu.
The full name for this projection is General Sinusoidal Series.
Projection Parameters
- m
- n
t_proj_gnom¶
Autogenerated transformation function for Proj4 projection code gnom.
The full name for this projection is Gnomonic.
t_proj_goode¶
Autogenerated transformation function for Proj4 projection code goode.
The full name for this projection is Goode Homolosine.
t_proj_gs48¶
Autogenerated transformation function for Proj4 projection code gs48.
The full name for this projection is Mod. Stererographics of 48 U.S..
t_proj_gs50¶
Autogenerated transformation function for Proj4 projection code gs50.
The full name for this projection is Mod. Stererographics of 50 U.S..
t_proj_gstmerc¶
Autogenerated transformation function for Proj4 projection code gstmerc.
The full name for this projection is Gauss-Schreiber Transverse Mercator (aka
Gauss-Laborde Reunion).
Projection Parameters
- k_0
- lat_0
- lon_0
t_proj_hammer¶
Autogenerated transformation function for Proj4 projection code hammer.
The full name for this projection is Hammer & Eckert-Greifendorff.
Projection Parameters
- M
- W
t_proj_hatano¶
Autogenerated transformation function for Proj4 projection code hatano.
The full name for this projection is Hatano Asymmetrical Equal Area.
t_proj_healpix¶
Autogenerated transformation function for Proj4 projection code healpix.
The full name for this projection is HEALPix.
t_proj_igh¶
Autogenerated transformation function for Proj4 projection code igh.
The full name for this projection is Interrupted Goode Homolosine.
t_proj_imw_p¶
Autogenerated transformation function for Proj4 projection code imw_p.
The full name for this projection is International Map of the World Polyconic.
Projection Parameters
- lat_1
- lat_2
- lon_1
t_proj_isea¶
Autogenerated transformation function for Proj4 projection code isea.
The full name for this projection is Icosahedral Snyder Equal Area.
t_proj_kav5¶
Autogenerated transformation function for Proj4 projection code kav5.
The full name for this projection is Kavraisky V.
t_proj_kav7¶
Autogenerated transformation function for Proj4 projection code kav7.
The full name for this projection is Kavraisky VII.
t_proj_krovak¶
Autogenerated transformation function for Proj4 projection code krovak.
The full name for this projection is Krovak.
t_proj_labrd¶
Autogenerated transformation function for Proj4 projection code labrd.
The full name for this projection is Laborde.
t_proj_laea¶
Autogenerated transformation function for Proj4 projection code laea.
The full name for this projection is Lambert Azimuthal Equal Area.
t_proj_lagrng¶
Autogenerated transformation function for Proj4 projection code lagrng.
The full name for this projection is Lagrange.
Projection Parameters
- W
t_proj_larr¶
Autogenerated transformation function for Proj4 projection code larr.
The full name for this projection is Larrivee.
t_proj_lask¶
Autogenerated transformation function for Proj4 projection code lask.
The full name for this projection is Laskowski.
t_proj_latlon¶
Autogenerated transformation function for Proj4 projection code latlon.
The full name for this projection is Lat/long (Geodetic alias).
t_proj_latlong¶
Autogenerated transformation function for Proj4 projection code latlong.
The full name for this projection is Lat/long (Geodetic alias).
t_proj_lcc¶
Autogenerated transformation function for Proj4 projection code lcc.
The full name for this projection is Lambert Conformal Conic.
Projection Parameters
- lat_0
- lat_1
- lat_2
t_proj_lcca¶
Autogenerated transformation function for Proj4 projection code lcca.
The full name for this projection is Lambert Conformal Conic Alternative.
Projection Parameters
- lat_0
t_proj_leac¶
Autogenerated transformation function for Proj4 projection code leac.
The full name for this projection is Lambert Equal Area Conic.
Projection Parameters
- lat_1
- south
t_proj_lee_os¶
Autogenerated transformation function for Proj4 projection code lee_os.
The full name for this projection is Lee Oblated Stereographic.
t_proj_longlat¶
Autogenerated transformation function for Proj4 projection code longlat.
The full name for this projection is Lat/long (Geodetic alias).
t_proj_lonlat¶
Autogenerated transformation function for Proj4 projection code lonlat.
The full name for this projection is Lat/long (Geodetic).
t_proj_loxim¶
Autogenerated transformation function for Proj4 projection code loxim.
The full name for this projection is Loximuthal.
t_proj_lsat¶
Autogenerated transformation function for Proj4 projection code lsat.
The full name for this projection is Space oblique for LANDSAT.
Projection Parameters
- lsat
- path
t_proj_mbt_fps¶
Autogenerated transformation function for Proj4 projection code mbt_fps.
The full name for this projection is McBryde-Thomas Flat-Pole Sine (No. 2).
t_proj_mbt_s¶
Autogenerated transformation function for Proj4 projection code mbt_s.
The full name for this projection is McBryde-Thomas Flat-Polar Sine (No. 1).
t_proj_mbtfpp¶
Autogenerated transformation function for Proj4 projection code mbtfpp.
The full name for this projection is McBride-Thomas Flat-Polar Parabolic.
t_proj_mbtfpq¶
Autogenerated transformation function for Proj4 projection code mbtfpq.
The full name for this projection is McBryde-Thomas Flat-Polar Quartic.
t_proj_mbtfps¶
Autogenerated transformation function for Proj4 projection code mbtfps.
The full name for this projection is McBryde-Thomas Flat-Polar Sinusoidal.
t_proj_merc¶
Autogenerated transformation function for Proj4 projection code merc.
The full name for this projection is Mercator.
Projection Parameters
- lat_ts
t_proj_mil_os¶
Autogenerated transformation function for Proj4 projection code mil_os.
The full name for this projection is Miller Oblated Stereographic.
t_proj_mill¶
Autogenerated transformation function for Proj4 projection code mill.
The full name for this projection is Miller Cylindrical.
t_proj_moll¶
Autogenerated transformation function for Proj4 projection code moll.
The full name for this projection is Mollweide.
t_proj_murd1¶
Autogenerated transformation function for Proj4 projection code murd1.
The full name for this projection is Murdoch I.
Projection Parameters
- lat_1
- lat_2
t_proj_murd2¶
Autogenerated transformation function for Proj4 projection code murd2.
The full name for this projection is Murdoch II.
Projection Parameters
- lat_1
- lat_2
t_proj_murd3¶
Autogenerated transformation function for Proj4 projection code murd3.
The full name for this projection is Murdoch III.
Projection Parameters
- lat_1
- lat_2
t_proj_natearth¶
Autogenerated transformation function for Proj4 projection code natearth.
The full name for this projection is Natural Earth.
t_proj_nell¶
Autogenerated transformation function for Proj4 projection code nell.
The full name for this projection is Nell.
t_proj_nell_h¶
Autogenerated transformation function for Proj4 projection code nell_h.
The full name for this projection is Nell-Hammer.
t_proj_nicol¶
Autogenerated transformation function for Proj4 projection code nicol.
The full name for this projection is Nicolosi Globular.
t_proj_nsper¶
Autogenerated transformation function for Proj4 projection code nsper.
The full name for this projection is Near-sided perspective.
Projection Parameters
- h
t_proj_nzmg¶
Autogenerated transformation function for Proj4 projection code nzmg.
The full name for this projection is New Zealand Map Grid.
t_proj_ob_tran¶
Autogenerated transformation function for Proj4 projection code ob_tran.
The full name for this projection is General Oblique Transformation.
Projection Parameters
- o_alpha
- o_lat_1
- o_lat_2
- o_lat_c
- o_lat_p
- o_lon_1
- o_lon_2
- o_lon_c
- o_lon_p
- o_proj
t_proj_ocea¶
Autogenerated transformation function for Proj4 projection code ocea.
The full name for this projection is Oblique Cylindrical Equal Area.
Projection Parameters
- lat_1
- lat_2
- lon_1
- lon_2
t_proj_oea¶
Autogenerated transformation function for Proj4 projection code oea.
The full name for this projection is Oblated Equal Area.
Projection Parameters
- m
- n
- theta
t_proj_omerc¶
Autogenerated transformation function for Proj4 projection code omerc.
The full name for this projection is Oblique Mercator.
Projection Parameters
- alpha
- gamma
- lat_1
- lat_2
- lon_1
- lon_2
- lonc
- no_off
t_proj_ortel¶
Autogenerated transformation function for Proj4 projection code ortel.
The full name for this projection is Ortelius Oval.
t_proj_ortho¶
Autogenerated transformation function for Proj4 projection code ortho.
The full name for this projection is Orthographic.
t_proj_pconic¶
Autogenerated transformation function for Proj4 projection code pconic.
The full name for this projection is Perspective Conic.
Projection Parameters
- lat_1
- lat_2
t_proj_poly¶
Autogenerated transformation function for Proj4 projection code poly.
The full name for this projection is Polyconic (American).
t_proj_putp1¶
Autogenerated transformation function for Proj4 projection code putp1.
The full name for this projection is Putnins P1.
t_proj_putp2¶
Autogenerated transformation function for Proj4 projection code putp2.
The full name for this projection is Putnins P2.
t_proj_putp3¶
Autogenerated transformation function for Proj4 projection code putp3.
The full name for this projection is Putnins P3.
t_proj_putp3p¶
Autogenerated transformation function for Proj4 projection code putp3p.
The full name for this projection is Putnins P3'.
t_proj_putp4p¶
Autogenerated transformation function for Proj4 projection code putp4p.
The full name for this projection is Putnins P4'.
t_proj_putp5¶
Autogenerated transformation function for Proj4 projection code putp5.
The full name for this projection is Putnins P5.
t_proj_putp5p¶
Autogenerated transformation function for Proj4 projection code putp5p.
The full name for this projection is Putnins P5'.
t_proj_putp6¶
Autogenerated transformation function for Proj4 projection code putp6.
The full name for this projection is Putnins P6.
t_proj_putp6p¶
Autogenerated transformation function for Proj4 projection code putp6p.
The full name for this projection is Putnins P6'.
t_proj_qua_aut¶
Autogenerated transformation function for Proj4 projection code qua_aut.
The full name for this projection is Quartic Authalic.
t_proj_rhealpix¶
Autogenerated transformation function for Proj4 projection code rhealpix.
The full name for this projection is rHEALPix.
Projection Parameters
- npole
- spole
t_proj_robin¶
Autogenerated transformation function for Proj4 projection code robin.
The full name for this projection is Robinson.
t_proj_rouss¶
Autogenerated transformation function for Proj4 projection code rouss.
The full name for this projection is Roussilhe Stereographic.
t_proj_rpoly¶
Autogenerated transformation function for Proj4 projection code rpoly.
The full name for this projection is Rectangular Polyconic.
Projection Parameters
- lat_ts
t_proj_sinu¶
Autogenerated transformation function for Proj4 projection code sinu.
The full name for this projection is Sinusoidal (Sanson-Flamsteed).
t_proj_somerc¶
Autogenerated transformation function for Proj4 projection code somerc.
The full name for this projection is Swiss. Obl. Mercator.
t_proj_stere¶
Autogenerated transformation function for Proj4 projection code stere.
The full name for this projection is Stereographic.
Projection Parameters
- lat_ts
t_proj_sterea¶
Autogenerated transformation function for Proj4 projection code sterea.
The full name for this projection is Oblique Stereographic Alternative.
t_proj_tcc¶
Autogenerated transformation function for Proj4 projection code tcc.
The full name for this projection is Transverse Central Cylindrical.
t_proj_tcea¶
Autogenerated transformation function for Proj4 projection code tcea.
The full name for this projection is Transverse Cylindrical Equal Area.
t_proj_tissot¶
Autogenerated transformation function for Proj4 projection code tissot.
The full name for this projection is Tissot.
Projection Parameters
- lat_1
- lat_2
t_proj_tmerc¶
Autogenerated transformation function for Proj4 projection code tmerc.
The full name for this projection is Transverse Mercator.
t_proj_tpeqd¶
Autogenerated transformation function for Proj4 projection code tpeqd.
The full name for this projection is Two Point Equidistant.
Projection Parameters
- lat_1
- lat_2
- lon_1
- lon_2
t_proj_tpers¶
Autogenerated transformation function for Proj4 projection code tpers.
The full name for this projection is Tilted perspective.
Projection Parameters
- azi
- h
- tilt
t_proj_ups¶
Autogenerated transformation function for Proj4 projection code ups.
The full name for this projection is Universal Polar Stereographic.
Projection Parameters
- south
t_proj_urm5¶
Autogenerated transformation function for Proj4 projection code urm5.
The full name for this projection is Urmaev V.
Projection Parameters
- alphi
- n
- q
t_proj_urmfps¶
Autogenerated transformation function for Proj4 projection code urmfps.
The full name for this projection is Urmaev Flat-Polar Sinusoidal.
Projection Parameters
- n
t_proj_utm¶
Autogenerated transformation function for Proj4 projection code utm.
The full name for this projection is Universal Transverse Mercator (UTM).
Projection Parameters
- south
- zone
t_proj_vandg¶
Autogenerated transformation function for Proj4 projection code vandg.
The full name for this projection is van der Grinten (I).
t_proj_vandg2¶
Autogenerated transformation function for Proj4 projection code vandg2.
The full name for this projection is van der Grinten II.
t_proj_vandg3¶
Autogenerated transformation function for Proj4 projection code vandg3.
The full name for this projection is van der Grinten III.
t_proj_vandg4¶
Autogenerated transformation function for Proj4 projection code vandg4.
The full name for this projection is van der Grinten IV.
t_proj_vitk1¶
Autogenerated transformation function for Proj4 projection code vitk1.
The full name for this projection is Vitkovsky I.
Projection Parameters
- lat_1
- lat_2
t_proj_wag1¶
Autogenerated transformation function for Proj4 projection code wag1.
The full name for this projection is Wagner I (Kavraisky VI).
t_proj_wag2¶
Autogenerated transformation function for Proj4 projection code wag2.
The full name for this projection is Wagner II.
t_proj_wag3¶
Autogenerated transformation function for Proj4 projection code wag3.
The full name for this projection is Wagner III.
Projection Parameters
- lat_ts
t_proj_wag4¶
Autogenerated transformation function for Proj4 projection code wag4.
The full name for this projection is Wagner IV.
t_proj_wag5¶
Autogenerated transformation function for Proj4 projection code wag5.
The full name for this projection is Wagner V.
t_proj_wag6¶
Autogenerated transformation function for Proj4 projection code wag6.
The full name for this projection is Wagner VI.
t_proj_wag7¶
Autogenerated transformation function for Proj4 projection code wag7.
The full name for this projection is Wagner VII.
t_proj_weren¶
Autogenerated transformation function for Proj4 projection code weren.
The full name for this projection is Werenskiold I.
t_proj_wink1¶
Autogenerated transformation function for Proj4 projection code wink1.
The full name for this projection is Winkel I.
Projection Parameters
- lat_ts
t_proj_wink2¶
Autogenerated transformation function for Proj4 projection code wink2.
The full name for this projection is Winkel II.
Projection Parameters
- lat_1
t_proj_wintri¶
Autogenerated transformation function for Proj4 projection code wintri.
The full name for this projection is Winkel Tripel.
Projection Parameters
- lat_1
AUTHOR & MAINTAINER¶
Judd Taylor, Orbital Systems, Ltd. judd dot t at orbitalsystems dot com