File: README.html

package info (click to toggle)
python-pyproj 1.8.9-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 9,192 kB
  • sloc: ansic: 10,983; python: 510; makefile: 6
file content (482 lines) | stat: -rw-r--r-- 38,038 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><title>Python: package pyproj</title>
</head><body bgcolor="#f0f0f8">

<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
<tr bgcolor="#7799ee">
<td valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong>pyproj</strong></big></big> (version 1.8.7)</font></td
><td align=right valign=bottom
><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/lib/python2.5/site-packages/pyproj/__init__.py">/usr/local/lib/python2.5/site-packages/pyproj/__init__.py</a></font></td></tr></table>
    <p><tt>Pyrex&nbsp;wrapper&nbsp;to&nbsp;provide&nbsp;python&nbsp;interfaces&nbsp;to<br>
PROJ.4&nbsp;(<a href="http://proj.maptools.org">http://proj.maptools.org</a>)&nbsp;functions.<br>
&nbsp;<br>
Performs&nbsp;cartographic&nbsp;transformations&nbsp;and&nbsp;geodetic&nbsp;computations.<br>
&nbsp;<br>
The&nbsp;<a href="#Proj">Proj</a>&nbsp;class&nbsp;can&nbsp;convert&nbsp;from&nbsp;geographic&nbsp;(longitude,latitude)<br>
to&nbsp;native&nbsp;map&nbsp;projection&nbsp;(x,y)&nbsp;coordinates&nbsp;and&nbsp;vice&nbsp;versa,&nbsp;or<br>
from&nbsp;one&nbsp;map&nbsp;projection&nbsp;coordinate&nbsp;system&nbsp;directly&nbsp;to&nbsp;another.<br>
&nbsp;<br>
The&nbsp;<a href="#Geod">Geod</a>&nbsp;class&nbsp;can&nbsp;perform&nbsp;forward&nbsp;and&nbsp;inverse&nbsp;geodetic,&nbsp;or<br>
Great&nbsp;Circle,&nbsp;computations.&nbsp;&nbsp;The&nbsp;forward&nbsp;computation&nbsp;involves<br>
determining&nbsp;latitude,&nbsp;longitude&nbsp;and&nbsp;back&nbsp;azimuth&nbsp;of&nbsp;a&nbsp;terminus<br>
point&nbsp;given&nbsp;the&nbsp;latitude&nbsp;and&nbsp;longitude&nbsp;of&nbsp;an&nbsp;initial&nbsp;point,&nbsp;plus<br>
azimuth&nbsp;and&nbsp;distance.&nbsp;The&nbsp;inverse&nbsp;computation&nbsp;involves<br>
determining&nbsp;the&nbsp;forward&nbsp;and&nbsp;back&nbsp;azimuths&nbsp;and&nbsp;distance&nbsp;given&nbsp;the<br>
latitudes&nbsp;and&nbsp;longitudes&nbsp;of&nbsp;an&nbsp;initial&nbsp;and&nbsp;terminus&nbsp;point.<br>
&nbsp;<br>
Input&nbsp;coordinates&nbsp;can&nbsp;be&nbsp;given&nbsp;as&nbsp;python&nbsp;arrays,&nbsp;lists/tuples,<br>
scalars&nbsp;or&nbsp;numpy/Numeric/numarray&nbsp;arrays.&nbsp;Optimized&nbsp;for&nbsp;objects<br>
that&nbsp;support&nbsp;the&nbsp;Python&nbsp;buffer&nbsp;protocol&nbsp;(regular&nbsp;python&nbsp;and<br>
numpy&nbsp;array&nbsp;objects).<br>
&nbsp;<br>
Download:&nbsp;<a href="http://code.google.com/p/pyproj/downloads/list">http://code.google.com/p/pyproj/downloads/list</a><br>
&nbsp;<br>
Requirements:&nbsp;python&nbsp;2.4&nbsp;or&nbsp;higher.<br>
&nbsp;<br>
Example&nbsp;scripts&nbsp;are&nbsp;in&nbsp;'test'&nbsp;subdirectory&nbsp;of&nbsp;source&nbsp;distribution.<br>
The&nbsp;'<a href="#-test">test</a>()'&nbsp;function&nbsp;will&nbsp;run&nbsp;the&nbsp;examples&nbsp;in&nbsp;the&nbsp;docstrings.<br>
&nbsp;<br>
Contact:&nbsp;&nbsp;Jeffrey&nbsp;Whitaker&nbsp;&lt;jeffrey.s.whitaker@noaa.gov<br>
&nbsp;<br>
copyright&nbsp;(c)&nbsp;2006&nbsp;by&nbsp;Jeffrey&nbsp;Whitaker.<br>
&nbsp;<br>
Permission&nbsp;to&nbsp;use,&nbsp;copy,&nbsp;modify,&nbsp;and&nbsp;distribute&nbsp;this&nbsp;software<br>
and&nbsp;its&nbsp;documentation&nbsp;for&nbsp;any&nbsp;purpose&nbsp;and&nbsp;without&nbsp;fee&nbsp;is&nbsp;hereby<br>
granted,&nbsp;provided&nbsp;that&nbsp;the&nbsp;above&nbsp;copyright&nbsp;notice&nbsp;appear&nbsp;in&nbsp;all<br>
copies&nbsp;and&nbsp;that&nbsp;both&nbsp;the&nbsp;copyright&nbsp;notice&nbsp;and&nbsp;this&nbsp;permission<br>
notice&nbsp;appear&nbsp;in&nbsp;supporting&nbsp;documentation.&nbsp;THE&nbsp;AUTHOR&nbsp;DISCLAIMS<br>
ALL&nbsp;WARRANTIES&nbsp;WITH&nbsp;REGARD&nbsp;TO&nbsp;THIS&nbsp;SOFTWARE,&nbsp;INCLUDING&nbsp;ALL<br>
IMPLIED&nbsp;WARRANTIES&nbsp;OF&nbsp;MERCHANTABILITY&nbsp;AND&nbsp;FITNESS.&nbsp;IN&nbsp;NO&nbsp;EVENT<br>
SHALL&nbsp;THE&nbsp;AUTHOR&nbsp;BE&nbsp;LIABLE&nbsp;FOR&nbsp;ANY&nbsp;SPECIAL,&nbsp;INDIRECT&nbsp;OR<br>
CONSEQUENTIAL&nbsp;DAMAGES&nbsp;OR&nbsp;ANY&nbsp;DAMAGES&nbsp;WHATSOEVER&nbsp;RESULTING&nbsp;FROM<br>
LOSS&nbsp;OF&nbsp;USE,&nbsp;DATA&nbsp;OR&nbsp;PROFITS,&nbsp;WHETHER&nbsp;IN&nbsp;AN&nbsp;ACTION&nbsp;OF&nbsp;CONTRACT,<br>
NEGLIGENCE&nbsp;OR&nbsp;OTHER&nbsp;TORTIOUS&nbsp;ACTION,&nbsp;ARISING&nbsp;OUT&nbsp;OF&nbsp;OR&nbsp;IN<br>
CONNECTION&nbsp;WITH&nbsp;THE&nbsp;USE&nbsp;OR&nbsp;PERFORMANCE&nbsp;OF&nbsp;THIS&nbsp;SOFTWARE.</tt></p>
<p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#aa55cc">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
    
<tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="pyproj._geod.html">_geod</a><br>
</td><td width="25%" valign=top><a href="pyproj._proj.html">_proj</a><br>
</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ee77aa">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
    
<tr><td bgcolor="#ee77aa"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><dl>
<dt><font face="helvetica, arial">_geod.Geod(<a href="__builtin__.html#object">__builtin__.object</a>)
</font></dt><dd>
<dl>
<dt><font face="helvetica, arial"><a href="pyproj.html#Geod">Geod</a>
</font></dt></dl>
</dd>
<dt><font face="helvetica, arial">_proj.Proj(<a href="__builtin__.html#object">__builtin__.object</a>)
</font></dt><dd>
<dl>
<dt><font face="helvetica, arial"><a href="pyproj.html#Proj">Proj</a>
</font></dt></dl>
</dd>
</dl>
 <p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#000000" face="helvetica, arial"><a name="Geod">class <strong>Geod</strong></a>(_geod.Geod)</font></td></tr>
    
<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
<td colspan=2><tt>performs&nbsp;forward&nbsp;and&nbsp;inverse&nbsp;geodetic,&nbsp;or&nbsp;Great&nbsp;Circle,<br>
computations.&nbsp;&nbsp;The&nbsp;forward&nbsp;computation&nbsp;(using&nbsp;the&nbsp;'fwd'&nbsp;method)<br>
involves&nbsp;determining&nbsp;latitude,&nbsp;longitude&nbsp;and&nbsp;back&nbsp;azimuth&nbsp;of&nbsp;a<br>
terminus&nbsp;point&nbsp;given&nbsp;the&nbsp;latitude&nbsp;and&nbsp;longitude&nbsp;of&nbsp;an&nbsp;initial<br>
point,&nbsp;plus&nbsp;azimuth&nbsp;and&nbsp;distance.&nbsp;The&nbsp;inverse&nbsp;computation&nbsp;(using<br>
the&nbsp;'inv'&nbsp;method)&nbsp;involves&nbsp;determining&nbsp;the&nbsp;forward&nbsp;and&nbsp;back<br>
azimuths&nbsp;and&nbsp;distance&nbsp;given&nbsp;the&nbsp;latitudes&nbsp;and&nbsp;longitudes&nbsp;of&nbsp;an<br>
initial&nbsp;and&nbsp;terminus&nbsp;point.<br>&nbsp;</tt></td></tr>
<tr><td>&nbsp;</td>
<td width="100%"><dl><dt>Method resolution order:</dt>
<dd><a href="pyproj.html#Geod">Geod</a></dd>
<dd>_geod.Geod</dd>
<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
</dl>
<hr>
Methods defined here:<br>
<dl><dt><a name="Geod-fwd"><strong>fwd</strong></a>(self, lons, lats, az, dist, radians<font color="#909090">=False</font>)</dt><dd><tt>forward&nbsp;transformation&nbsp;-&nbsp;Returns&nbsp;longitudes,&nbsp;latitudes&nbsp;and&nbsp;back<br>
azimuths&nbsp;of&nbsp;terminus&nbsp;points&nbsp;given&nbsp;longitudes&nbsp;(lons)&nbsp;and<br>
latitudes&nbsp;(lats)&nbsp;of&nbsp;initial&nbsp;points,&nbsp;plus&nbsp;forward&nbsp;azimuths&nbsp;(az)<br>
and&nbsp;distances&nbsp;(dist).<br>
&nbsp;<br>
Works&nbsp;with&nbsp;numpy&nbsp;and&nbsp;regular&nbsp;python&nbsp;array&nbsp;objects,&nbsp;python<br>
sequences&nbsp;and&nbsp;scalars.<br>
&nbsp;<br>
if&nbsp;radians=True,&nbsp;lons/lats&nbsp;and&nbsp;azimuths&nbsp;are&nbsp;radians&nbsp;instead&nbsp;of<br>
degrees.&nbsp;Distances&nbsp;are&nbsp;in&nbsp;meters.</tt></dd></dl>

<dl><dt><a name="Geod-inv"><strong>inv</strong></a>(self, lons1, lats1, lons2, lats2, radians<font color="#909090">=False</font>)</dt><dd><tt>inverse&nbsp;transformation&nbsp;-&nbsp;Returns&nbsp;forward&nbsp;and&nbsp;back&nbsp;azimuths,&nbsp;plus<br>
distances&nbsp;between&nbsp;initial&nbsp;points&nbsp;(specified&nbsp;by&nbsp;lons1,&nbsp;lats1)&nbsp;and<br>
terminus&nbsp;points&nbsp;(specified&nbsp;by&nbsp;lons2,&nbsp;lats2).<br>
&nbsp;<br>
Works&nbsp;with&nbsp;numpy&nbsp;and&nbsp;regular&nbsp;python&nbsp;array&nbsp;objects,&nbsp;python<br>
sequences&nbsp;and&nbsp;scalars.<br>
&nbsp;<br>
if&nbsp;radians=True,&nbsp;lons/lats&nbsp;and&nbsp;azimuths&nbsp;are&nbsp;radians&nbsp;instead&nbsp;of<br>
degrees.&nbsp;Distances&nbsp;are&nbsp;in&nbsp;meters.</tt></dd></dl>

<dl><dt><a name="Geod-npts"><strong>npts</strong></a>(self, lon1, lat1, lon2, lat2, npts, radians<font color="#909090">=False</font>)</dt><dd><tt>Given&nbsp;a&nbsp;single&nbsp;initial&nbsp;point&nbsp;and&nbsp;terminus&nbsp;point&nbsp;(specified&nbsp;by<br>
python&nbsp;floats&nbsp;lon1,lat1&nbsp;and&nbsp;lon2,lat2),&nbsp;returns&nbsp;a&nbsp;list&nbsp;of<br>
longitude/latitude&nbsp;pairs&nbsp;describing&nbsp;npts&nbsp;equally&nbsp;spaced<br>
intermediate&nbsp;points&nbsp;along&nbsp;the&nbsp;geodesic&nbsp;between&nbsp;the&nbsp;initial&nbsp;and<br>
terminus&nbsp;points.<br>
&nbsp;<br>
if&nbsp;radians=True,&nbsp;lons/lats&nbsp;are&nbsp;radians&nbsp;instead&nbsp;of&nbsp;degrees.<br>
&nbsp;<br>
Example&nbsp;usage:<br>
&nbsp;<br>
&gt;&gt;&gt;&nbsp;from&nbsp;pyproj&nbsp;import&nbsp;<a href="#Geod">Geod</a><br>
&gt;&gt;&gt;&nbsp;g&nbsp;=&nbsp;<a href="#Geod">Geod</a>(ellps='clrk66')&nbsp;#&nbsp;Use&nbsp;Clarke&nbsp;1966&nbsp;ellipsoid.<br>
&gt;&gt;&gt;&nbsp;#&nbsp;specify&nbsp;the&nbsp;lat/lons&nbsp;of&nbsp;Boston&nbsp;and&nbsp;Portland.<br>
&gt;&gt;&gt;&nbsp;boston_lat&nbsp;=&nbsp;42.+(15./60.);&nbsp;boston_lon&nbsp;=&nbsp;-71.-(7./60.)<br>
&gt;&gt;&gt;&nbsp;portland_lat&nbsp;=&nbsp;45.+(31./60.);&nbsp;portland_lon&nbsp;=&nbsp;-123.-(41./60.)<br>
&gt;&gt;&gt;&nbsp;#&nbsp;find&nbsp;ten&nbsp;equally&nbsp;spaced&nbsp;points&nbsp;between&nbsp;Boston&nbsp;and&nbsp;Portland.<br>
&gt;&gt;&gt;&nbsp;lonlats&nbsp;=&nbsp;g.<a href="#Geod-npts">npts</a>(boston_lon,boston_lat,portland_lon,portland_lat,10)<br>
&gt;&gt;&gt;&nbsp;for&nbsp;lon,lat&nbsp;in&nbsp;lonlats:&nbsp;print&nbsp;'%6.3f&nbsp;&nbsp;%7.3f'&nbsp;%&nbsp;(lat,&nbsp;lon)<br>
43.528&nbsp;&nbsp;-75.414<br>
44.637&nbsp;&nbsp;-79.883<br>
45.565&nbsp;&nbsp;-84.512<br>
46.299&nbsp;&nbsp;-89.279<br>
46.830&nbsp;&nbsp;-94.156<br>
47.149&nbsp;&nbsp;-99.112<br>
47.251&nbsp;&nbsp;-104.106<br>
47.136&nbsp;&nbsp;-109.100<br>
46.805&nbsp;&nbsp;-114.051<br>
46.262&nbsp;&nbsp;-118.924</tt></dd></dl>

<hr>
Static methods defined here:<br>
<dl><dt><a name="Geod-__new__"><strong>__new__</strong></a>(self, initparams<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>initialize&nbsp;a&nbsp;<a href="#Geod">Geod</a>&nbsp;class&nbsp;instance.<br>
&nbsp;<br>
Geodetic&nbsp;parameters&nbsp;for&nbsp;specifying&nbsp;the&nbsp;ellipsoid<br>
can&nbsp;be&nbsp;given&nbsp;in&nbsp;a&nbsp;dictionary&nbsp;'initparams',&nbsp;as&nbsp;keyword&nbsp;arguments,&nbsp;<br>
or&nbsp;as&nbsp;as&nbsp;proj4&nbsp;geod&nbsp;initialization&nbsp;string.<br>
Following&nbsp;is&nbsp;a&nbsp;list&nbsp;of&nbsp;the&nbsp;ellipsoids&nbsp;that&nbsp;may&nbsp;be&nbsp;defined&nbsp;using&nbsp;the&nbsp;<br>
'ellps'&nbsp;keyword:<br>
&nbsp;<br>
&nbsp;&nbsp;&nbsp;MERIT&nbsp;a=6378137.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.257&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;MERIT&nbsp;1983<br>
&nbsp;&nbsp;&nbsp;SGS85&nbsp;a=6378136.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.257&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Soviet&nbsp;Geodetic&nbsp;System&nbsp;85<br>
&nbsp;&nbsp;&nbsp;GRS80&nbsp;a=6378137.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.257222101&nbsp;GRS&nbsp;1980(IUGG,&nbsp;1980)<br>
&nbsp;&nbsp;&nbsp;IAU76&nbsp;a=6378140.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.257&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;IAU&nbsp;1976<br>
&nbsp;&nbsp;&nbsp;&nbsp;airy&nbsp;a=6377563.396&nbsp;&nbsp;&nbsp;&nbsp;b=6356256.910&nbsp;&nbsp;&nbsp;&nbsp;Airy&nbsp;1830<br>
&nbsp;&nbsp;APL4.9&nbsp;a=6378137.0.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.25&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appl.&nbsp;Physics.&nbsp;1965<br>
&nbsp;&nbsp;&nbsp;NWL9D&nbsp;a=6378145.0.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.25&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Naval&nbsp;Weapons&nbsp;Lab.,&nbsp;1965<br>
mod_airy&nbsp;a=6377340.189&nbsp;&nbsp;&nbsp;&nbsp;b=6356034.446&nbsp;&nbsp;&nbsp;&nbsp;Modified&nbsp;Airy<br>
&nbsp;&nbsp;andrae&nbsp;a=6377104.43&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=300.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Andrae&nbsp;1876&nbsp;(Den.,&nbsp;Iclnd.)<br>
&nbsp;aust_SA&nbsp;a=6378160.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.25&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Australian&nbsp;Natl&nbsp;&amp;&nbsp;S.&nbsp;Amer.&nbsp;1969<br>
&nbsp;&nbsp;&nbsp;GRS67&nbsp;a=6378160.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.2471674270&nbsp;GRS&nbsp;67(IUGG&nbsp;1967)<br>
&nbsp;&nbsp;bessel&nbsp;a=6377397.155&nbsp;&nbsp;&nbsp;&nbsp;rf=299.1528128&nbsp;&nbsp;&nbsp;Bessel&nbsp;1841<br>
bess_nam&nbsp;a=6377483.865&nbsp;&nbsp;&nbsp;&nbsp;rf=299.1528128&nbsp;&nbsp;&nbsp;Bessel&nbsp;1841&nbsp;(Namibia)<br>
&nbsp;&nbsp;clrk66&nbsp;a=6378206.4&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b=6356583.8&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Clarke&nbsp;1866<br>
&nbsp;&nbsp;clrk80&nbsp;a=6378249.145&nbsp;&nbsp;&nbsp;&nbsp;rf=293.4663&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Clarke&nbsp;1880&nbsp;mod.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CPM&nbsp;a=6375738.7&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=334.29&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Comm.&nbsp;des&nbsp;Poids&nbsp;et&nbsp;Mesures&nbsp;1799<br>
&nbsp;&nbsp;delmbr&nbsp;a=6376428.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=311.5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Delambre&nbsp;1810&nbsp;(Belgium)<br>
&nbsp;engelis&nbsp;a=6378136.05&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.2566&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Engelis&nbsp;1985<br>
&nbsp;evrst30&nbsp;a=6377276.345&nbsp;&nbsp;&nbsp;&nbsp;rf=300.8017&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Everest&nbsp;1830<br>
&nbsp;evrst48&nbsp;a=6377304.063&nbsp;&nbsp;&nbsp;&nbsp;rf=300.8017&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Everest&nbsp;1948<br>
&nbsp;evrst56&nbsp;a=6377301.243&nbsp;&nbsp;&nbsp;&nbsp;rf=300.8017&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Everest&nbsp;1956<br>
&nbsp;evrst69&nbsp;a=6377295.664&nbsp;&nbsp;&nbsp;&nbsp;rf=300.8017&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Everest&nbsp;1969<br>
&nbsp;evrstSS&nbsp;a=6377298.556&nbsp;&nbsp;&nbsp;&nbsp;rf=300.8017&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Everest&nbsp;(Sabah&nbsp;&amp;&nbsp;Sarawak)<br>
&nbsp;fschr60&nbsp;a=6378166.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Fischer&nbsp;(Mercury&nbsp;Datum)&nbsp;1960<br>
fschr60m&nbsp;a=6378155.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Modified&nbsp;Fischer&nbsp;1960<br>
&nbsp;fschr68&nbsp;a=6378150.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Fischer&nbsp;1968<br>
&nbsp;helmert&nbsp;a=6378200.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Helmert&nbsp;1906<br>
&nbsp;&nbsp;&nbsp;hough&nbsp;a=6378270.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=297.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Hough<br>
&nbsp;&nbsp;&nbsp;&nbsp;intl&nbsp;a=6378388.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=297.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;International&nbsp;1909&nbsp;(Hayford)<br>
&nbsp;&nbsp;&nbsp;krass&nbsp;a=6378245.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Krassovsky,&nbsp;1942<br>
&nbsp;&nbsp;&nbsp;kaula&nbsp;a=6378163.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.24&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Kaula&nbsp;1961<br>
&nbsp;&nbsp;&nbsp;lerch&nbsp;a=6378139.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.257&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Lerch&nbsp;1979<br>
&nbsp;&nbsp;&nbsp;mprts&nbsp;a=6397300.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=191.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Maupertius&nbsp;1738<br>
new_intl&nbsp;a=6378157.5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b=6356772.2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;New&nbsp;International&nbsp;1967<br>
&nbsp;plessis&nbsp;a=6376523.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b=6355863.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Plessis&nbsp;1817&nbsp;(France)<br>
&nbsp;&nbsp;SEasia&nbsp;a=6378155.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b=6356773.3205&nbsp;&nbsp;&nbsp;Southeast&nbsp;Asia<br>
&nbsp;walbeck&nbsp;a=6376896.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b=6355834.8467&nbsp;&nbsp;&nbsp;Walbeck<br>
&nbsp;&nbsp;&nbsp;WGS60&nbsp;a=6378165.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WGS&nbsp;60<br>
&nbsp;&nbsp;&nbsp;WGS66&nbsp;a=6378145.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.25&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WGS&nbsp;66<br>
&nbsp;&nbsp;&nbsp;WGS72&nbsp;a=6378135.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.26&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WGS&nbsp;72<br>
&nbsp;&nbsp;&nbsp;WGS84&nbsp;a=6378137.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rf=298.257223563&nbsp;WGS&nbsp;84<br>
&nbsp;&nbsp;sphere&nbsp;a=6370997.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b=6370997.0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Normal&nbsp;Sphere&nbsp;(r=6370997)<br>
&nbsp;<br>
The&nbsp;parameters&nbsp;of&nbsp;the&nbsp;ellipsoid&nbsp;may&nbsp;also&nbsp;be&nbsp;set&nbsp;directly&nbsp;using<br>
the&nbsp;'a'&nbsp;(semi-major&nbsp;or&nbsp;equatorial&nbsp;axis&nbsp;radius)&nbsp;keyword,&nbsp;and<br>
any&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;keywords:&nbsp;'b'&nbsp;(semi-minor,<br>
or&nbsp;polar&nbsp;axis&nbsp;radius),&nbsp;'e'&nbsp;(eccentricity),&nbsp;'es'&nbsp;(eccentricity<br>
squared),&nbsp;'f'&nbsp;(flattening),&nbsp;or&nbsp;'rf'&nbsp;(reciprocal&nbsp;flattening).<br>
&nbsp;<br>
See&nbsp;the&nbsp;proj&nbsp;documentation&nbsp;(<a href="http://proj.maptools.org">http://proj.maptools.org</a>)&nbsp;for&nbsp;more<br>
information&nbsp;about&nbsp;specifying&nbsp;ellipsoid&nbsp;parameters&nbsp;(specifically,<br>
the&nbsp;chapter&nbsp;'Specifying&nbsp;the&nbsp;Earth's&nbsp;figure'&nbsp;in&nbsp;the&nbsp;main&nbsp;<a href="#Proj">Proj</a><br>
users&nbsp;manual).<br>
&nbsp;<br>
Example&nbsp;usage:<br>
&nbsp;<br>
&gt;&gt;&gt;&nbsp;from&nbsp;pyproj&nbsp;import&nbsp;<a href="#Geod">Geod</a><br>
&gt;&gt;&gt;&nbsp;g&nbsp;=&nbsp;<a href="#Geod">Geod</a>(ellps='clrk66')&nbsp;#&nbsp;Use&nbsp;Clarke&nbsp;1966&nbsp;ellipsoid.<br>
&gt;&gt;&gt;&nbsp;#&nbsp;specify&nbsp;the&nbsp;lat/lons&nbsp;of&nbsp;some&nbsp;cities.<br>
&gt;&gt;&gt;&nbsp;boston_lat&nbsp;=&nbsp;42.+(15./60.);&nbsp;boston_lon&nbsp;=&nbsp;-71.-(7./60.)<br>
&gt;&gt;&gt;&nbsp;portland_lat&nbsp;=&nbsp;45.+(31./60.);&nbsp;portland_lon&nbsp;=&nbsp;-123.-(41./60.)<br>
&gt;&gt;&gt;&nbsp;newyork_lat&nbsp;=&nbsp;40.+(47./60.);&nbsp;newyork_lon&nbsp;=&nbsp;-73.-(58./60.)<br>
&gt;&gt;&gt;&nbsp;london_lat&nbsp;=&nbsp;51.+(32./60.);&nbsp;london_lon&nbsp;=&nbsp;-(5./60.)<br>
&gt;&gt;&gt;&nbsp;#&nbsp;compute&nbsp;forward&nbsp;and&nbsp;back&nbsp;azimuths,&nbsp;plus&nbsp;distance<br>
&gt;&gt;&gt;&nbsp;#&nbsp;between&nbsp;Boston&nbsp;and&nbsp;Portland.<br>
&gt;&gt;&gt;&nbsp;az12,az21,dist&nbsp;=&nbsp;g.<a href="#Geod-inv">inv</a>(boston_lon,boston_lat,portland_lon,portland_lat)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;"%7.3f&nbsp;%6.3f&nbsp;%12.3f"&nbsp;%&nbsp;(az12,az21,dist)<br>
-66.531&nbsp;75.654&nbsp;&nbsp;4164192.708<br>
&gt;&gt;&gt;&nbsp;#&nbsp;compute&nbsp;latitude,&nbsp;longitude&nbsp;and&nbsp;back&nbsp;azimuth&nbsp;of&nbsp;Portland,<br>
&gt;&gt;&gt;&nbsp;#&nbsp;given&nbsp;Boston&nbsp;lat/lon,&nbsp;forward&nbsp;azimuth&nbsp;and&nbsp;distance&nbsp;to&nbsp;Portland.<br>
&gt;&gt;&gt;&nbsp;endlon,&nbsp;endlat,&nbsp;backaz&nbsp;=&nbsp;g.<a href="#Geod-fwd">fwd</a>(boston_lon,&nbsp;boston_lat,&nbsp;az12,&nbsp;dist)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;"%6.3f&nbsp;&nbsp;%6.3f&nbsp;%13.3f"&nbsp;%&nbsp;(endlat,endlon,backaz)<br>
45.517&nbsp;&nbsp;-123.683&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;75.654<br>
&gt;&gt;&gt;&nbsp;#&nbsp;compute&nbsp;the&nbsp;azimuths,&nbsp;distances&nbsp;from&nbsp;New&nbsp;York&nbsp;to&nbsp;several<br>
&gt;&gt;&gt;&nbsp;#&nbsp;cities&nbsp;(pass&nbsp;a&nbsp;list)<br>
&gt;&gt;&gt;&nbsp;lons1&nbsp;=&nbsp;3*[newyork_lon];&nbsp;lats1&nbsp;=&nbsp;3*[newyork_lat]<br>
&gt;&gt;&gt;&nbsp;lons2&nbsp;=&nbsp;[boston_lon,&nbsp;portland_lon,&nbsp;london_lon]<br>
&gt;&gt;&gt;&nbsp;lats2&nbsp;=&nbsp;[boston_lat,&nbsp;portland_lat,&nbsp;london_lat]<br>
&gt;&gt;&gt;&nbsp;az12,az21,dist&nbsp;=&nbsp;g.<a href="#Geod-inv">inv</a>(lons1,lats1,lons2,lats2)<br>
&gt;&gt;&gt;&nbsp;for&nbsp;faz,baz,d&nbsp;in&nbsp;zip(az12,az21,dist):&nbsp;print&nbsp;"%7.3f&nbsp;%7.3f&nbsp;%9.3f"&nbsp;%&nbsp;(faz,baz,d)<br>
&nbsp;54.663&nbsp;-123.448&nbsp;288303.720<br>
-65.463&nbsp;&nbsp;79.342&nbsp;4013037.318<br>
&nbsp;51.254&nbsp;-71.576&nbsp;5579916.649<br>
&gt;&gt;&gt;&nbsp;g2&nbsp;=&nbsp;<a href="#Geod">Geod</a>('+ellps=clrk66')&nbsp;#&nbsp;use&nbsp;proj4&nbsp;style&nbsp;initialization&nbsp;string<br>
&gt;&gt;&gt;&nbsp;az12,az21,dist&nbsp;=&nbsp;g2.<a href="#Geod-inv">inv</a>(boston_lon,boston_lat,portland_lon,portland_lat)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;"%7.3f&nbsp;%6.3f&nbsp;%12.3f"&nbsp;%&nbsp;(az12,az21,dist)<br>
-66.531&nbsp;75.654&nbsp;&nbsp;4164192.708</tt></dd></dl>

<hr>
Data descriptors defined here:<br>
<dl><dt><strong>__dict__</strong></dt>
<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<dl><dt><strong>__weakref__</strong></dt>
<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<hr>
Methods inherited from _geod.Geod:<br>
<dl><dt><a name="Geod-__reduce__"><strong>__reduce__</strong></a>(...)</dt><dd><tt>special&nbsp;method&nbsp;that&nbsp;allows&nbsp;pyproj.<a href="#Geod">Geod</a>&nbsp;instance&nbsp;to&nbsp;be&nbsp;pickled</tt></dd></dl>

<hr>
Data descriptors inherited from _geod.Geod:<br>
<dl><dt><strong>geodstring</strong></dt>
</dl>
<dl><dt><strong>proj_version</strong></dt>
</dl>
</td></tr></table> <p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#000000" face="helvetica, arial"><a name="Proj">class <strong>Proj</strong></a>(_proj.Proj)</font></td></tr>
    
<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
<td colspan=2><tt>performs&nbsp;cartographic&nbsp;transformations&nbsp;(converts&nbsp;from<br>
longitude,latitude&nbsp;to&nbsp;native&nbsp;map&nbsp;projection&nbsp;x,y&nbsp;coordinates&nbsp;and<br>
vice&nbsp;versa)&nbsp;using&nbsp;proj&nbsp;(<a href="http://proj.maptools.org/">http://proj.maptools.org/</a>)<br>
&nbsp;<br>
A&nbsp;<a href="#Proj">Proj</a>&nbsp;class&nbsp;instance&nbsp;is&nbsp;initialized&nbsp;with&nbsp;proj&nbsp;map&nbsp;projection<br>
control&nbsp;parameter&nbsp;key/value&nbsp;pairs.&nbsp;The&nbsp;key/value&nbsp;pairs&nbsp;can<br>
either&nbsp;be&nbsp;passed&nbsp;in&nbsp;a&nbsp;dictionary,&nbsp;or&nbsp;as&nbsp;keyword&nbsp;arguments,<br>
or&nbsp;as&nbsp;a&nbsp;proj4&nbsp;string&nbsp;(compatible&nbsp;with&nbsp;the&nbsp;proj&nbsp;command).&nbsp;See<br>
<a href="http://www.remotesensing.org/geotiff/proj_list">http://www.remotesensing.org/geotiff/proj_list</a>&nbsp;for&nbsp;examples&nbsp;of<br>
key/value&nbsp;pairs&nbsp;defining&nbsp;different&nbsp;map&nbsp;projections.<br>
&nbsp;<br>
Calling&nbsp;a&nbsp;<a href="#Proj">Proj</a>&nbsp;class&nbsp;instance&nbsp;with&nbsp;the&nbsp;arguments&nbsp;lon,&nbsp;lat&nbsp;will<br>
convert&nbsp;lon/lat&nbsp;(in&nbsp;degrees)&nbsp;to&nbsp;x/y&nbsp;native&nbsp;map&nbsp;projection<br>
coordinates&nbsp;(in&nbsp;meters).&nbsp;&nbsp;If&nbsp;optional&nbsp;keyword&nbsp;'inverse'&nbsp;is&nbsp;True<br>
(default&nbsp;is&nbsp;False),&nbsp;the&nbsp;inverse&nbsp;transformation&nbsp;from&nbsp;x/y&nbsp;to<br>
lon/lat&nbsp;is&nbsp;performed.&nbsp;If&nbsp;optional&nbsp;keyword&nbsp;'radians'&nbsp;is&nbsp;True<br>
(default&nbsp;is&nbsp;False)&nbsp;lon/lat&nbsp;are&nbsp;interpreted&nbsp;as&nbsp;radians&nbsp;instead&nbsp;of<br>
degrees.&nbsp;If&nbsp;optional&nbsp;keyword&nbsp;'errcheck'&nbsp;is&nbsp;True&nbsp;(default&nbsp;is<br>
False)&nbsp;an&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;transformation&nbsp;is&nbsp;invalid.<br>
If&nbsp;errcheck=False&nbsp;and&nbsp;the&nbsp;transformation&nbsp;is&nbsp;invalid,&nbsp;no<br>
exception&nbsp;is&nbsp;raised&nbsp;and&nbsp;1.e30&nbsp;is&nbsp;returned.&nbsp;If&nbsp;the&nbsp;optional&nbsp;keyword<br>
'preserve_units'&nbsp;is&nbsp;True,&nbsp;the&nbsp;units&nbsp;in&nbsp;map&nbsp;projection&nbsp;coordinates<br>
are&nbsp;not&nbsp;forced&nbsp;to&nbsp;be&nbsp;meters.<br>
&nbsp;<br>
Works&nbsp;with&nbsp;numpy&nbsp;and&nbsp;regular&nbsp;python&nbsp;array&nbsp;objects,&nbsp;python<br>
sequences&nbsp;and&nbsp;scalars.<br>&nbsp;</tt></td></tr>
<tr><td>&nbsp;</td>
<td width="100%"><dl><dt>Method resolution order:</dt>
<dd><a href="pyproj.html#Proj">Proj</a></dd>
<dd>_proj.Proj</dd>
<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
</dl>
<hr>
Methods defined here:<br>
<dl><dt><a name="Proj-__call__"><strong>__call__</strong></a>(self, *args, **kw)</dt><dd><tt>Calling&nbsp;a&nbsp;<a href="#Proj">Proj</a>&nbsp;class&nbsp;instance&nbsp;with&nbsp;the&nbsp;arguments&nbsp;lon,&nbsp;lat&nbsp;will<br>
convert&nbsp;lon/lat&nbsp;(in&nbsp;degrees)&nbsp;to&nbsp;x/y&nbsp;native&nbsp;map&nbsp;projection<br>
coordinates&nbsp;(in&nbsp;meters).&nbsp;&nbsp;If&nbsp;optional&nbsp;keyword&nbsp;'inverse'&nbsp;is&nbsp;True<br>
(default&nbsp;is&nbsp;False),&nbsp;the&nbsp;inverse&nbsp;transformation&nbsp;from&nbsp;x/y&nbsp;to<br>
lon/lat&nbsp;is&nbsp;performed.&nbsp;&nbsp;If&nbsp;optional&nbsp;keyword&nbsp;'radians'&nbsp;is&nbsp;True<br>
(default&nbsp;is&nbsp;False)&nbsp;the&nbsp;units&nbsp;of&nbsp;lon/lat&nbsp;are&nbsp;radians&nbsp;instead&nbsp;of<br>
degrees.&nbsp;If&nbsp;optional&nbsp;keyword&nbsp;'errcheck'&nbsp;is&nbsp;True&nbsp;(default&nbsp;is<br>
False)&nbsp;an&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;transformation&nbsp;is&nbsp;invalid.<br>
If&nbsp;errcheck=False&nbsp;and&nbsp;the&nbsp;transformation&nbsp;is&nbsp;invalid,&nbsp;no<br>
exception&nbsp;is&nbsp;raised&nbsp;and&nbsp;1.e30&nbsp;is&nbsp;returned.<br>
&nbsp;<br>
Instead&nbsp;of&nbsp;calling&nbsp;with&nbsp;lon,&nbsp;lat,&nbsp;a&nbsp;single&nbsp;ndarray&nbsp;of<br>
shape&nbsp;n,2&nbsp;may&nbsp;be&nbsp;used,&nbsp;and&nbsp;one&nbsp;of&nbsp;the&nbsp;same&nbsp;shape&nbsp;will<br>
be&nbsp;returned;&nbsp;this&nbsp;is&nbsp;more&nbsp;efficient.<br>
&nbsp;<br>
Inputs&nbsp;should&nbsp;be&nbsp;doubles&nbsp;(they&nbsp;will&nbsp;be&nbsp;cast&nbsp;to&nbsp;doubles&nbsp;if&nbsp;they<br>
are&nbsp;not,&nbsp;causing&nbsp;a&nbsp;slight&nbsp;performance&nbsp;hit).<br>
&nbsp;<br>
Works&nbsp;with&nbsp;numpy&nbsp;and&nbsp;regular&nbsp;python&nbsp;array&nbsp;objects,&nbsp;python<br>
sequences&nbsp;and&nbsp;scalars,&nbsp;but&nbsp;is&nbsp;fastest&nbsp;for&nbsp;array&nbsp;objects.</tt></dd></dl>

<dl><dt><a name="Proj-is_geocent"><strong>is_geocent</strong></a>(self)</dt><dd><tt>returns&nbsp;True&nbsp;if&nbsp;projection&nbsp;in&nbsp;geocentric&nbsp;(x/y)&nbsp;coordinates</tt></dd></dl>

<dl><dt><a name="Proj-is_latlong"><strong>is_latlong</strong></a>(self)</dt><dd><tt>returns&nbsp;True&nbsp;if&nbsp;projection&nbsp;in&nbsp;geographic&nbsp;(lon/lat)&nbsp;coordinates</tt></dd></dl>

<hr>
Static methods defined here:<br>
<dl><dt><a name="Proj-__new__"><strong>__new__</strong></a>(self, projparams<font color="#909090">=None</font>, preserve_units<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>initialize&nbsp;a&nbsp;<a href="#Proj">Proj</a>&nbsp;class&nbsp;instance.<br>
&nbsp;<br>
Proj4&nbsp;projection&nbsp;control&nbsp;parameters&nbsp;must&nbsp;either&nbsp;be&nbsp;given&nbsp;in&nbsp;a<br>
dictionary&nbsp;'projparams'&nbsp;or&nbsp;as&nbsp;keyword&nbsp;arguments.&nbsp;See&nbsp;the&nbsp;proj<br>
documentation&nbsp;(<a href="http://proj.maptools.org">http://proj.maptools.org</a>)&nbsp;for&nbsp;more&nbsp;information<br>
about&nbsp;specifying&nbsp;projection&nbsp;parameters.<br>
&nbsp;<br>
Example&nbsp;usage:<br>
&nbsp;<br>
&gt;&gt;&gt;&nbsp;from&nbsp;pyproj&nbsp;import&nbsp;<a href="#Proj">Proj</a><br>
&gt;&gt;&gt;&nbsp;p&nbsp;=&nbsp;<a href="#Proj">Proj</a>(proj='utm',zone=10,ellps='WGS84')&nbsp;#&nbsp;use&nbsp;kwargs<br>
&gt;&gt;&gt;&nbsp;x,y&nbsp;=&nbsp;p(-120.108,&nbsp;34.36116666)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'x=%9.3f&nbsp;y=%11.3f'&nbsp;%&nbsp;(x,y)<br>
x=765975.641&nbsp;y=3805993.134<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'lon=%8.3f&nbsp;lat=%5.3f'&nbsp;%&nbsp;p(x,y,inverse=True)<br>
lon=-120.108&nbsp;lat=34.361<br>
&gt;&gt;&gt;&nbsp;#&nbsp;do&nbsp;3&nbsp;cities&nbsp;at&nbsp;a&nbsp;time&nbsp;in&nbsp;a&nbsp;tuple&nbsp;(Fresno,&nbsp;LA,&nbsp;SF)<br>
&gt;&gt;&gt;&nbsp;lons&nbsp;=&nbsp;(-119.72,-118.40,-122.38)<br>
&gt;&gt;&gt;&nbsp;lats&nbsp;=&nbsp;(36.77,&nbsp;33.93,&nbsp;37.62&nbsp;)<br>
&gt;&gt;&gt;&nbsp;x,y&nbsp;=&nbsp;p(lons,&nbsp;lats)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'x:&nbsp;%9.3f&nbsp;%9.3f&nbsp;%9.3f'&nbsp;%&nbsp;x<br>
x:&nbsp;792763.863&nbsp;925321.537&nbsp;554714.301<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'y:&nbsp;%9.3f&nbsp;%9.3f&nbsp;%9.3f'&nbsp;%&nbsp;y<br>
y:&nbsp;4074377.617&nbsp;3763936.941&nbsp;4163835.303<br>
&gt;&gt;&gt;&nbsp;lons,&nbsp;lats&nbsp;=&nbsp;p(x,&nbsp;y,&nbsp;inverse=True)&nbsp;#&nbsp;inverse&nbsp;transform<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'lons:&nbsp;%8.3f&nbsp;%8.3f&nbsp;%8.3f'&nbsp;%&nbsp;lons<br>
lons:&nbsp;-119.720&nbsp;-118.400&nbsp;-122.380<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'lats:&nbsp;%8.3f&nbsp;%8.3f&nbsp;%8.3f'&nbsp;%&nbsp;lats<br>
lats:&nbsp;&nbsp;&nbsp;36.770&nbsp;&nbsp;&nbsp;33.930&nbsp;&nbsp;&nbsp;37.620<br>
&gt;&gt;&gt;&nbsp;p2&nbsp;=&nbsp;<a href="#Proj">Proj</a>('+proj=utm&nbsp;+zone=10&nbsp;+ellps=WGS84')&nbsp;#&nbsp;use&nbsp;proj4&nbsp;string<br>
&gt;&gt;&gt;&nbsp;x,y&nbsp;=&nbsp;p2(-120.108,&nbsp;34.36116666)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'x=%9.3f&nbsp;y=%11.3f'&nbsp;%&nbsp;(x,y)<br>
x=765975.641&nbsp;y=3805993.134<br>
&gt;&gt;&gt;&nbsp;p&nbsp;=&nbsp;<a href="#Proj">Proj</a>(init="epsg:32667")<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'x=%12.3f&nbsp;y=%12.3f&nbsp;(meters)'&nbsp;%&nbsp;p(-114.057222,&nbsp;51.045)<br>
x=-1783486.760&nbsp;y=&nbsp;6193833.196&nbsp;(meters)<br>
&gt;&gt;&gt;&nbsp;p&nbsp;=&nbsp;<a href="#Proj">Proj</a>("+init=epsg:32667",preserve_units=True)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'x=%12.3f&nbsp;y=%12.3f&nbsp;(feet)'&nbsp;%&nbsp;p(-114.057222,&nbsp;51.045)<br>
x=-5851322.810&nbsp;y=20320934.409&nbsp;(feet)</tt></dd></dl>

<hr>
Data descriptors defined here:<br>
<dl><dt><strong>__dict__</strong></dt>
<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<dl><dt><strong>__weakref__</strong></dt>
<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<hr>
Methods inherited from _proj.Proj:<br>
<dl><dt><a name="Proj-__reduce__"><strong>__reduce__</strong></a>(...)</dt><dd><tt>special&nbsp;method&nbsp;that&nbsp;allows&nbsp;pyproj.<a href="#Proj">Proj</a>&nbsp;instance&nbsp;to&nbsp;be&nbsp;pickled</tt></dd></dl>

<hr>
Data descriptors inherited from _proj.Proj:<br>
<dl><dt><strong>proj_version</strong></dt>
</dl>
<dl><dt><strong>srs</strong></dt>
</dl>
</td></tr></table></td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#eeaa77">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
    
<tr><td bgcolor="#eeaa77"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><dl><dt><a name="-set_datapath"><strong>set_datapath</strong></a>(...)</dt></dl>
 <dl><dt><a name="-test"><strong>test</strong></a>()</dt><dd><tt>run&nbsp;the&nbsp;examples&nbsp;in&nbsp;the&nbsp;docstrings&nbsp;using&nbsp;the&nbsp;doctest&nbsp;module</tt></dd></dl>
 <dl><dt><a name="-transform"><strong>transform</strong></a>(p1, p2, x, y, z<font color="#909090">=None</font>, radians<font color="#909090">=False</font>)</dt><dd><tt>x2,&nbsp;y2,&nbsp;z2&nbsp;=&nbsp;<a href="#-transform">transform</a>(p1,&nbsp;p2,&nbsp;x1,&nbsp;y1,&nbsp;z1,&nbsp;radians=False)<br>
&nbsp;<br>
Transform&nbsp;points&nbsp;between&nbsp;two&nbsp;coordinate&nbsp;systems&nbsp;defined&nbsp;by&nbsp;the<br>
<a href="#Proj">Proj</a>&nbsp;instances&nbsp;p1&nbsp;and&nbsp;p2.<br>
&nbsp;<br>
The&nbsp;points&nbsp;x1,y1,z1&nbsp;in&nbsp;the&nbsp;coordinate&nbsp;system&nbsp;defined&nbsp;by&nbsp;p1&nbsp;are<br>
transformed&nbsp;to&nbsp;x2,y2,z2&nbsp;in&nbsp;the&nbsp;coordinate&nbsp;system&nbsp;defined&nbsp;by&nbsp;p2.<br>
&nbsp;<br>
z1&nbsp;is&nbsp;optional,&nbsp;if&nbsp;it&nbsp;is&nbsp;not&nbsp;set&nbsp;it&nbsp;is&nbsp;assumed&nbsp;to&nbsp;be&nbsp;zero&nbsp;(and<br>
only&nbsp;x2&nbsp;and&nbsp;y2&nbsp;are&nbsp;returned).<br>
&nbsp;<br>
In&nbsp;addition&nbsp;to&nbsp;converting&nbsp;between&nbsp;cartographic&nbsp;and&nbsp;geographic<br>
projection&nbsp;coordinates,&nbsp;this&nbsp;function&nbsp;can&nbsp;take&nbsp;care&nbsp;of&nbsp;datum<br>
shifts&nbsp;(which&nbsp;cannot&nbsp;be&nbsp;done&nbsp;using&nbsp;the&nbsp;__call__&nbsp;method&nbsp;of&nbsp;the<br>
<a href="#Proj">Proj</a>&nbsp;instances).&nbsp;It&nbsp;also&nbsp;allows&nbsp;for&nbsp;one&nbsp;of&nbsp;the&nbsp;coordinate<br>
systems&nbsp;to&nbsp;be&nbsp;geographic&nbsp;(proj&nbsp;=&nbsp;'latlong').<br>
&nbsp;<br>
If&nbsp;optional&nbsp;keyword&nbsp;'radians'&nbsp;is&nbsp;True&nbsp;(default&nbsp;is&nbsp;False)&nbsp;and&nbsp;p1<br>
is&nbsp;defined&nbsp;in&nbsp;geographic&nbsp;coordinate&nbsp;(pj.is_latlong()&nbsp;is&nbsp;True),<br>
x1,y1&nbsp;is&nbsp;interpreted&nbsp;as&nbsp;radians&nbsp;instead&nbsp;of&nbsp;the&nbsp;default&nbsp;degrees.<br>
Similarly,&nbsp;if&nbsp;p2&nbsp;is&nbsp;defined&nbsp;in&nbsp;geographic&nbsp;coordinates&nbsp;and<br>
radians=True,&nbsp;x2,&nbsp;y2&nbsp;are&nbsp;returned&nbsp;in&nbsp;radians&nbsp;instead&nbsp;of&nbsp;degrees.<br>
if&nbsp;p1.is_latlong()&nbsp;and&nbsp;p2.is_latlong()&nbsp;both&nbsp;are&nbsp;False,&nbsp;the<br>
radians&nbsp;keyword&nbsp;has&nbsp;no&nbsp;effect.<br>
&nbsp;<br>
x,y&nbsp;and&nbsp;z&nbsp;can&nbsp;be&nbsp;numpy&nbsp;or&nbsp;regular&nbsp;python&nbsp;arrays,&nbsp;python<br>
lists/tuples&nbsp;or&nbsp;scalars.&nbsp;Arrays&nbsp;are&nbsp;fastest.&nbsp;&nbsp;For&nbsp;projections&nbsp;in<br>
geocentric&nbsp;coordinates,&nbsp;values&nbsp;of&nbsp;x&nbsp;and&nbsp;y&nbsp;are&nbsp;given&nbsp;in&nbsp;meters.<br>
z&nbsp;is&nbsp;always&nbsp;meters.<br>
&nbsp;<br>
Example&nbsp;usage:<br>
&nbsp;<br>
&gt;&gt;&gt;&nbsp;#&nbsp;projection&nbsp;1:&nbsp;UTM&nbsp;zone&nbsp;15,&nbsp;grs80&nbsp;ellipse,&nbsp;NAD83&nbsp;datum<br>
&gt;&gt;&gt;&nbsp;#&nbsp;(defined&nbsp;by&nbsp;epsg&nbsp;code&nbsp;26915)<br>
&gt;&gt;&gt;&nbsp;p1&nbsp;=&nbsp;<a href="#Proj">Proj</a>(init='epsg:26915')<br>
&gt;&gt;&gt;&nbsp;#&nbsp;projection&nbsp;2:&nbsp;UTM&nbsp;zone&nbsp;15,&nbsp;clrk66&nbsp;ellipse,&nbsp;NAD27&nbsp;datum<br>
&gt;&gt;&gt;&nbsp;p2&nbsp;=&nbsp;<a href="#Proj">Proj</a>(init='epsg:26715')<br>
&gt;&gt;&gt;&nbsp;#&nbsp;find&nbsp;x,y&nbsp;of&nbsp;Jefferson&nbsp;City,&nbsp;MO.<br>
&gt;&gt;&gt;&nbsp;x1,&nbsp;y1&nbsp;=&nbsp;p1(-92.199881,38.56694)<br>
&gt;&gt;&gt;&nbsp;#&nbsp;transform&nbsp;this&nbsp;point&nbsp;to&nbsp;projection&nbsp;2&nbsp;coordinates.<br>
&gt;&gt;&gt;&nbsp;x2,&nbsp;y2&nbsp;=&nbsp;<a href="#-transform">transform</a>(p1,p2,x1,y1)<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'%9.3f&nbsp;%11.3f'&nbsp;%&nbsp;(x1,y1)<br>
569704.566&nbsp;4269024.671<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'%9.3f&nbsp;%11.3f'&nbsp;%&nbsp;(x2,y2)<br>
569706.333&nbsp;4268817.680<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'%8.3f&nbsp;%5.3f'&nbsp;%&nbsp;p2(x2,y2,inverse=True)<br>
&nbsp;-92.200&nbsp;38.567<br>
&gt;&gt;&gt;&nbsp;#&nbsp;process&nbsp;3&nbsp;points&nbsp;at&nbsp;a&nbsp;time&nbsp;in&nbsp;a&nbsp;tuple<br>
&gt;&gt;&gt;&nbsp;lats&nbsp;=&nbsp;(38.83,39.32,38.75)&nbsp;#&nbsp;Columbia,&nbsp;KC&nbsp;and&nbsp;StL&nbsp;Missouri<br>
&gt;&gt;&gt;&nbsp;lons&nbsp;=&nbsp;(-92.22,-94.72,-90.37)<br>
&gt;&gt;&gt;&nbsp;x1,&nbsp;y1&nbsp;=&nbsp;p1(lons,lats)<br>
&gt;&gt;&gt;&nbsp;x2,&nbsp;y2&nbsp;=&nbsp;<a href="#-transform">transform</a>(p1,p2,x1,y1)<br>
&gt;&gt;&gt;&nbsp;xy&nbsp;=&nbsp;x1+y1<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'%9.3f&nbsp;%9.3f&nbsp;%9.3f&nbsp;%11.3f&nbsp;%11.3f&nbsp;%11.3f'&nbsp;%&nbsp;xy<br>
567703.344&nbsp;351730.944&nbsp;728553.093&nbsp;4298200.739&nbsp;4353698.725&nbsp;4292319.005<br>
&gt;&gt;&gt;&nbsp;xy&nbsp;=&nbsp;x2+y2<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'%9.3f&nbsp;%9.3f&nbsp;%9.3f&nbsp;%11.3f&nbsp;%11.3f&nbsp;%11.3f'&nbsp;%&nbsp;xy<br>
567705.072&nbsp;351727.113&nbsp;728558.917&nbsp;4297993.157&nbsp;4353490.111&nbsp;4292111.678<br>
&gt;&gt;&gt;&nbsp;lons,&nbsp;lats&nbsp;=&nbsp;p2(x2,y2,inverse=True)<br>
&gt;&gt;&gt;&nbsp;xy&nbsp;=&nbsp;lons+lats<br>
&gt;&gt;&gt;&nbsp;print&nbsp;'%8.3f&nbsp;%8.3f&nbsp;%8.3f&nbsp;%5.3f&nbsp;%5.3f&nbsp;%5.3f'&nbsp;%&nbsp;xy<br>
&nbsp;-92.220&nbsp;&nbsp;-94.720&nbsp;&nbsp;-90.370&nbsp;38.830&nbsp;39.320&nbsp;38.750</tt></dd></dl>
</td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#55aa55">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
    
<tr><td bgcolor="#55aa55"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><strong>__version__</strong> = '1.8.7'<br>
<strong>pyproj_datadir</strong> = '/usr/local/lib/python2.5/site-packages/pyproj/data'</td></tr></table>
</body></html>