epic-geo 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ecca0c0c284b58252bc766c0b3f809da41730807
+  data.tar.gz: 7708f3e3be966206b68c3efbb3fe116affa724b8
+SHA512:
+  metadata.gz: af449ddca054a06294976344a8cd7d3a95fb18bb4e8f2d4a611ec0848f0b4a830f3d323a414de6b97c558499205e3220bcd673d9e74e35c61fee53a7ee13dc15
+  data.tar.gz: a42c0d3b6473bc9006619b0f36ea948e9e22eb680988d08ab5f0187413f6b66c281473064df3936c8437f19554bd4d45e24c373dc43735f8bb60906aafc42d78

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - "1.9.3"
+  - "2.0.0"
+
+script: bundle exec rspec spec

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'georuby'
+gem 'rspec'
+
+gem 'coveralls', require: false

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Jennings Anderson
+
+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.md

@@ -0,0 +1,25 @@
+Epic Geo
+========
+[![Gem Version](https://badge.fury.io/rb/epic-geo.svg)](http://badge.fury.io/rb/epic-geo)
+[![Build Status](https://travis-ci.org/jenningsanderson/epic-geo.svg?branch=master)](https://travis-ci.org/jenningsanderson/epic-geo)
+[![Coverage Status](https://coveralls.io/repos/jenningsanderson/epic-geo/badge.png)](https://coveralls.io/r/jenningsanderson/epic-geo)
+
+####Background
+A gem for interfacing with both twitter and OSM data for Project EPIC at University of Colorado Boulder.
+
+####Dependencies
+Most of the functionality within this gem requires access to project EPIC's NoSQL Mongo database.  This will require being on campus or the connected via VPN.
+
+**Gem Dependencies**
+ - ```rgeo``` - A decently maintained geospatial gem for Ruby.  Allows for easy geospatial calculations such as area and length.
+
+ - ```georuby``` - Another geospatial library for Ruby which offers support for reading and writing shapefiles.
+ 	- ```geo_ruby/kml``` is also currently required.
+
+###Installation
+(Recommended) Pull the latest version of the gem from github: 
+  1. Put the following line in your Gemfile: ```gem 'epic-geo', github: 'jenningsanderson/epic-geo'```
+  2. Run ```bundle install```
+
+Via RubyGems (Latest stable build):
+```gem install epic-geo```

data/Rakefile

@@ -0,0 +1,5 @@
+#There are no rake tasks yet for the gem...
+
+task :default do 
+	nil
+end

data/coverage/.last_run.json

@@ -0,0 +1,5 @@
+{
+  "result": {
+    "covered_percent": 27.73
+  }
+}

data/coverage/.resultset.json

@@ -0,0 +1,326 @@
+{
+  "RSpec": {
+    "coverage": {
+      "/Users/jenningsanderson/Documents/epic-geo/lib/epic-geo.rb": [
+        null,
+        1,
+        null,
+        null,
+        1,
+        1,
+        null,
+        1,
+        0,
+        null,
+        null
+      ],
+      "/Users/jenningsanderson/Documents/epic-geo/lib/kml/kml_writer.rb": [
+        1,
+        1,
+        1,
+        null,
+        null,
+        null,
+        null,
+        null,
+        1,
+        null,
+        1,
+        null,
+        1,
+        null,
+        1,
+        1,
+        1,
+        1,
+        null,
+        1,
+        null,
+        null,
+        null,
+        1,
+        0,
+        0,
+        0,
+        null,
+        null,
+        null,
+        1,
+        0,
+        null,
+        0,
+        0,
+        0,
+        null,
+        null,
+        0,
+        0,
+        0,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        1,
+        0,
+        0,
+        0,
+        null,
+        0,
+        0,
+        null,
+        0,
+        0,
+        0,
+        0,
+        null,
+        0,
+        null,
+        0,
+        0,
+        0,
+        null,
+        0,
+        null,
+        null,
+        0,
+        0,
+        0,
+        0,
+        null,
+        0,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        0,
+        null,
+        0,
+        null,
+        null,
+        null,
+        1,
+        0,
+        null,
+        null,
+        null
+      ],
+      "/Users/jenningsanderson/Documents/epic-geo/lib/kml/kml_style_helper.rb": [
+        1,
+        0,
+        0,
+        0,
+        0,
+        0,
+        null,
+        0,
+        null,
+        null,
+        1,
+        0,
+        null,
+        null,
+        1,
+        null,
+        null,
+        0,
+        0,
+        null,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        null,
+        0,
+        null,
+        null,
+        0,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        1,
+        0,
+        null,
+        0,
+        null,
+        null,
+        0,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        1,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null
+      ],
+      "/Users/jenningsanderson/Documents/epic-geo/lib/geojson/write_geojson_featurecollection.rb": [
+        null,
+        null,
+        null,
+        1,
+        null,
+        1,
+        null,
+        1,
+        null,
+        1,
+        0,
+        0,
+        0,
+        null,
+        0,
+        null,
+        null,
+        1,
+        0,
+        null,
+        null,
+        1,
+        0,
+        0,
+        0,
+        null,
+        0,
+        null,
+        null,
+        1,
+        0,
+        0,
+        0,
+        0,
+        0,
+        null,
+        null,
+        1,
+        0,
+        0,
+        null,
+        null,
+        1,
+        null,
+        0,
+        0,
+        null,
+        null,
+        0,
+        0,
+        null,
+        null,
+        null
+      ]
+    },
+    "timestamp": 1399675874
+  }
+}

data/epic-geo.gemspec

@@ -0,0 +1,32 @@
+Gem::Specification.new do |s|
+  s.name              = "epic-geo"
+  s.version           = "0.0.3"
+  s.platform          = Gem::Platform::RUBY
+  s.authors           = ["Jennings Anderson"]
+  s.email             = ["jennings.anderson@colorado.edu"]
+  s.homepage          = "http://github.com/jenningsanderson/epic-geo"
+  s.summary           = "Gems for handling Project EPIC geo data"
+  s.description       = "Series of Ruby Scripts for dealing with Geo data.  Much more to come"
+  s.rubyforge_project = s.name
+
+  #s.required_rubygems_version = ">= 1.3.6"
+
+  # If you have runtime dependencies, add them here
+  # s.add_runtime_dependency "other", "~> 1.2"
+  s.add_runtime_dependency "json"
+  s.add_runtime_dependency "rgeo" #This is an important dependency to allow the geo calculations
+  # It will need all sorts of dependencies such as rgeo, ruby/gems, etc...
+
+  # If you have development dependencies, add them here
+  # s.add_development_dependency "another", "= 0.9"
+
+  # The list of files to be contained in the gem
+  s.files         = `git ls-files`.split("\n")
+  # s.executables   = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  # s.extensions    = `git ls-files ext/extconf.rb`.split("\n")
+
+  s.require_path = 'lib'
+
+  # For C extensions
+  # s.extensions = "ext/extconf.rb"
+end

data/lib/epic-geo.rb

@@ -0,0 +1,11 @@
+
+class EpicGeo
+	
+	#Require all of the sub modules
+	require_relative 'kml/kml_writer'
+	require_relative 'geojson/write_geojson_featurecollection'
+
+	def self.hi
+		puts "Hello world!"
+	end
+end

data/lib/geojson/write_geojson_featurecollection.rb

@@ -0,0 +1,53 @@
+'''
+Write a geojson feature collection
+'''
+require 'json'
+
+class GeoJSONWriter
+
+  attr_reader :filename
+
+  def initialize(filename)
+    @filename = filename.dup #Getting weird frozen error...
+    unless @filename =~ /\.geojson$/
+      @filename << '.geojson'
+    end
+    @open_file = File.open(@filename, 'w')
+  end
+
+  def add_options(options_hash)
+    @options = options_hash
+  end
+
+  def write_header
+    @open_file.write "{\"type\" : \"FeatureCollection\","
+    unless @options.nil?
+      @open_file.write @options.to_json
+    end
+    @open_file.write "\"features\" :["
+  end
+
+  def write_feature(geometry, properties)
+    @open_file.write "{"
+    @open_file.write "\"type\" : \"Feature\", "
+    @open_file.write "\"geometry\" : #{geometry.to_json},"
+    @open_file.write "\"properties\" : #{properties.to_json}"
+    @open_file.write "},"
+  end
+
+  def literal_write_feature(feature)
+    @open_file.write(feature)
+    @open_file.write(",")
+  end
+
+  def write_footer
+    #Close the file and then truncate the last comma
+    @open_file.close()
+    File.truncate(@filename, File.size(@filename) - 1) #Remove the last comma
+
+    #Open the file again and close the object
+    File.open(@filename,'a') do |file|
+      file.write(']}')
+    end
+  end
+end #end class

data/lib/kml/kml_style_helper.rb

@@ -0,0 +1,150 @@
+def add_style(current_file, style)
+  current_file.write "<Style id=\"#{style[:id]}\">"
+  if style.has_key? :polygon
+    current_file.write "<PolyStyle>"
+    current_file.write "\t<color>#{style[:polygon][:color]}</color>"
+    current_file.write "</PolyStyle>"
+  end
+  current_file.write "</Style>"
+end
+
+def random_hex_color
+  (0..5).map{ rand(16).to_s(16) }.join
+end
+
+def write_color_ramp_style(number_of_styles)
+
+  #Base color:
+  base_color = '7714E7FF'
+  step = 256/number_of_styles
+
+  vals = (0..number_of_styles).to_a.reverse
+  vals.each do |id|
+    val = (id*step).to_s(16)
+    val.upcase!
+      if val.length==1
+        val = '0'+val
+      end
+    color = base_color[0..3]+val+base_color[6..7]
+
+    #Open the Style
+    @openfile.write "<Style id=\"c_ramp_style_#{id-1}\">\n"
+    @openfile.write %Q{\t<LabelStyle>
+      <scale>0</scale>
+  </LabelStyle>
+    }
+
+    #Point
+    @openfile.write %Q{\t<IconStyle>
+      <color>#{color}</color>
+       <scale>.3</scale>
+       <Icon>http://maps.google.com/mapfiles/kml/paddle/wht-blank-lv.png</Icon>
+        <LabelStyle>
+          <scale>.1</scale>
+        </LabelStyle>
+  </IconStyle>\n}
+
+    #Line
+    @openfile.write %Q{\t<LineStyle>
+      <color>#{color}</color>
+      <width>1.5</width>
+  </LineStyle>\n}
+
+    #Poly
+    @openfile.write %Q{\t<PolyStyle>
+      <color>#{color}</color>
+      <BalloonStyle>
+        <text>&lt;h1&gt;$[name]&lt;/h1&gt;$[description]</text>
+        <bgColor>ffd5efff</bgColor>
+      </BalloonStyle>
+  </PolyStyle>\n}
+    @openfile.write "</Style>\n\n"
+  end
+end
+
+def generate_random_styles(current_file, number_of_styles)
+  number_of_styles.times do |id|
+    #Generate a random hex color
+    color = random_hex_color
+
+    #Open the Style
+    current_file.write "<Style id=\"r_style_#{id}\">\n"
+
+    #Point
+    current_file.write %Q{\t<IconStyle>
+      <color>77#{color}</color>
+       <scale>.5</scale>
+       <Icon>http://maps.google.com/mapfiles/kml/paddle/wht-blank-lv.png</Icon>
+        <LabelStyle>
+          <scale>0</scale>
+        </LabelStyle>
+  </IconStyle>\n}
+
+    #Line
+    current_file.write %Q{\t<LineStyle>
+      <color>77#{color}</color>
+      <width>1.5</width>
+  </LineStyle>\n}
+
+    #Poly
+    current_file.write %Q{\t<PolyStyle>
+      <color>AA#{color}</color>
+      <BalloonStyle>
+        <text>&lt;h1&gt;$[name]&lt;/h1&gt;$[description]</text>
+        <bgColor>ffd5efff</bgColor>
+      </BalloonStyle>
+  </PolyStyle>\n}
+    current_file.write "</Style>\n\n"
+  end
+end
+
+def write_3_bin_styles
+  current_file.write %Q{
+  <Style id="before">
+    <IconStyle>
+      <scale>0.4</scale>
+      <Icon>
+        <href>http://maps.google.com/mapfiles/kml/paddle/grn-blank-lv.png</href>
+      </Icon>
+    </IconStyle>
+    <LabelStyle>
+      <scale>0</scale>
+    </LabelStyle>
+    <LineStyle>
+      <color>ff5bbd00</color>
+      <width>1.4</width>
+    </LineStyle>
+  </Style>
+
+  <Style id="during">
+    <IconStyle>
+      <scale>0.4</scale>
+      <Icon>
+        <href>http://maps.google.com/mapfiles/kml/paddle/red-circle-lv.png</href>
+      </Icon>
+    </IconStyle>
+    <LabelStyle>
+      <scale>0</scale>
+    </LabelStyle>
+    <LineStyle>
+      <color>ff1515a6</color>
+      <width>1.4</width>
+    </LineStyle>
+  </Style>
+
+  <Style id="after">
+    <IconStyle>
+      <scale>0.4</scale>
+      <Icon>
+        <href>http://maps.google.com/mapfiles/kml/paddle/ylw-blank-lv.png</href>
+      </Icon>
+    </IconStyle>
+    <LabelStyle>
+      <scale>0</scale>
+            </LabelStyle>
+    <LineStyle>
+      <color>ff7fffff</color>
+      <width>1.4</width>
+    </LineStyle>
+  </Style>}
+end

data/lib/kml/kml_writer.rb

@@ -0,0 +1,97 @@
+require 'time'
+require 'georuby'
+require 'geo_ruby/kml' #Allows writing of georuby geometry objects to kml format
+
+#TODO: The geometry should come in as geojson, I want to do away with all external dependencies
+#      except for explicit calculations with rgeo.
+
+#Require the helper functions for writing the styles to the KML file
+require_relative 'kml_style_helper'
+
+class KMLAuthor
+  
+  attr_reader :filename, :openfile
+  
+  def initialize(filename)
+    @filename = filename.dup #Getting weird frozen error...
+    unless @filename =~ /\.kml$/
+      @filename << '.kml'
+    end
+    @openfile = File.open(@filename, 'w')
+  end
+
+  #Write the KML header information and give the the file a name
+  def write_header(title)
+    @openfile.write "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
+    @openfile.write "<kml xmlns=\"http://earth.google.com/kml/2.1\">\n"
+    @openfile.write "<Document>\n<name>#{title}</name>\n\n"
+  end
+
+  #The main workhorse -- a beautiful recursive function (if I may say so) to write folders to the document
+  def write_folder(folder)
+    @openfile.write "<Folder>\n<name>#{folder[:name]}</name>\n"
+
+    unless folder[:folders].nil?
+      folder[:folders].each do |inner_folder|
+        write_folder(inner_folder)
+      end
+    else
+      unless folder[:features].empty?
+        folder[:features].each do |feature|
+          write_placemark(feature)
+        end
+      end
+    end
+    @openfile.write "</Folder>\n\n"
+  end
+
+  #Each placemark can be thought of as a feature in a geojson collection, there are many options, certainly not 
+  def write_placemark(feature)
+    @openfile.write "<Placemark>\n"
+    unless feature[:name].nil?
+      @openfile.write "\t<name>#{feature[:name]}</name>\n"
+    end
+    if feature.has_key? :style
+      @openfile.write "\t<styleUrl>#{feature[:style]}</styleUrl>\n"
+    end
+    if feature.has_key? :extended
+      @openfile.write "\t<ExtendedData>\n"
+      feature[:extended].each do |k,v|
+        @openfile.write "\t\t<Data name=\"#{k}\">#{v}</Data>\n"
+      end
+      @openfile.write "\t</ExtendedData>\n"
+    end
+    if feature.has_key? :desc
+      if feature.has_key? :link
+        @openfile.write "\t<description>\n\t\t#{feature[:desc]}\n<![CDATA[<img src=\"#{feature[:link]}\">]]></description>\n"
+      else
+      @openfile.write "\t<description>\n\t\t#{feature[:desc]}\n\t</description>\n"
+      end
+    end
+    if feature.has_key? :time
+      @openfile.write "\t<TimeStamp>\n"
+      @openfile.write "\t\t<when>#{feature[:time].iso8601}</when>\n"
+      @openfile.write "\t</TimeStamp>"
+    end
+    if feature.has_key? :gxTrack
+      @openfile.write %Q{\t<gx:Track>
+      \t\t<altitudeMode>absolute</altitudeMode>
+      \t\t<when>#{feature[:gxTrack][:start][:time].iso8601}</when>
+      \t\t<when>#{feature[:gxTrack][:end][:time].iso8601}</when>
+      \t\t<gx:coord>#{feature[:gxTrack][:start][:pos]}</gx:coord>
+      \t\t<gx:coord>#{feature[:gxTrack][:end][:pos]}</gx:coord>
+      \t</gx:Track>}
+    end
+
+    unless feature[:geometry].nil?
+      @openfile.write "\t"+feature[:geometry].as_kml #What type of geometry do we need here?
+    end
+    @openfile.write "</Placemark>\n\n"
+  end
+
+  #Properly close the kml file
+  def write_footer
+    @openfile.write("\n</Document>\n</kml>")
+  end
+
+end

data/spec/geojson_spec.rb

@@ -0,0 +1 @@
+puts "hello world"

data/spec/kml_spec.rb

@@ -0,0 +1,19 @@
+require "spec_helper"
+
+describe KMLAuthor do
+	before :all do
+		@testfile = KMLAuthor.new('testfile')
+	end
+
+	after :all do
+	 	File.delete('testfile.kml')
+	end
+	
+	it "Successfully names it appropriately" do
+    	@testfile.filename.should == 'testfile.kml'
+  	end
+
+  	it "Successfully Opens file" do
+  		expect(File).to exist('testfile.kml')
+  	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'coveralls'
+Coveralls.wear!
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+#Require the gem
+require "epic-geo"

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: epic-geo
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Jennings Anderson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rgeo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Series of Ruby Scripts for dealing with Geo data.  Much more to come
+email:
+- jennings.anderson@colorado.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- coverage/.last_run.json
+- coverage/.resultset.json
+- epic-geo.gemspec
+- lib/epic-geo.rb
+- lib/geojson/write_geojson_featurecollection.rb
+- lib/kml/kml_style_helper.rb
+- lib/kml/kml_writer.rb
+- spec/geojson_spec.rb
+- spec/kml_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/jenningsanderson/epic-geo
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: epic-geo
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Gems for handling Project EPIC geo data
+test_files: []