.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Proj 3pm"
.TH Proj 3pm "2012-05-30" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
PDL::GIS::Proj \- PDL interface to the Proj4 projection library.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1PDL\s0 interface to the Proj4 projection library.
.PP
For more information on the proj library, see: http://www.remotesensing.org/proj/
.SH "AUTHOR"
.IX Header "AUTHOR"
Judd Taylor, Orbital Systems, Ltd.
judd dot t at orbitalsystems dot com
.SH "DATE"
.IX Header "DATE"
18 March 2003
.SH "CHANGES"
.IX Header "CHANGES"
.SS "1.32 (29 March 2006) Judd Taylor"
.IX Subsection "1.32 (29 March 2006) Judd Taylor"
.Vb 1
\&    \- Getting ready to merge this into the PDL CVS.
.Ve
.SS "1.31 (???) Judd Taylor"
.IX Subsection "1.31 (???) Judd Taylor"
.Vb 1
\&    \- Can\*(Aqt remember what was in that version
.Ve
.SS "1.30 (16 September 2003) Judd Taylor"
.IX Subsection "1.30 (16 September 2003) Judd Taylor"
.Vb 1
\&    \- The get_proj_info() function actually works now.
.Ve
.SS "1.20 (24 April 2003) Judd Taylor"
.IX Subsection "1.20 (24 April 2003) Judd Taylor"
.Vb 1
\&    \- Added get_proj_info().
.Ve
.SS "1.10 (23 April 2003) Judd Taylor"
.IX Subsection "1.10 (23 April 2003) Judd Taylor"
.Vb 2
\&    \- Changed from using the proj_init() type API in projects.h to the
\&    \- proj_init_plus() API in proj_api.h. The old one was not that stable...
.Ve
.SS "1.00 (18 March 2003) Judd Taylor"
.IX Subsection "1.00 (18 March 2003) Judd Taylor"
.Vb 1
\&    \- Initial version
.Ve
.SH "COPYRIGHT NOTICE"
.IX Header "COPYRIGHT NOTICE"
Copyright 2003 Judd Taylor, \s-1USF\s0 Institute for Marine Remote Sensing (judd@marine.usf.edu).
.PP
\&\s-1GPL\s0 Now!
.PP
This program is distributed in the hope that it will be useful,
but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.
.SH "SUBROUTINES"
.IX Header "SUBROUTINES"
.ie n .SS "fwd_transform($lon(pdl), $lat(pdl), $params)"
.el .SS "fwd_transform($lon(pdl), \f(CW$la\fPt(pdl), \f(CW$params\fP)"
.IX Subsection "fwd_transform($lon(pdl), $lat(pdl), $params)"
Proj4 forward transformation \f(CW$params\fR is a string of the projection transformation
parameters.
.PP
Returns two pdls for x and y values respectively. The units are dependant on Proj4
behavior. They will be \s-1PDL\-\s0>null if an error has occurred.
.PP
BadDoc: Ignores bad elements of \f(CW$lat\fR and \f(CW$lon\fR, and sets the corresponding elements 
of \f(CW$x\fR and \f(CW$y\fR to \s-1BAD\s0
.ie n .SS "inv_transform($x(pdl), $y(pdl), $params)"
.el .SS "inv_transform($x(pdl), $y(pdl), \f(CW$params\fP)"
.IX Subsection "inv_transform($x(pdl), $y(pdl), $params)"
Proj4 inverse transformation \f(CW$params\fR is a string of the projection transformation
parameters.
.PP
Returns two pdls for lat and lon values respectively. The units are dependant on Proj4
behavior. They will be \s-1PDL\-\s0>null if an error has occurred.
.PP
BadDoc: Ignores bad elements of \f(CW$lat\fR and \f(CW$lon\fR, and sets the corresponding elements 
of \f(CW$x\fR and \f(CW$y\fR to \s-1BAD\s0
.SS "get_proj_info($params_string)"
.IX Subsection "get_proj_info($params_string)"
Returns a string with information about what parameters proj will
actually use, this includes defaults, and +init=file stuff. It's 
the same as running 'proj \-v'. It uses the proj command line, so
it might not work with all shells. I've tested it with bash.