README.md

In cassiopagnoncelli/genderguess: Gender guess

Synopsis

gender is an R library to guess gender given a name and is part of a data enrichment suite.

Installation

library('devtools')
install_github('cassiopagnoncelli/genderguess')

Usage

A call

> # As JSON
> gender('{"names":[
  "Cássius P4GN0NC3LL1 ",
  "g4BRIéL    Francysco",
  "EduArda Kart",
  "Geyzebel SanThiago Cardoso",
  "JULIAN CERRANO DaLLAsha",
  "  Pritham-Kumar Bora Bora",
  "NAARA Katheline Cilva",
  "SaMAnTa Fyorrentin"
]}')

would fetch a response

["m","m","f","f","m","m","f","f"] 

Description

gender is a machine learning model for classifying names as either male or female. It works fine for Brazilian names and comes along with a names database, albeit it is more general and could be deployed for purposes other than national names.

This model is a two-tier layer casting a voters-judge architecture.

1. ETL phase: Responsible for converting input name, whichever the format it is given, into its first name suffix and transliterating it to Latin alphabet.
2. First layer phase: Suffix is given as input to four different, trained classifiers, hereby called voters, such that each one output one different vote whether the name should be m or f. Classifiers used here are SVM, Random Forest, Decision Tree, and Neural Networks. (Individual voters average a hit rate of 80-85%.)
3. Second layer phase: Given individual votes for each classifier, an aggregator classifier, hereby called judge, decides, based on votes, which should be the gender for the given name. (Classication hit rate soars to over 97% out of individual classifiers.)

Caveats

Depending on machine conditions performance accrued from bulk calls can be over a few thousands classified instances.

As per independent calls classifier shows its overhead, hence it is recommended to prepare calls for bulk classification.

Deployment

Package can be deployed as

• a JSON webservice,
• an R script running in a cron.

cassiopagnoncelli/genderguess documentation built on May 13, 2019, 1:13 p.m.