Contents

terraformer-ruby
================

[terraformer-ruby](https://github.com/kenichi/terraformer-ruby) is a mostly faithful port of [terraformer](https://github.com/Esri/Terraformer).

## Installation

In your application's Gemfile:

```ruby
gem 'terraformer'
```

Or install it manually:

```sh
$ gem install terraformer
```

## Usage

```ruby
require 'terraformer'
```

##### Create a Terraformer primitive from GeoJSON

```ruby
polygon = Terraformer.parse '{
  "type": "Polygon",
  "coordinates": [
    [
      [-122.66589403152467, 45.52290150862236],
      [-122.66926288604736, 45.52291654238294],
      [-122.67115116119385, 45.518406234030586],
      [-122.67325401306151, 45.514000817199715],
      [-122.6684260368347, 45.5127377671934],
      [-122.66765356063841, 45.51694782364431],
      [-122.66589403152467, 45.52290150862236 ]
    ]
  ]
}'

point = Terraformer.parse '{
  "type": "Point",
  "coordinates": [-122.66947746276854, 45.51775972687403]
}'

```

Now that you have a point and a polygon primitive you can use the primitive helper methods.

```ruby
# add a new vertex to our polygon
new_point = Terraformer::Point.new -122.6708507537842, 45.513188859735436
polygon.insert_vertex 2, new_point
```

You can also have Terraformer perform many geometric operations like convex hulls and bounding boxes.

```ruby
# returns convex hull
convex_hull = polygon.convex_hull

point.within? convex_hull
=> true

# returns the bounding box
bounding_box = polygon.bbox
```

## Contributing

After checking out the source, run the tests:

```
$ git clone [e-mail]:kenichi/terraformer-ruby.git
$ cd terraformer-ruby
$ bundle install
$ bundle exec rake test
```

You can also generate RDoc:

```
$ bundle exec rdoc --main README.md
```

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
terraformer-0.2.1	README.md
terraformer-0.2.0	README.md