beauvoir 0.0.1a

data/lib/name.rb

@@ -0,0 +1,46 @@
+
+
+class Name
+  attr_accessor :male_count, :female_count, :name
+
+  def initialize(name)
+    @male_count = 0
+    @female_count = 0
+    @name = name
+  end
+
+  def male?
+    @male_count > @female_count
+  end
+
+  def female?
+    @female_count > @male_count
+  end
+
+  def gender
+    female? ? :female : male? ? :male : :unknown #oh god this is unreadable
+  end
+
+  def female_proportion
+    return 0 unless self.total > 0
+    @female_count / self.total
+  end
+
+  def male_proportion
+    return 0 unless self.total > 0
+    @male_count / self.total
+  end
+
+  def total
+    (@male_count + @female_count).to_f
+  end
+
+  #implements Agresti-Coull binomial confidence interval, returns lower bound of higher of male/female
+  # cf. http://codesequoia.wordpress.com/2010/12/06/unit-test-and-statistics/
+  def lower
+    nt = total + 1.96 ** 2
+    pt = ([@male_count, @female_count].max + (1.96 ** 2) / 2) / nt
+    e = 1.96 * Math.sqrt(pt * (1 - pt) / nt)
+    [female_proportion, male_proportion].max - e
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: beauvoir
+version: !ruby/object:Gem::Version
+  version: 0.0.1a
+platform: ruby
+authors:
+- Jeremy B. Merrill
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-18 00:00:00.000000000 Z
+dependencies: []
+description: |-
+  Guess gender by a first name using more detailed, better
+                      sourced data from Open Gender Tracker's Global Name Data.
+                      Beauvoir lets you set avg and lower bounds and choose
+                      countries from which to draw data.
+
+                      It's important to note that many people identify as neither
+                      a men nor a women. It's important, too, to note that many
+                      people who do identify as male or female have names that
+                      are held by far more people who identify as another gender.
+                      All of these people deserve not to be misgendered in public
+                      (or in private).
+
+                      Nevertheless, automatically classifying people by apparent
+                      gender can be a very useful tool to perform censuses of
+                      communities or publications to detect and quantify
+                      perhaps-invisible bias. VIDA is a pioneer in this field,
+                      but their "Count" is limited by a manual methodology that
+                      depends hundreds of person-hours of labor. There is a place
+                      for more automated counts and Beauvoir can help, but if you
+                      do a count like this, you should be careful in how you word
+                      your findings not to misgender anyone in particular and be
+                      responsive to the possibility of errors.
+email: jeremybmerrill@jeremybmerrill.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/beauvoir.rb
+- lib/name.rb
+- LICENSE
+- README.md
+- lib/data/ukprocessed.csv
+- lib/data/usprocessed.csv
+homepage: http://rubygems.org/gems/beauvoir
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 4
+summary: Guess a person's gender by their first name
+test_files: []
+has_rdoc: