proj4rb 0.2.0-universal-darwin8.0

data/MIT-LICENSE

@@ -0,0 +1,8 @@
+Copyright (c) 2000 Frank Warmerdam
+Copyright (c) 2006 Guilhem Vellut <guilhem.vellut@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,151 @@
+=Proj4rb
+
+This is a Ruby binding for the Proj.4 Carthographic Projection library
+(http://proj.maptools.org), that supports conversions between a very large
+number of geographic coordinate systems and datums.
+
+Most functions of the C library are implemented in the Ruby binding. Where
+there is a direct equivalent between C and Ruby, identifiers (like names of
+functions and constants) are the same. But the usage has been changed to
+take advantage of Rubys object-oriented features.
+
+==Operations
+The library can be loaded this way:
+    require 'proj4'
+The classes are in the Proj4 module:
+    include Proj4
+First you have to create a projection like this:
+    proj = Projection.new( :proj => "utm", :zone => "21", :units => "m" )
+(There are several alternative ways of specifying the arguments, see
+the documentation for Proj4::Projection.new for details.)
+
+This defines a UTM21 North projection in WGS84. Note that the <tt>proj</tt> /
+<tt>proj.exe</tt> initialization arguments equivalent to the one above would
+be:
+    +proj=utm +zone=21 +units=m
+
+To use the projection, you have 2 operations: +forward+ and +inverse+.
++forward+ transforms the point in WGS84 lon/lat (in radians) to the coordinate
+system defined during the creation of the Projection object. +inverse+ does the
+opposite. For example:
+
+    projected_point = proj.forward(lonlat_point)
+    lonlat_point = proj.inverse(projected_point)
+
+There is also a +transform+ function which can transform between any two
+projections including datum conversions:
+
+    point_in_projB = projA.transform(projB, point_in_projA)
+
+The +forward+, +inverse+, and +transform+ methods all have an in-place
+equivalent: <tt>forward!</tt>, <tt>inverse!</tt>, and <tt>transform!</tt>
+which projects the given point in place. There are also +forwardDeg+
+and +inverseDeg+ methods which work with longitudes and latitudes in
+degrees rather than radians.
+
+For the points you can use an object of the Proj4::Point class. It has 
+properties: +x+, +y+, and +z+, which can be set and retrieved. Aliases
++lon+ and +lat+ for +x+ and +y+, respectively, are available.
+(For backwards compatibility there is also an UV class, but this will go away
+in future versions.) Instead of the Proj4::Point object you can use any other
+objects which responds to the methods +x+ and +y+ (and +z+ for 3D datum
+transformations with the +transform+ method).
+
+The methods +forward_all+, +inverse_all+, and +transform_all+ (and their
+in-place versions <tt>forward_all!</tt>, <tt>inverse_all!</tt>, and
+<tt>transform_all!</tt> work just like their simple counterparts, but
+instead of a single point they convert a collection of points in one go.
+They take an array as an argument or any object responding to the
++each+ method (for the in-place versions) or +each+, +clear+, and
+<tt><<</tt> methods (for the normal version).
+
+You are also given 2 constants to convert between degrees and radians:
++DEG_TO_RAD+ and +RAD_TO_DEG+
+ 
+==Error handling
+The projection initialization (Proj4::Projection.new) and all projection
+functions (Proj4::Projection#forward/inverse/transform) in their different
+versions throw an exception when there is a problem. There is a catch-all
+exception Proj4::Error and many subclasses of it for all the different errors
+that the Proj.4 C library can return. See Proj4::Error for more information or
+use the <tt>list-errors.rb</tt> program from the examples for a list.
+
+==Definition lists
+Proj.4 knows about many different datums, ellipsoids, prime meridians,
+projection types and length units. The Proj4::Datum, Proj4::Ellipsoid,
+Proj4::PrimeMeridian, Proj4::ProjectionType, and Proj4::Unit classes
+can be used to access those lists and get details about each definition.
+See the <i>list-*</i> files in the <i>example</i> directory for some code
+examples.
+
+Note that these lists are only available since the version 449 of the
+Proj.4 C library.
+
+==Installation
+Just install the gem with
+    gem install proj4rb
+
+==Compiling
+===Linux
+To compile the proj4rb Ruby bindings from source you'll need the
+Proj.4 C library installed. Enter the <i>src</i> directory and create
+a Makefile:
+    cd src
+    ruby extconf.rb
+If there are any problems consult the <i>mkmf.log</i> log file.
+Then compile with
+    make
+The result is the file <i>projrb.so</i> which you need to copy into
+the <i>lib</i> directory:
+    cp projrb.so ../lib/
+
+If you want to, you can now create a gem with
+    rake gem
+
+This will create a file <tt>proj4rb-<i>version</i>-i486-linux.gem</tt>
+or similar in the <i>pkg</i> directory.
+
+===Mac OS X
+To compile the proj4rb Ruby bindings from source you'll need the
+Proj.4 C library installed. Enter the <i>src</i> directory and create
+a Makefile:
+    cd src
+    ruby extconf.rb
+If there are any problems consult the <i>mkmf.log</i> log file.
+Then compile with
+    make
+The result is the file <i>projrb.bundle</i> which you need to copy into
+the <i>lib</i> directory:
+    cp projrb.bundle ../lib/
+
+If you want to, you can now create a gem with
+    rake gem
+
+This will create a file <tt>proj4rb-<i>version</i>-universal-darwin8.0.gem</tt>
+or similar in the <i>pkg</i> directory.
+
+
+===Windows
+The result is the file <i>proj.dll</i> which you need to copy into
+the <i>lib</i> directory:
+    cp proj.dll ../lib/
+
+==TODO
+- Completely cross-platform build system (mkrf?)
+
+==Changes since the last version
+- Added most functions supported by C library and many tests.
+- Added support for Linux builds.
+- Improved error handling. On error the methods throw exceptions now.
+
+==License
+Proj4rb is released under the MIT license.
+
+==Support
+Any questions, enhancement proposals, bug notifications or corrections can be
+sent to mailto:guilhem.vellut@gmail.com or mailto:jochen@topf.org.
+
+==Authors
+The proj4rb Ruby bindings were created by Guilhelm Vellut with many additions
+by Jochen Topf.
+

data/example/basic.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+# create projection object
+proj = Projection.new(["proj=utm", "zone=21", "units=m", "no.defs"])
+
+# create the point you want to project
+point = Point.new(45000,2700000)
+
+# do the projection
+res = proj.inverse(point)
+
+puts "x=#{point.x}, y=#{point.y} ==> lon=#{res.lon}, lat=#{res.lat}"
+

data/example/list-datums.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+if ARGV[0] == '-v'
+    puts "%-15s %-10s %-50s" % [ 'ID', 'Ellipse ID', 'Comment' ]
+    puts '-----------------------------------------------------------------------------'
+    Datum.list.sort.each do |datum|
+        puts "%-15s %-10s %-50s\n  %s\n " % [ datum.id, datum.ellipse_id, datum.comments, datum.defn ]
+    end
+else
+    puts Datum.list.sort
+end
+

data/example/list-ellipsoids.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+if ARGV[0] == '-v'
+    puts "%-9s %-14s %-18s %-36s" % [ 'ID', 'a', 'b/rf', 'Name' ]
+    puts '-----------------------------------------------------------------------------'
+    Ellipsoid.list.sort.each do |ell|
+        puts "%-9s %-14s %-18s %-36s" % [ ell.id, ell.major, ell.ell, ell.name ]
+    end
+else
+    puts Ellipsoid.list.sort
+end
+

data/example/list-errors.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+Error.list.collect{ |e| e + 'Error' }.each_with_index do |error, index|
+    puts "%2d %s" % [index, error]
+end
+

data/example/list-prime-meridians.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+if ARGV[0] == '-v'
+    puts "%-16s %-50s" % [ 'ID', 'Definition' ]
+    puts '-----------------------------------------------------------------------------'
+    PrimeMeridian.list.sort.each do |pm|
+        puts "%-16s %-50s" % [ pm.id, pm.defn ]
+    end
+else
+    puts PrimeMeridian.list.sort
+end
+

data/example/list-projection-types.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+if ARGV[0] == '-v'
+    puts "%-7s %-70s" % [ 'ID', 'Name/Description' ]
+    puts '-----------------------------------------------------------------------------'
+    ProjectionType.list.sort.each do |pt|
+        puts "%-7s %-70s" % [ pt.id, pt.descr ]
+    end
+else
+    puts ProjectionType.list
+end
+

data/example/list-units.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+if ARGV[0] == '-v'
+    puts "%-8s %-20s %-50s" % [ 'ID', 'To meter', 'Name' ]
+    puts "------------------------------------------------------------------------------"
+    Unit.list.sort.each do |unit|
+        puts "%-8s %-20s %-50s" % [ unit.id, unit.to_meter, unit.name ]
+    end
+else
+    puts Unit.list.sort
+end
+

data/example/version.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/ruby -w
+
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'proj4'
+include Proj4
+
+puts Proj4::LIBVERSION
+