clinic_finder 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1395796307b7e4dc1c69d210f37f0c976f666d02
+  data.tar.gz: d12d1d938849d0414c1e80dab9c85d5de849fd7a
+SHA512:
+  metadata.gz: aacbea8da4beb63753b31d20ec350e3ba2b051d7b414ed574225c24459b0f3b1e0a1db0fea9d28849f4ac6ea3479c4abede1c38f7245a38b4f45ca0cb6ba43fa
+  data.tar.gz: 4b7f6ac8c24a445a93430b33eb40ff90d0783528201902bb0d86916f85f350f791efdcff0fa0fd25903bde4e414e9412da204ad35011ebc9db0ad07d839fb443

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+.DS_Store

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+bundler_args: --without development
+rvm:
+  - 2.3.3

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+gemspec
+
+gem 'geokit'
+gem 'rake', '>= 0.9.2'
+gem 'minitest'

data/Gemfile.lock

@@ -0,0 +1,23 @@
+PATH
+  remote: .
+  specs:
+    clinic_finder (0.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    geokit (1.10.0)
+    minitest (5.10.1)
+    rake (12.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  clinic_finder!
+  geokit
+  minitest
+  rake (>= 0.9.2)
+
+BUNDLED WITH
+   1.14.4

data/README.md

@@ -0,0 +1,110 @@
+# clinic_finder
+# ABORTRON 
+
+* CI: https://travis-ci.org/colinxfleming/clinic_finder
+* build script: build.sh
+* run tests: rake test
+
+## Problem Description
+
+Our case management team is helping patients navigate a variety of logistical challenges to securing an abortion, such as figuring out the closest clinic to them, or the cheapest clinic in their state, or a clinic that will still see them (since many clinics have a gestational age cutoff after which they won't do abortions anymore). The DC area is fortunate enough to have a variety of providers, and we'd like to have a tool that helps us filter down our set of clinics and help our case managers recommend an optimal few clinics, given a patient's particular needs.
+
+## How we'd like to use it
+
+We'd prefer this as a ruby library so that we can plug it into our existing case management system easily. If that's not an option, we can adapt the logic from it.
+
+## How we'd like it to work
+
+As a case manager, given that I have:
+* A patient with limited resources, a gestational age, and a zip code
+* A set of clinics with certain attributes, including an address and a set schedule of costs and whether or not they accept National Abortion Federation (NAF) funding, and certain other factors that might make them a better fit for a patient
+
+I would like to be able to filter and sort down to a subset of available clinics.
+
+Relevant parts of our clinic objects that we'd like to filter on:
+  * zip: five digit zip code
+  * cost: cost in dollars for an abortion procedure
+  * gestation_limit: limit in days, at which point a clinic won't perform abortions. e.g. no abortions after 147 days (21 weeks).
+  * naf_clinic: boolean value for whether or not a clinic accepts NAF funding (e.g. whether or not we can count on a grant)
+
+Information from a patient that we'd like to plug into the tool:
+* zip code of patient
+* patient's gestational age
+
+## Setup
+
+[PLACEHOLDER FOR INSTALL INSTRUCTIONS]
+
+This gem currently requires data to be in the form of a .yml file, which is passed in to the library instance at the point of initialization as such:
+
+`Abortron::ClinicFinder.new(yaml_file)`
+
+The gem expects yml data to be in the following format:
+
+```
+planned_parenthood_oakland:
+  street_address: 1001 Broadway
+  city: Oakland
+  state: CA
+  zip: 94607
+  accepts_naf: false
+  gestational_limit: 139
+  costs_9wks: 425
+  costs_12wks: 475
+  costs_18wks: 975
+  costs_24wks: null
+  costs_30wks: null
+  ```
+Hot tip: Before using your yml file, please be sure to feed it through a YAML linter like [YAML Lint](http://www.yamllint.com/) to remove any syntax errors.
+
+Long term goal here is to make this usable with ActiveRecord models directly.
+
+## Methods
+
+First, you will need to instantiate a library instance.
+
+`@abortron = Abortron::ClinicFinder.new(your_yaml_file)`
+
+To find the cheapest clinic within your dataset that will serve the patient based on their LMP, call:
+
+`@abortron.locate_cheapest_clinic(patient_zip: 94114, gestational_age: 60)`
+
+This will return an array of hashes that look like so:
+
+```
+=> [{'planned_parenthood_oakland' => {'street_address' => '1001 Broadway', 
+                                      'city' => 'Oakland', 'state' => 'CA', 
+                                      'zip' => 94607, 
+                                      'accepts_naf' => false, 
+                                      'gestational_limit' => 139, 
+                                      'costs_9wks' => 425, 
+                                      'costs_12wks' => 475, 
+                                      'costs_18wks' => 975, 
+                                      'costs_24wks' => nil, 
+                                      'costs_30wks' => nil}}, 
+    {'castro_family_planning' =>     {'street_address' => '5464 Folsom', 
+                                      'city' => 'San Francisco', 
+                                      'state' => 'CA', 
+                                      'zip' => 94607, 
+                                      'accepts_naf' => false, 
+                                      'gestational_limit' => 139, 
+                                      'costs_9wks' => 425, 
+                                      'costs_12wks' => 475, 
+                                      'costs_18wks' => 975, 
+                                      'costs_24wks' => nil, 
+                                      'costs_30wks' => nil}}]
+```
+      
+
+## Further goals
+* Make gem usable with ActiveRecord models directly, instead of via a yml file that requires maintenance
+* Incorporate check for NAF only (the infrastructure is currently present as a default-false argument, but is not being used)
+* Create method for cheapest **and** closest, defined as the cheapest clinic of your three closest clinics
+* Create a method for easiest/fastest access via public transportation (this may require patient to provide full address, not just zip)
+
+## Measuring success
+
+We'd like to walk away with:
+
+* A ruby gem that we can install in a separate app
+* A standalone sinatra app that we can demo to case managers

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+desc 'Run tests'
+task default: :test

data/build.sh

@@ -0,0 +1,3 @@
+gem uninstall clinic_finder
+gem build clinic_finder.gemspec
+gem install clinic_finder-*.gem

data/clinic_finder.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name        = 'clinic_finder'
+  s.version     = '0.0.0'
+  s.date        = '2017-02-23'
+  s.summary     = 'Finding abortion clinics based on zip and LMP'
+  s.description = 'Help abortion fund case managers match ' \
+                  'patients to optimal clinics.'
+  s.authors     = ['Team Code for DCAF', 'Colin Fleming', 'Lisa Waldschmitt']
+  s.email       = 'info@dcabortionfund.org'
+  s.files       = ['lib/clinic_finder.rb', 'lib/clinic_finder/gestation_helper.rb']
+  s.homepage    = 'http://www.dcabortionfund.org'
+  s.license     = 'MIT'
+
+  s.rubyforge_project = "clinic_finder"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- test/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+end

data/fixtures/clinics.yml

@@ -0,0 +1,144 @@
+# A set of fake clinics with cost, geo, and naf data to use as stubs
+planned_parenthood_oakland:
+  street_address: 1001 Broadway
+  city: Oakland
+  state: CA
+  zip: 94607
+  accepts_naf: false
+  gestational_limit: 139
+  costs_9wks: 425
+  costs_12wks: 475
+  costs_18wks: 975
+  costs_24wks: null
+  costs_30wks: null
+
+planned_parenthood_san_fran:
+  street_address: 2430 Folsom
+  city: San Francisco
+  state: CA
+  zip: 94110
+  accepts_naf: false
+  gestational_limit: 111
+  costs_9wks: 300
+  costs_12wks: 325
+  costs_18wks: null
+  costs_18wks: null
+  costs_24wks: null
+  costs_30wks: null
+
+castro_family_planning:
+  street_address: 517 Castro
+  city: San Francisco
+  state: CA
+  zip: 94114
+  accepts_naf: true
+  gestational_limit: 126
+  costs_9wks: 295
+  costs_12wks: 425
+  costs_18wks: 1500
+  costs_24wks: null
+  costs_30wks: null
+
+silcon_valley_womens_clinic:
+  street_address: 110 S Market
+  city: San Jose
+  state: CA
+  zip: 95110
+  accepts_naf: true
+  gestational_limit: 98
+  costs_9wks: 375
+  costs_12wks: 400
+  costs_18wks: null
+  costs_24wks: null
+  costs_30wks: null
+
+discreet_treatment_centers_of_ca:
+  street_address: 570 Pacific
+  city: Monterey
+  state: CA
+  zip: 93940
+  accepts_naf: false
+  gestational_limit: 154
+  costs_9wks: 400
+  costs_12wks: 400
+  costs_18wks: 1150
+  costs_24wks: null
+  costs_30wks: null
+
+albuquerque_medical_center:
+  street_address: 1801 Mountain NW
+  city: Albuquerque
+  state: NM
+  zip: 87104
+  accepts_naf: true
+  gestational_limit: 210
+  costs_9wks: 300
+  costs_12wks: 325
+  costs_18wks: 1100
+  costs_24wks: 4000
+  costs_30wks: 9500
+
+butte_health_clinic:
+  street_address: 7473 Humboldt
+  city: Butte Meadows
+  state: CA
+  zip: 95942
+  accepts_naf: true
+  gestational_limit: 111
+  costs_9wks: 350
+  costs_12wks: 400
+  costs_18wks: null
+  costs_24wks: null
+  costs_30wks: null
+
+planned_parenthood_fresno:
+  street_address: 2220 Tulare
+  city: Fresno
+  state: CA
+  zip: 93721
+  accepts_naf: false
+  gestational_limit: 97
+  costs_9wks: 425
+  costs_12wks: 475
+  costs_18wks: null
+  costs_24wks: null
+  costs_30wks: null
+
+womens_health_of_venice_beach:
+  street_address: 2025 Pacific
+  city: Los Angeles
+  state: CA
+  zip: 90291
+  accepts_naf: true
+  gestational_limit: 119
+  costs_9wks: 350
+  costs_12wks: 350
+  costs_18wks: null
+  costs_24wks: null
+  costs_30wks: null
+
+planned_parenthood_la:
+  street_address: 3900 W Manchester
+  city: Los Angeles
+  state: CA
+  zip: 90305
+  accepts_naf: false
+  gestational_limit: 146
+  costs_9wks: 415
+  costs_12wks: 460
+  costs_18wks: 1450
+  costs_24wks: null
+  costs_30wks: null
+
+la_medical_center:
+  street_address: 5905 Wilshire
+  city: Los Angeles
+  state: CA
+  zip: 90036
+  accepts_naf: true
+  gestational_limit: 168
+  costs_9wks: 400
+  costs_12wks: 400
+  costs_18wks: 1600
+  costs_24wks: 3000
+  costs_30wks: null

data/lib/clinic_finder.rb

@@ -0,0 +1,84 @@
+require 'yaml'
+require 'geokit'
+require_relative './clinic_finder/gestation_helper'
+
+# Core class
+module Abortron
+class ClinicFinder
+	attr_reader :clinics
+
+  def initialize(yml_file)
+		@clinics = ::YAML.load_file(yml_file)
+  end
+
+  def create_full_address(gestational_age) # need to test filtering gestational limit
+    @clinic_addresses = []
+    filtered_clinics = @clinics.keep_if { |name, info| gestational_age < info['gestational_limit']}
+    filtered_clinics.each do |clinic, info|
+      @clinic_addresses << {name: clinic, address: "#{info['street_address']}, #{info['city']}, #{info['state']}"}
+    end
+    @clinic_addresses
+  end
+
+  def clinics_coordinates_conversion
+    @coordinates_hash = {}
+    @clinic_addresses.map! do |address| # {name: 'Oakland Clinic', address: '101 Main St, Oakland, CA'}
+      location = ::Geokit::Geocoders::GoogleGeocoder.geocode(address[:address])
+      float_coordinates = location.ll.split(',').map(&:to_f)
+      @coordinates_hash[address[:name]] = float_coordinates
+      sleep(0.5)
+    end
+    @coordinates_hash
+  end
+
+  def patient_coordinates_conversion(patient_zipcode)
+    @patient_location = ::Geokit::Geocoders::GoogleGeocoder.geocode(patient_zipcode)
+    @patient_float_coordinates = @patient_location.ll
+  end
+
+  def calculate_distance
+    distances = []
+    @coordinates_hash.each do |name, coordinates|
+      ll = Geokit::LatLng.new(coordinates[0], coordinates[1])
+      distances << {name: name, distance: ll.distance_to(@patient_float_coordinates)}
+      # distances = [ {name: "Oakland", distance: 2}, {name: "San Francisco", distance: 1} ]
+    end
+    @distances = distances.sort_by {|distance| distance[:distance]}
+  end
+
+
+  def find_closest_clinics
+    @distances[0..2]
+  end
+
+  # need to write test to make sure everything gets called
+  def locate_nearest_clinic(patient_zipcode:, gestational_age:)
+    patient_coordinates_conversion(patient_zipcode)
+    create_full_address(gestational_age)
+    clinics_coordinates_conversion
+    calculate_distance
+    find_closest_clinics
+  end
+
+  def locate_cheapest_clinic(gestational_age:, naf_clinics_only: false)
+    @helper = ::ClinicFinder::GestationHelper.new(gestational_age)
+    @gestational_tier = @helper.gestational_tier
+    decorate_data(available_clinics)
+  end
+
+  # This method makes the sorted clinic data more easily traversible by converting the data into a hash of names (keys) and informational attributes (values) rather than leaving them as separate values in a nested array.
+  private def decorate_data(data)
+    sorted_clinics = []
+    three_cheapest(data).map { |clinic_array| sorted_clinics << { clinic_array.first => clinic_array.last } }
+    sorted_clinics
+  end
+
+  private def three_cheapest(data)
+    data.sort_by { |name, information| information[@gestational_tier] }.first(3)
+  end
+
+  private def available_clinics
+    @clinics.keep_if { |name, information| information[@gestational_tier] && @helper.within_gestational_limit?(information['gestational_limit']) }
+  end
+end
+end

data/lib/clinic_finder/gestation_helper.rb

@@ -0,0 +1,32 @@
+class ClinicFinder
+  class GestationHelper
+    attr_reader :gestational_age, :gestational_weeks
+
+    def initialize(gestational_age)
+      @gestational_age = gestational_age
+      # BUSINESS LOGIC HERE - CHANGE AS NEEDED
+      # We round up under the assumption that as soon as you pass the threshhold
+      # of a pricing tier - say, 9 weeks and 1 day - you will be priced into the
+      # more expensive tier (12 weeks). Change logic if this is not the case.
+      @gestational_weeks = (@gestational_age/7.0).ceil
+    end
+
+    def gestational_tier
+      if @gestational_weeks < 10
+        'costs_9wks'
+      elsif @gestational_weeks < 13
+        'costs_12wks'
+      elsif @gestational_weeks < 19
+        'costs_18wks'
+      elsif @gestational_weeks < 25
+        'costs_24wks'
+      else
+        'costs_30wks'
+      end
+    end
+
+    def within_gestational_limit?(gestational_limit)
+      @gestational_age < gestational_limit
+    end
+  end
+end

data/test/test_clinic_finder.rb

@@ -0,0 +1,78 @@
+require 'test_helper'
+require_relative '../lib/clinic_finder'
+
+class TestClinicFinder < TestClass
+
+  def setup
+  	file = File.join(File.dirname(__FILE__), '../fixtures/clinics.yml')
+  	@abortron = Abortron::ClinicFinder.new(file)
+  end
+
+  def test_that_initialize_sets_clinic_variable
+  	assert_kind_of Hash, @abortron.clinics
+  end
+
+  def test_that_full_addresses_created
+  	assert_kind_of Array, @abortron.create_full_address(100)
+  end
+
+  def test_that_full_address_has_needed_fields
+  	assert_equal [{:name=>"planned_parenthood_oakland", :address=>"1001 Broadway, Oakland, CA"}, {:name=>"planned_parenthood_san_fran", :address=>"2430 Folsom, San Francisco, CA"}, {:name=>"castro_family_planning", :address=>"517 Castro, San Francisco, CA"}, {:name=>"discreet_treatment_centers_of_ca", :address=>"570 Pacific, Monterey, CA"}, {:name=>"albuquerque_medical_center", :address=>"1801 Mountain NW, Albuquerque, NM"}, {:name=>"butte_health_clinic", :address=>"7473 Humboldt, Butte Meadows, CA"}, {:name=>"womens_health_of_venice_beach", :address=>"2025 Pacific, Los Angeles, CA"}, {:name=>"planned_parenthood_la", :address=>"3900 W Manchester, Los Angeles, CA"}, {:name=>"la_medical_center", :address=>"5905 Wilshire, Los Angeles, CA"}], @abortron.create_full_address(100)
+  end
+
+  def test_that_clinic_coordinates_are_hashes
+  	addresses = @abortron.create_full_address(100)
+  	assert_kind_of Hash, @abortron.clinics_coordinates_conversion
+  end
+
+  def test_that_clinic_coordinates_are_found
+    @abortron.create_full_address(100)
+    information = @abortron.clinics_coordinates_conversion
+    assert_equal [37.8021736,-122.2729171], information["planned_parenthood_oakland"]
+  end
+
+  def test_that_patient_coordinates_are_found
+		pt_address = "88 Colin P Kelly Jr St, San Francisco, CA"
+  	pt_mock = MiniTest::Mock.new
+  	pt_mock.expect(:ll, [37.78226710000001, -122.3912479])
+		Geokit::Geocoders::GoogleGeocoder.stub(:geocode, pt_mock) do
+			@abortron.patient_coordinates_conversion(pt_address)
+		end
+  end
+
+  def test_that_distances_calculated_between_clinics_and_patient
+    @abortron.create_full_address(100)
+    @abortron.clinics_coordinates_conversion
+    @abortron.patient_coordinates_conversion("94117")
+    first_clinic = {name: "castro_family_planning", distance: 0.92356303468274}
+    assert_equal first_clinic, @abortron.calculate_distance.first
+  end
+
+  def test_that_returns_top_3_closest_clinics
+    @abortron.create_full_address(100)
+    @abortron.clinics_coordinates_conversion
+    @abortron.patient_coordinates_conversion("94117")
+    @abortron.calculate_distance
+    assert_equal [{:name=>"castro_family_planning", :distance=>0.92356303468274}, {:name=>"planned_parenthood_san_fran", :distance=>1.8319683663768311}, {:name=>"planned_parenthood_oakland", :distance=>9.580895789655901}], @abortron.find_closest_clinics
+  end
+
+  def test_locate_cheapest_clinic_locates
+    clinic = {
+          'planned_parenthood_oakland' =>
+          {
+            'street_address' => '1001 Broadway',
+            'city' => 'Oakland',
+            'state' => 'CA',
+            'zip' => 94607,
+            'accepts_naf' => false,
+            'gestational_limit' => 139,
+            'costs_9wks' => 425,
+            'costs_12wks' => 475,
+            'costs_18wks' => 975,
+            'costs_24wks' => nil,
+            'costs_30wks' => nil
+          }
+        }
+    assert_equal clinic, @abortron.locate_cheapest_clinic(gestational_age: 100)[0]
+  end
+end

data/test/test_gestation_helper.rb

@@ -0,0 +1,55 @@
+require 'test_helper'
+require_relative '../lib/clinic_finder/gestation_helper'
+
+class TestGestationHelper < TestClass
+  def setup
+    @helper = ClinicFinder::GestationHelper.new(10)
+    @clinic = {
+      'street_address': '2025 Pacific',
+      'city': 'Los Angeles',
+      'state': 'CA',
+      'zip': 90291,
+      'accepts_naf': true,
+      'gestational_limit': 119,
+      'costs_9wks': 350,
+      'costs_12wks': 350,
+      'costs_18wks': nil,
+      'costs_24wks': nil,
+      'costs_30wks': nil
+    }
+  end
+
+  def test_that_initialize_sets_gestational_age_variable
+    assert_equal 10, @helper.gestational_age
+  end
+
+  def test_that_initialize_sets_gestational_weeks_variable
+    assert_equal 2, @helper.gestational_weeks
+  end
+
+  def test_that_gestational_limit_greater_than_ga_is_true
+    assert_equal true, @helper.within_gestational_limit?(30)
+  end
+
+  def test_that_gestational_limit_less_than_ga_is_false
+    assert_equal false, @helper.within_gestational_limit?(5)
+  end
+
+  def test_that_gestational_limit_equal_to_ga_is_false
+    assert_equal false, @helper.within_gestational_limit?(10)
+  end
+
+  def test_gestational_tier_under_lower_bound
+    assert_equal 'costs_9wks', @helper.gestational_tier
+  end
+
+  def test_gestational_tier_within_bound
+    @helper = ClinicFinder::GestationHelper.new(100)
+    assert_equal 'costs_18wks', @helper.gestational_tier
+  end
+
+  def test_gestational_tier_above_upper_bound
+    @helper = ClinicFinder::GestationHelper.new(400)
+    assert_equal 'costs_30wks', @helper.gestational_tier
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,5 @@
+require 'minitest/autorun'
+require 'clinic_finder'
+
+class TestClass < MiniTest::Test
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: clinic_finder
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Team Code for DCAF
+- Colin Fleming
+- Lisa Waldschmitt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-02-23 00:00:00.000000000 Z
+dependencies: []
+description: Help abortion fund case managers match patients to optimal clinics.
+email: info@dcabortionfund.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- build.sh
+- clinic_finder.gemspec
+- fixtures/clinics.yml
+- lib/clinic_finder.rb
+- lib/clinic_finder/gestation_helper.rb
+- test/test_clinic_finder.rb
+- test/test_gestation_helper.rb
+- test/test_helper.rb
+homepage: http://www.dcabortionfund.org
+licenses:
+- MIT
+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: clinic_finder
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Finding abortion clinics based on zip and LMP
+test_files:
+- test/test_clinic_finder.rb
+- test/test_gestation_helper.rb
+- test/test_helper.rb