Skip to content

Instantly share code, notes, and snippets.

@Katba-Caroline

Katba-Caroline/finding_donors.ipynb

Created September 26, 2018 17:38
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Katba-Caroline/148a356b239b15eb3b0e80876496b2be to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Katba-Caroline/148a356b239b15eb3b0e80876496b2be to your computer and use it in GitHub Desktop.
Download ZIP
Display the source blob
Display the rendered blob
Raw
finding_donors.ipynb
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Helping Non-Profit Find Potential Donors based on Income Data\n",
"## Machine Learning: Supervised Learning"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In this project, I employed several supervised machine learning algorithms to model individuals' income using U.S. census data from 1994.\n",
"\n",
"Our client, a non-profit, wanted to accurately predict whether certain individuals made more than $50,000 to be able to solicit them for donations to support their cause. \n",
"\n",
"This cut-off at $50K as very important for them because this will influence the effectiveness and efficiency of their fundraising goals.\n",
"\n",
"Our model will help them determine those who make more than $50,000 and this in turn will help the non-profit reach out to them. \n",
"\n",
"The dataset for this project originates from the [UCI Machine Learning Repository](https://archive.ics.uci.edu/ml/datasets/Census+Income). The datset was donated by Ron Kohavi and Barry Becker, after being published in the article _\"Scaling Up the Accuracy of Naive-Bayes Classifiers: A Decision-Tree Hybrid\"_. You can find the article by Ron Kohavi [online](https://www.aaai.org/Papers/KDD/1996/KDD96-033.pdf). However, the data we investigate here consists of small changes to the original dataset, such as removing records with missing or ill-formatted entries.\n",
"\n",
"\n",
"**NOTE** This project is the project that I submitted through the udacity course on Data Science This post has been modified for my own personal learning purposes, and it includes certain passages from the original document due to clarity of explanations. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"----\n",
"## Exploring the Data\n",
"- Load necesary Python Libraries\n",
"- Load Data\n",
"- Column `'income'` is our target label\n",
"- All other columns are features"
]
},
{
"cell_type": "code",
"execution_count": 74,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>age</th>\n",
" <th>workclass</th>\n",
" <th>education_level</th>\n",
" <th>education-num</th>\n",
" <th>marital-status</th>\n",
" <th>occupation</th>\n",
" <th>relationship</th>\n",
" <th>race</th>\n",
" <th>sex</th>\n",
" <th>capital-gain</th>\n",
" <th>capital-loss</th>\n",
" <th>hours-per-week</th>\n",
" <th>native-country</th>\n",
" <th>income</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>39</td>\n",
" <td>State-gov</td>\n",
" <td>Bachelors</td>\n",
" <td>13.0</td>\n",
" <td>Never-married</td>\n",
" <td>Adm-clerical</td>\n",
" <td>Not-in-family</td>\n",
" <td>White</td>\n",
" <td>Male</td>\n",
" <td>2174.0</td>\n",
" <td>0.0</td>\n",
" <td>40.0</td>\n",
" <td>United-States</td>\n",
" <td>&lt;=50K</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>50</td>\n",
" <td>Self-emp-not-inc</td>\n",
" <td>Bachelors</td>\n",
" <td>13.0</td>\n",
" <td>Married-civ-spouse</td>\n",
" <td>Exec-managerial</td>\n",
" <td>Husband</td>\n",
" <td>White</td>\n",
" <td>Male</td>\n",
" <td>0.0</td>\n",
" <td>0.0</td>\n",
" <td>13.0</td>\n",
" <td>United-States</td>\n",
" <td>&lt;=50K</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>38</td>\n",
" <td>Private</td>\n",
" <td>HS-grad</td>\n",
" <td>9.0</td>\n",
" <td>Divorced</td>\n",
" <td>Handlers-cleaners</td>\n",
" <td>Not-in-family</td>\n",
" <td>White</td>\n",
" <td>Male</td>\n",
" <td>0.0</td>\n",
" <td>0.0</td>\n",
" <td>40.0</td>\n",
" <td>United-States</td>\n",
" <td>&lt;=50K</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>53</td>\n",
" <td>Private</td>\n",
" <td>11th</td>\n",
" <td>7.0</td>\n",
" <td>Married-civ-spouse</td>\n",
" <td>Handlers-cleaners</td>\n",
" <td>Husband</td>\n",
" <td>Black</td>\n",
" <td>Male</td>\n",
" <td>0.0</td>\n",
" <td>0.0</td>\n",
" <td>40.0</td>\n",
" <td>United-States</td>\n",
" <td>&lt;=50K</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>28</td>\n",
" <td>Private</td>\n",
" <td>Bachelors</td>\n",
" <td>13.0</td>\n",
" <td>Married-civ-spouse</td>\n",
" <td>Prof-specialty</td>\n",
" <td>Wife</td>\n",
" <td>Black</td>\n",
" <td>Female</td>\n",
" <td>0.0</td>\n",
" <td>0.0</td>\n",
" <td>40.0</td>\n",
" <td>Cuba</td>\n",
" <td>&lt;=50K</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" age workclass education_level education-num marital-status \\\n",
"0 39 State-gov Bachelors 13.0 Never-married \n",
"1 50 Self-emp-not-inc Bachelors 13.0 Married-civ-spouse \n",
"2 38 Private HS-grad 9.0 Divorced \n",
"3 53 Private 11th 7.0 Married-civ-spouse \n",
"4 28 Private Bachelors 13.0 Married-civ-spouse \n",
"\n",
" occupation relationship race sex capital-gain \\\n",
"0 Adm-clerical Not-in-family White Male 2174.0 \n",
"1 Exec-managerial Husband White Male 0.0 \n",
"2 Handlers-cleaners Not-in-family White Male 0.0 \n",
"3 Handlers-cleaners Husband Black Male 0.0 \n",
"4 Prof-specialty Wife Black Female 0.0 \n",
"\n",
" capital-loss hours-per-week native-country income \n",
"0 0.0 40.0 United-States <=50K \n",
"1 0.0 13.0 United-States <=50K \n",
"2 0.0 40.0 United-States <=50K \n",
"3 0.0 40.0 United-States <=50K \n",
"4 0.0 40.0 Cuba <=50K "
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Import libraries necessary for this project\n",
"import numpy as np\n",
"import pandas as pd\n",
"from time import time\n",
"from IPython.display import display # Allows the use of display() for DataFrames\n",
"\n",
"# Import supplementary visualization code visuals.py\n",
"import visuals as vs\n",
"\n",
"# Pretty display for notebooks\n",
"%matplotlib inline\n",
"\n",
"# Load the Census dataset\n",
"data = pd.read_csv(\"census.csv\")\n",
"\n",
"# Success - Display the first record\n",
"display(data.head(n=5))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Data Exploration\n",
"A cursory investigation of the dataset will determine how many individuals fit into either group, and will tell us about the percentage of these individuals making more than \\$50,000. "
]
},
{
"cell_type": "code",
"execution_count": 75,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Total number of records: 45222\n",
"Individuals making more than $50,000: 11208\n",
"Individuals making at most $50,000: 34014\n",
"Percentage of individuals making more than $50,000: 24.78439697492371%\n"
]
}
],
"source": [
"# Total number of records\n",
"n_records = len(data['income'])\n",
"\n",
"n_records1 = data['income'].value_counts()\n",
"# Number of records where individual's income is more than $50,000\n",
"n_greater_50k = n_records1[1]\n",
"# Number of records where individual's income is at most $50,000\n",
"n_at_most_50k = n_records1[0]\n",
"\n",
"# Percentage of individuals whose income is more than $50,000\n",
"greater_percent = (n_records1[1].sum()/n_records1.sum())*100\n",
" \n",
"\n",
"# Print the results\n",
"print(\"Total number of records: {}\".format(n_records))\n",
"print(\"Individuals making more than $50,000: {}\".format(n_greater_50k))\n",
"print(\"Individuals making at most $50,000: {}\".format(n_at_most_50k))\n",
"print(\"Percentage of individuals making more than $50,000: {}%\".format(greater_percent))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## ** Feature set Exploration **\n",
"\n",
"* **age**: continuous. \n",
"* **workclass**: Private, Self-emp-not-inc, Self-emp-inc, Federal-gov, Local-gov, State-gov, Without-pay, Never-worked. \n",
"* **education**: Bachelors, Some-college, 11th, HS-grad, Prof-school, Assoc-acdm, Assoc-voc, 9th, 7th-8th, 12th, Masters, 1st-4th, 10th, Doctorate, 5th-6th, Preschool. \n",
"* **education-num**: continuous. \n",
"* **marital-status**: Married-civ-spouse, Divorced, Never-married, Separated, Widowed, Married-spouse-absent, Married-AF-spouse. \n",
"* **occupation**: Tech-support, Craft-repair, Other-service, Sales, Exec-managerial, Prof-specialty, Handlers-cleaners, Machine-op-inspct, Adm-clerical, Farming-fishing, Transport-moving, Priv-house-serv, Protective-serv, Armed-Forces. \n",
"* **relationship**: Wife, Own-child, Husband, Not-in-family, Other-relative, Unmarried. \n",
"* **race**: Black, White, Asian-Pac-Islander, Amer-Indian-Eskimo, Other. \n",
"* **sex**: Female, Male. \n",
"* **capital-gain**: continuous. \n",
"* **capital-loss**: continuous. \n",
"* **hours-per-week**: continuous. \n",
"* **native-country**: United-States, Cambodia, England, Puerto-Rico, Canada, Germany, Outlying-US(Guam-USVI-etc), India, Japan, Greece, South, China, Cuba, Iran, Honduras, Philippines, Italy, Poland, Jamaica, Vietnam, Mexico, Portugal, Ireland, France, Dominican-Republic, Laos, Ecuador, Taiwan, Haiti, Columbia, Hungary, Guatemala, Nicaragua, Scotland, Thailand, Yugoslavia, El-Salvador, Trinadad&Tobago, Peru, Hong, Holand-Netherlands."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"----\n",
"## Preparing the Data : Prepocessing\n",
"Data Cleaning, Reformatting and Restricting is sometimes necessary to be able to employ our machine learning algorithms. Luckily, this data is clean and has no missing values. However, there are some qualities that must be adjusted such as highly skewed values. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Transforming Skewed Continuous Features\n",
"Algorithms can be sensitive to skewed distributions of values and can underperform if the range is not properly normalized. Here, we have two features that must be normalized: '`capital-gain'` and `'capital-loss'`. \n",
"\n",
"The code cell below plots a histogram of these two features. Note the range of the values and how they are distributed."
]
},
{
"cell_type": "code",
"execution_count": 76,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<matplotlib.figure.Figure at 0x256fadff978>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Split the data into features and target label\n",
"income_raw = data['income']\n",
"features_raw = data.drop('income', axis = 1)\n",
"\n",
"# Visualize skewed continuous features of original data\n",
"vs.distribution(data)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"For highly-skewed feature distributions such as we see above, it is common practice to apply a <a href=\"https://en.wikipedia.org/wiki/Data_transformation_(statistics)\">logarithmic transformation</a> on the data so that the very large and very small values do not negatively affect the performance of a learning algorithm. \n",
"This is usually a good idea because using a logarithmic transformation significantly reduces the range of values caused by outliers. However, We must be taken when applying this transformation because the logarithm of `0` is undefined, so we must translate the values by a small amount above `0` to apply the the logarithm successfully.\n",
"\n",
"The code cell below performs a transformation on the data and visualizes the results. Again, note the range of values and how they are distributed. "
]
},
{
"cell_type": "code",
"execution_count": 77,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<matplotlib.figure.Figure at 0x256fb8255c0>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Log-transform the skewed features\n",
"skewed = ['capital-gain', 'capital-loss']\n",
"features_log_transformed = pd.DataFrame(data = features_raw)\n",
"features_log_transformed[skewed] = features_raw[skewed].apply(lambda x: np.log(x + 1))\n",
"\n",
"# Visualize the new log distributions\n",
"vs.distribution(features_log_transformed, transformed = True)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Normalizing Numerical Features\n",
"\n",
"Just like we transformed our highly skewed features, we also want to scale our numerical features. Note that this scaling does not cage the shape of any feature's distribution like above. But, normalization makes sure that our features are treated equally when applying our supervised learner algorithms. Note that when we normalize the data, we would not be able to read it in its raw form anymore, this data will have new meaning.\n"
]
},
{
"cell_type": "code",
"execution_count": 78,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>age</th>\n",
" <th>workclass</th>\n",
" <th>education_level</th>\n",
" <th>education-num</th>\n",
" <th>marital-status</th>\n",
" <th>occupation</th>\n",
" <th>relationship</th>\n",
" <th>race</th>\n",
" <th>sex</th>\n",
" <th>capital-gain</th>\n",
" <th>capital-loss</th>\n",
" <th>hours-per-week</th>\n",
" <th>native-country</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>0.301370</td>\n",
" <td>State-gov</td>\n",
" <td>Bachelors</td>\n",
" <td>0.800000</td>\n",
" <td>Never-married</td>\n",
" <td>Adm-clerical</td>\n",
" <td>Not-in-family</td>\n",
" <td>White</td>\n",
" <td>Male</td>\n",
" <td>0.667492</td>\n",
" <td>0.0</td>\n",
" <td>0.397959</td>\n",
" <td>United-States</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>0.452055</td>\n",
" <td>Self-emp-not-inc</td>\n",
" <td>Bachelors</td>\n",
" <td>0.800000</td>\n",
" <td>Married-civ-spouse</td>\n",
" <td>Exec-managerial</td>\n",
" <td>Husband</td>\n",
" <td>White</td>\n",
" <td>Male</td>\n",
" <td>0.000000</td>\n",
" <td>0.0</td>\n",
" <td>0.122449</td>\n",
" <td>United-States</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>0.287671</td>\n",
" <td>Private</td>\n",
" <td>HS-grad</td>\n",
" <td>0.533333</td>\n",
" <td>Divorced</td>\n",
" <td>Handlers-cleaners</td>\n",
" <td>Not-in-family</td>\n",
" <td>White</td>\n",
" <td>Male</td>\n",
" <td>0.000000</td>\n",
" <td>0.0</td>\n",
" <td>0.397959</td>\n",
" <td>United-States</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>0.493151</td>\n",
" <td>Private</td>\n",
" <td>11th</td>\n",
" <td>0.400000</td>\n",
" <td>Married-civ-spouse</td>\n",
" <td>Handlers-cleaners</td>\n",
" <td>Husband</td>\n",
" <td>Black</td>\n",
" <td>Male</td>\n",
" <td>0.000000</td>\n",
" <td>0.0</td>\n",
" <td>0.397959</td>\n",
" <td>United-States</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>0.150685</td>\n",
" <td>Private</td>\n",
" <td>Bachelors</td>\n",
" <td>0.800000</td>\n",
" <td>Married-civ-spouse</td>\n",
" <td>Prof-specialty</td>\n",
" <td>Wife</td>\n",
" <td>Black</td>\n",
" <td>Female</td>\n",
" <td>0.000000</td>\n",
" <td>0.0</td>\n",
" <td>0.397959</td>\n",
" <td>Cuba</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" age workclass education_level education-num \\\n",
"0 0.301370 State-gov Bachelors 0.800000 \n",
"1 0.452055 Self-emp-not-inc Bachelors 0.800000 \n",
"2 0.287671 Private HS-grad 0.533333 \n",
"3 0.493151 Private 11th 0.400000 \n",
"4 0.150685 Private Bachelors 0.800000 \n",
"\n",
" marital-status occupation relationship race sex \\\n",
"0 Never-married Adm-clerical Not-in-family White Male \n",
"1 Married-civ-spouse Exec-managerial Husband White Male \n",
"2 Divorced Handlers-cleaners Not-in-family White Male \n",
"3 Married-civ-spouse Handlers-cleaners Husband Black Male \n",
"4 Married-civ-spouse Prof-specialty Wife Black Female \n",
"\n",
" capital-gain capital-loss hours-per-week native-country \n",
"0 0.667492 0.0 0.397959 United-States \n",
"1 0.000000 0.0 0.122449 United-States \n",
"2 0.000000 0.0 0.397959 United-States \n",
"3 0.000000 0.0 0.397959 United-States \n",
"4 0.000000 0.0 0.397959 Cuba "
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Import sklearn.preprocessing.StandardScaler\n",
"from sklearn.preprocessing import MinMaxScaler\n",
"\n",
"# Initialize a scaler, then apply it to the features\n",
"scaler = MinMaxScaler() # default=(0, 1)\n",
"numerical = ['age', 'education-num', 'capital-gain', 'capital-loss', 'hours-per-week']\n",
"\n",
"features_log_minmax_transform = pd.DataFrame(data = features_log_transformed)\n",
"features_log_minmax_transform[numerical] = scaler.fit_transform(features_log_transformed[numerical])\n",
"\n",
"# Show an example of a record with scaling applied\n",
"display(features_log_minmax_transform.head(n = 5))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Data Preprocessing\n",
"\n",
"We can see that there are several non-numeic features for each record. Given that typically, learning algorithms expect input to be numeric, we must convert non-numeric features (called *categorical variables*) using the **one-hot encoding** scheme. One-hot encoding creates a _\"dummy\"_ variable for each possible category of each non-numeric feature.\n",
"\n",
"Additionally, as with the non-numeric features, we need to convert the non-numeric target label, `'income'` to numerical values for the learning algorithm to work. Since there are only two possible categories for this label (\"<=50K\" and \">50K\"), we can avoid using one-hot encoding and simply encode these two categories as `0` and `1`, respectively. "
]
},
{
"cell_type": "code",
"execution_count": 37,
"metadata": {
"scrolled": true
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"103 total features after one-hot encoding.\n"
]
}
],
"source": [
"# One-hot encode the 'features_log_minmax_transform' data using pandas.get_dummies()\n",
"features_final = pd.get_dummies(features_log_minmax_transform)\n",
"\n",
"# TODO: Encode the 'income_raw' data to numerical values\n",
"income = income = pd.get_dummies(income_raw, prefix='income').iloc[:,1:]\n",
"\n",
"# Print the number of features after one-hot encoding\n",
"encoded = list(features_final.columns)\n",
"print(\"{} total features after one-hot encoding.\".format(len(encoded)))\n",
"\n",
"# Uncomment the following line to see the encoded feature names\n",
"#print(encoded)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Shuffle and Split Data\n",
"Now all _categorical variables_ have been converted into numerical features, and all numerical features have been normalized. We will now split the data (both features and their labels) into training and test sets. 80% of the data will be used for training and 20% for testing.\n"
]
},
{
"cell_type": "code",
"execution_count": 79,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Training set has 36177 samples.\n",
"Testing set has 9045 samples.\n"
]
}
],
"source": [
"# Import train_test_split\n",
"from sklearn.model_selection import train_test_split\n",
"\n",
"# Split the 'features' and 'income' data into training and testing sets\n",
"X_train, X_test, y_train, y_test = train_test_split(features_final, \n",
" income, \n",
" test_size = 0.2, \n",
" random_state = 0)\n",
"\n",
"# Show the results of the split\n",
"print(\"Training set has {} samples.\".format(X_train.shape[0]))\n",
"print(\"Testing set has {} samples.\".format(X_test.shape[0]))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"----\n",
"## Evaluating Model Performance\n",
"In this section, we will investigate four different algorithms, and determine which is best at modeling the data. Three of these algorithms will be supervised learners of your choice, and the fourth algorithm is known as a *naive predictor*."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Metrics and the Naive Predictor\n",
"*CharityML*, equipped with their research, knows individuals that make more than \\$50,000 are most likely to donate to their charity. Because of this, *CharityML* is particularly interested in predicting who makes more than \\$50,000 accurately. It would seem that using **accuracy** as a metric for evaluating a particular model's performace would be appropriate. Additionally, identifying someone that *does not* make more than \\$50,000 as someone who does would be detrimental to *CharityML*, since they are looking to find individuals willing to donate. Therefore, a model's ability to precisely predict those that make more than \\$50,000 is *more important* than the model's ability to **recall** those individuals. We can use **F-beta score** as a metric that considers both precision and recall:\n",
"\n",
"$$ F_{\\beta} = (1 + \\beta^2) \\cdot \\frac{precision \\cdot recall}{\\left( \\beta^2 \\cdot precision \\right) + recall} $$\n",
"\n",
"In particular, when $\\beta = 0.5$, more emphasis is placed on precision. This is called the **F$_{0.5}$ score** (or F-score for simplicity).\n",
"\n",
"Looking at the distribution of classes (those who make at most \\$50,000, and those who make more), it's clear most individuals do not make more than \\$50,000. This can greatly affect **accuracy**, since we could simply say *\"this person does not make more than \\$50,000\"* and generally be right, without ever looking at the data! Making such a statement would be called **naive**, since we have not considered any information to substantiate the claim. It is always important to consider the *naive prediction* for your data, to help establish a benchmark for whether a model is performing well. That been said, using that prediction would be pointless: If we predicted all people made less than \\$50,000, *CharityML* would identify no one as donors. \n",
"\n",
"\n",
"#### Note: Recap of accuracy, precision, recall\n",
"\n",
"** Accuracy ** measures how often the classifier makes the correct prediction. It’s the ratio of the number of correct predictions to the total number of predictions (the number of test data points).\n",
"\n",
"** Precision ** tells us what proportion of messages we classified as spam, actually were spam.\n",
"It is a ratio of true positives(words classified as spam, and which are actually spam) to all positives(all words classified as spam, irrespective of whether that was the correct classificatio), in other words it is the ratio of\n",
"\n",
"`[True Positives/(True Positives + False Positives)]`\n",
"\n",
"** Recall(sensitivity)** tells us what proportion of messages that actually were spam were classified by us as spam.\n",
"It is a ratio of true positives(words classified as spam, and which are actually spam) to all the words that were actually spam, in other words it is the ratio of\n",
"\n",
"`[True Positives/(True Positives + False Negatives)]`\n",
"\n",
"For classification problems that are skewed in their classification distributions like in our case, for example if we had a 100 text messages and only 2 were spam and the rest 98 weren't, accuracy by itself is not a very good metric. We could classify 90 messages as not spam(including the 2 that were spam but we classify them as not spam, hence they would be false negatives) and 10 as spam(all 10 false positives) and still get a reasonably good accuracy score. For such cases, precision and recall come in very handy. These two metrics can be combined to get the F1 score, which is weighted average(harmonic mean) of the precision and recall scores. This score can range from 0 to 1, with 1 being the best possible F1 score(we take the harmonic mean as we are dealing with ratios)."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Naive Predictor Performace\n",
"* If we chose a model that always predicted an individual made more than $50,000, what would that model's accuracy and F-score be on this dataset?\n",
"\n",
"** Please note ** that the the purpose of generating a naive predictor is simply to show what a base model without any intelligence would look like. In the real world, ideally your base model would be either the results of a previous model or could be based on a research paper upon which you are looking to improve. When there is no benchmark model set, getting a result better than random choice is a place you could start from.\n",
"\n",
"** Note: ** \n",
"\n",
"* When we have a model that always predicts '1' (i.e. the individual makes more than 50k) then our model will have no True Negatives(TN) or False Negatives(FN) as we are not making any negative('0' value) predictions. Therefore our Accuracy in this case becomes the same as our Precision(True Positives/(True Positives + False Positives)) as every prediction that we have made with value '1' that should have '0' becomes a False Positive; therefore our denominator in this case is the total number of records we have in total. \n",
"* Our Recall score(True Positives/(True Positives + False Negatives)) in this setting becomes 1 as we have no False Negatives."
]
},
{
"cell_type": "code",
"execution_count": 80,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Naive Predictor: [Accuracy score: 0.2478, F-score: 0.2917]\n"
]
}
],
"source": [
"\n",
"from sklearn.metrics import accuracy_score, precision_score, recall_score, f1_score\n",
"\n",
"'''\n",
"TP = np.sum(income) # Counting the ones as this is the naive case. Note that 'income' is the 'income_raw' data \n",
"encoded to numerical values done in the data preprocessing step.\n",
"FP = income.count() - TP # Specific to the naive case\n",
"\n",
"TN = 0 # No predicted negatives in the naive case\n",
"FN = 0 # No predicted negatives in the naive case\n",
"\n",
"'''\n",
"TP = np.sum(income) \n",
"TP = 34014\n",
"FP = income.count()\n",
"FP - 45222\n",
"TN = 0 \n",
"FN = 0 \n",
"\n",
"# Calculate accuracy, precision and recall\n",
"accuracy = greater_percent/100.0\n",
"\n",
"recall = 1\n",
"precision = 0.4292\n",
"\n",
"\n",
"\n",
"beta=0.5\n",
"\n",
"# Calculate F-score using the formula above for beta = 0.5 and correct values for precision and recall.\n",
"fscore = (1 + beta**2)*(accuracy*recall)/((beta**2*accuracy) + recall)\n",
"\n",
"\n",
"# Print the results \n",
"print(\"Naive Predictor: [Accuracy score: {:.4f}, F-score: {:.4f}]\".format(accuracy, fscore))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Supervised Learning Models\n",
"**The following are some of the supervised learning models that are currently available in** [`scikit-learn`](http://scikit-learn.org/stable/supervised_learning.html) **that I could choose from:**\n",
"- Gaussian Naive Bayes (GaussianNB)\n",
"- Decision Trees\n",
"- Ensemble Methods (Bagging, AdaBoost, Random Forest, Gradient Boosting)\n",
"- K-Nearest Neighbors (KNeighbors)\n",
"- Stochastic Gradient Descent Classifier (SGDC)\n",
"- Support Vector Machines (SVM)\n",
"- Logistic Regression\n",
"\n",
"# Here are the Three that I chose:"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Ensemble Method: Random Forest\n",
"1. Describe one real-world application in industry where the model can be applied.\n",
"Random Forest can be used in marketing research to understand customer purchasing behavior or customer interest.\n",
"\n",
"\n",
"2. What are the strengths of the model; when does it perform well?\n",
"The pooling mechanism of combining many decision trees and their outputs provides a stronger and more robust prediction based on a collection of data. Additionally, random forests allow us to measure the importance of each feature which can be very helpful in further understanding the model. [`source`](https://towardsdatascience.com/the-random-forest-algorithm-d457d499ffcd)\n",
"\n",
"\n",
"3. What are the weaknesses of the model; when does it perform poorly?\n",
"Random forests have high variance which means that the model can be too flexible and will attempt to fit every data point, i.e. overfitting. \n",
"\n",
"\n",
"4. What makes this model a good candidate for the problem, given what you know about the data?\n",
"Given the data that we have especially given that we have information on education level, work classes and capital gains, we can base on previous research comfortable predict who would make more or less than $50K\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## K Nearest Neighbor\n",
"1. Describe one real-world application in industry where the model can be applied.\n",
"A recommender system can be one of the application of KNN [`source`](https://www.quora.com/What-are-industry-applications-of-the-K-nearest-neighbor-algorithm)\n",
"\n",
"\n",
"2. What are the strengths of the model; when does it perform well?\n",
"one of its strengths is that it is one of the simplest machine learning algorithms and that it can be used for both classification AND regression. It is also very helpful in finding patterns and similar items. \n",
"\n",
"\n",
"3. What are the weaknesses of the model; when does it perform poorly?\n",
"if the class distribution within the data set is skewed then the classification is most likely not a good outcome. A way to get around it is to weight the classification and account for the distance between test points and their k nearest neighbors. [`source`](https://en.wikipedia.org/wiki/K-nearest_neighbors_algorithm#Algorithm)\n",
"\n",
"\n",
"4. What makes this model a good candidate for the problem, given what you know about the data?\n",
"The KNN output is class membership, this output is obtained through a process in which the objects are classified through 'a majority vote' from its neighbors. This method of classification can help us see different categories of people with varying characteristics, helping us make better prediction about who earns more than $50K\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Logistic Regression\n",
"1. Describe one real-world application in industry where the model can be applied.\n",
"Logistic regression can be used to estimate the probability of an airport being turned into a cargo hub!\n",
"\n",
"\n",
"2. What are the strengths of the model; when does it perform well?\n",
"Logistic regression strengths lie in that it is highly efficient, and does not require many computational resources. it doesn't require features to be scales nor any tuning. it's a simple one!\n",
"\n",
"\n",
"3. What are the weaknesses of the model; when does it perform poorly?\n",
"Logistic regression performs better when certain characteristics are unrelated, i.e. preferable no correlation between the data. this can be hard depending on the data. \n",
"\n",
"\n",
"4. What makes this model a good candidate for the problem, given what you know about the data?\n",
"Logistic regression is incredible for binary classification, it can be the base of many deep learning and neural network tasks. However, for this project, logistic regression is good for telling us a quick yes or no on whether a particular person make more than %50K.\n",
"\n",
"[`source`](https://towardsdatascience.com/the-logistic-regression-algorithm-75fe48e21cfa)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Creating a Training and Predicting Pipeline\n",
"To properly evaluate the performance of each model, it's important to create a training and predicting pipeline that allows us to quickly and effectively train models using various sizes of training data and perform predictions on the testing data. \n",
"In the code below, Here's what we needed to implement :\n",
" - Import `fbeta_score` and `accuracy_score` from [`sklearn.metrics`](http://scikit-learn.org/stable/modules/classes.html#sklearn-metrics-metrics).\n",
" - Fit the learner to the sampled training data and record the training time.\n",
" - Perform predictions on the test data `X_test`, and also on the first 300 training points `X_train[:300]`.\n",
" - Record the total prediction time.\n",
" - Calculate the accuracy score for both the training subset and testing set.\n",
" - Calculate the F-score for both the training subset and testing set.\n",
" "
]
},
{
"cell_type": "code",
"execution_count": 92,
"metadata": {},
"outputs": [],
"source": [
"# Import two metrics from sklearn - fbeta_score and accuracy_score\n",
"from sklearn.metrics import accuracy_score, fbeta_score\n",
"def train_predict(learner, sample_size, X_train, y_train, X_test, y_test): \n",
" '''\n",
" inputs:\n",
" - learner: the learning algorithm to be trained and predicted on\n",
" - sample_size: the size of samples (number) to be drawn from training set\n",
" - X_train: features training set\n",
" - y_train: income training set\n",
" - X_test: features testing set\n",
" - y_test: income testing set\n",
"'''\n",
" \n",
" results = {}\n",
" \n",
" # Fit the learner to the training data using slicing with \n",
" #'sample_size' using .fit(training_features[:], training_labels[:])\n",
" \n",
" \n",
" start = time() # Get start time\n",
" learner = learner.fit(X_train[:sample_size], y_train[:sample_size])\n",
" end = time() # Get end time\n",
" \n",
" # Calculate the training time\n",
" results['train_time'] = \"Train time in {:.3f} seconds\".format(end-start)\n",
" \n",
" # Get the predictions on the test set(X_test),\n",
" # then get predictions on the first 300 training samples(X_train) using .predict()\n",
" start = time() # Get start time\n",
" predictions_test = learner.predict(X_test)\n",
" predictions_train = learner.predict(X_train[:300])\n",
" end = time() # Get end time\n",
" \n",
" # Calculate the total prediction time\n",
" results['pred_time'] = \"Train time in {:.3f} seconds\".format(end-start)\n",
" \n",
" # Compute accuracy on the first 300 training samples which is y_train[:300]\n",
" results['acc_train'] = accuracy_score(y_train[:300], predictions_train)\n",
" \n",
" # Compute accuracy on test set using accuracy_score()\n",
" results['acc_test'] = accuracy_score(y_test, predictions_test)\n",
" \n",
" # Compute F-score on the the first 300 training samples using fbeta_score()\n",
" results['f_train'] = fbeta_score(y_train[:300], predictions_train, beta=0.5)\n",
" \n",
" # Compute F-score on the test set which is y_test\n",
" results['f_test'] = fbeta_score(y_test,predictions_test,beta=0.5)\n",
" \n",
" # Success\n",
" print(\"{} trained on {} samples.\".format(learner.__class__.__name__, sample_size))\n",
" \n",
" # Return the results\n",
" return results\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Initial Model Evaluation\n",
"In the code cell, Here's what we needed to implement:\n",
"- Import the three supervised learning models you've discussed in the previous section.\n",
"- Initialize the three models and store them in `'clf_A'`, `'clf_B'`, and `'clf_C'`.\n",
" \n",
"- Calculate the number of records equal to 1%, 10%, and 100% of the training data.\n"
]
},
{
"cell_type": "code",
"execution_count": 82,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"C:\\Users\\Frank the Tank\\Anaconda3\\lib\\site-packages\\ipykernel\\__main__.py:21: DataConversionWarning: A column-vector y was passed when a 1d array was expected. Please change the shape of y to (n_samples,), for example using ravel().\n",
"C:\\Users\\Frank the Tank\\Anaconda3\\lib\\site-packages\\ipykernel\\__main__.py:21: DataConversionWarning: A column-vector y was passed when a 1d array was expected. Please change the shape of y to (n_samples,), for example using ravel().\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"RandomForestClassifier trained on 362 samples.\n",
"RandomForestClassifier trained on 36177 samples.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"C:\\Users\\Frank the Tank\\Anaconda3\\lib\\site-packages\\ipykernel\\__main__.py:21: DataConversionWarning: A column-vector y was passed when a 1d array was expected. Please change the shape of y to (n_samples,), for example using ravel().\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"RandomForestClassifier trained on 36177 samples.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"C:\\Users\\Frank the Tank\\Anaconda3\\lib\\site-packages\\ipykernel\\__main__.py:21: DataConversionWarning: A column-vector y was passed when a 1d array was expected. Please change the shape of y to (n_samples, ), for example using ravel().\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"KNeighborsClassifier trained on 362 samples.\n",
"KNeighborsClassifier trained on 36177 samples.\n",
"KNeighborsClassifier trained on 36177 samples.\n",
"LogisticRegression trained on 362 samples.\n"
]
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"C:\\Users\\Frank the Tank\\Anaconda3\\lib\\site-packages\\sklearn\\utils\\validation.py:578: DataConversionWarning: A column-vector y was passed when a 1d array was expected. Please change the shape of y to (n_samples, ), for example using ravel().\n",
" y = column_or_1d(y, warn=True)\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"LogisticRegression trained on 36177 samples.\n",
"LogisticRegression trained on 36177 samples.\n"
]
},
{
"data": {
"image/png": "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1qhSpUrmsmXLYgHgr7/+Ol7QO3f9+vXOXbt2rR4eHn5n69atJ3bs2HGiV69eyZmZmUZnW65cuWK5fPlydwCwtbXNe9+bU6cGDhxYccuWLa5fffXVuZ07dx53cXHJiYqKqmAYh6F8Ojg45BbWNhSUH0DhcmbIypUrXT744IPA7t27J+/fv//YpEmTEiIjIz0N26Jff/3V7fr161a///77yUWLFp3dsmWL64PMbD+SU4EM8zgQHR3t7ODgUFcIgYyMDAtAjuDqp7l79+59U+t/xYoV8W5ubm7r1q1zeffdd6/r3Tt27Hj9ww8/vAYAtWod6DMpAAAgAElEQVTVurpo0aIKmzZtKtexY8eUo0eP2v7xxx+ua9euPf3iiy+mAMCqVaviAgICwvT3p6SkWCxZssRzwoQJCX369LkBALVr1048cOCA49SpU31eeumlFL3fF1988fqgQYOSAeCzzz67tHz58gpBQUEZgwcPTgaAzz///FJUVJTntm3bnF555ZVb+vuGDBkSOGzYsLyX7zvvvHNl9uzZlzZs2OB85MgRx/379x+rV69eBgD8+OOP5wICAsJmzpxZ4fPPP8/r5AwbNuzyq6++mhdm165d/Vq2bHlr9uzZeetb1q5de658+fJ11qxZ4/L666/fvHjxok379u1vNm3aNB0AtHbNXl5eOZaWlsLJySk3ICAgb4bozJkztv7+/jo7O7sirzPRdmaDg4Mzb926dbFv376Vc3Jy4iwtLZGQkGATGhp6p2XLlmkAUK1atcznn38+DQBu3Lhhefv2bctOnTrdCgsL0wGA/tcYvr6+2XZ2drn6mT1jflJSUiy+/PJLr6VLl555+eWXbwNASEhIZlJS0qVRo0b5z5kzJy/vwsLC0oytFWKMs3//fqd//vnH+Ysvvjg3YMCA68b8WFpaimnTpiV069at2s6dO682b978njUf06dP9/3kk08u6sOoWbNmJoDz7dq1C05KSjpvrEO/YMECr379+l3R3xMWFnZl//79jps2bco3QJGVlWWxatWqc76+vtkAMGTIkMv9+/evfOfOHdKbvwkhMHXq1Avt27dPBYDVq1efq1SpUu1vvvmm/NChQ69NnTrVu0aNGncWLVqUAAAREREZmZmZCb17965y6tSpi9WrV88EACISP/744zkXF5dcQM4EF1SfT506Zefk5JRTpUqVIq8J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\n",
"text/plain": [
"<matplotlib.figure.Figure at 0x25681cb6518>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Import the three supervised learning models from sklearn\n",
"from sklearn.ensemble import RandomForestClassifier\n",
"from sklearn.neighbors import KNeighborsClassifier\n",
"from sklearn.linear_model import LogisticRegression\n",
"\n",
"# Initialize the three models\n",
"clf_A = RandomForestClassifier(random_state=0)\n",
"clf_B = KNeighborsClassifier()\n",
"clf_C = LogisticRegression(random_state=0)\n",
"\n",
"# Calculate the number of samples for 1%, 10%, and 100% of the training data\n",
"# HINT: samples_100 is the entire training set i.e. len(y_train)\n",
"# HINT: samples_10 is 10% of samples_100 (ensure to set the count of the values to be `int` and not `float`)\n",
"# HINT: samples_1 is 1% of samples_100 (ensure to set the count of the values to be `int` and not `float`)\n",
"samples_100 = len(y_train)\n",
"samples_10 = int(round(len(y_train*.1)))\n",
"samples_1 = int(round(len(y_train)*.01))\n",
"\n",
"# Collect results on the learners\n",
"results = {}\n",
"for clf in [clf_A, clf_B, clf_C]:\n",
" clf_name = clf.__class__.__name__\n",
" results[clf_name] = {}\n",
" for i, samples in enumerate([samples_1, samples_10, samples_100]):\n",
" results[clf_name][i] = \\\n",
" train_predict(clf, samples, X_train, y_train, X_test, y_test)\n",
"\n",
"# Run metrics visualization for the three supervised learning models chosen\n",
"vs.evaluate(results, accuracy, fscore)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"----\n",
"## Improving Results and Choosing the Best Model\n",
"Now is when we choose from the three supervised learning models the *best* model to use on the data. We needed to perform a grid search optimization for the model over the entire training set (`X_train` and `y_train`) by tuning at least one parameter to improve upon the untuned model's F-score. \n",
"\n",
"### Best Model Choice\n",
"From the graph above, we can see that during the training phase that the Random Forest and KNN algorithms outperform their Logistic Regression counterpart in both accuracy and fscore on all sample sizes. However, in the test data output, we can see that Logistic Regression and Random forest are relatively tied in how well they analyzed the data and produced good results in both accuracy and fscore values. \n",
"\n",
"If we had to choose a model, I would suggest Logistic regression, because it takes the least amount of time, is not as flexible ( does not have too high a variance) like Random Forest, does not like strong correlations in the data and because it performed consistently better on the accuracy and fscore measures.\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Best Model Choice in Layman's Terms\n",
"\n",
"The model that we came up with is logistic regression, this model can look at some data and tell us the probability that any person we input into our model would either make more or less than 50K, with a relatively high accuracy level. The reason I mention accuracy is because you brought up that misclassifying people who make less than 50k as someone who does make more than 50K would be detrimental, so we took that seriously and focused more on the accuracy of our predictions. \n",
"the way that it works behind the scenes, very simply, is that it looks at each characteristic like schooling and tries to account for how that would influence the overall probabilities of our person making more than $50K. overall, this is a very strong prediction algorithm that can answer your question in a pinch!\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Model Tuning\n",
"To fine tune the chosen model, we used grid search (`GridSearchCV`) with at least one important parameter tuned with at least 3 different values. We needed the entire training set for this. In the code cell below, Here's what we needed to implement:\n",
"- Import [`sklearn.grid_search.GridSearchCV`](http://scikit-learn.org/0.17/modules/generated/sklearn.grid_search.GridSearchCV.html) and [`sklearn.metrics.make_scorer`](http://scikit-learn.org/stable/modules/generated/sklearn.metrics.make_scorer.html).\n",
"- Initialize the chosen classifier and store it in `clf`.\n",
" - Set a `random_state` if one is available to the same state you set before.\n",
"- Create a dictionary of parameters we wish to tune for the chosen model.\n",
" - Example: `parameters = {'parameter' : [list of values]}`.\n",
"- Use `make_scorer` to create an `fbeta_score` scoring object (with $\\beta = 0.5$).\n",
"- Perform grid search on the classifier `clf` using the `'scorer'`, and store it in `grid_obj`.\n",
"- Fit the grid search object to the training data (`X_train`, `y_train`), and store it in `grid_fit`.\n"
]
},
{
"cell_type": "code",
"execution_count": 95,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Unoptimized model\n",
"------\n",
"Accuracy score on testing data: 0.8419\n",
"F-score on testing data: 0.6832\n",
"\n",
"Optimized Model\n",
"------\n",
"Final accuracy score on the testing data: 0.8423\n",
"Final F-score on the testing data: 0.6849\n"
]
}
],
"source": [
"# Import 'GridSearchCV', 'make_scorer', and any other necessary libraries\n",
"from sklearn.linear_model import LogisticRegression\n",
"from sklearn import grid_search\n",
"from sklearn.model_selection import GridSearchCV\n",
"from sklearn.cross_validation import StratifiedShuffleSplit\n",
"from sklearn.metrics import make_scorer\n",
"from sklearn.metrics import fbeta_score\n",
"from sklearn.metrics import accuracy_score\n",
"\n",
"\n",
"# Initialize the classifier\n",
"clf = LogisticRegression()\n",
"\n",
"# Create the parameters list you wish to tune, using a dictionary if needed.\n",
"# HINT: parameters = {'parameter_1': [value1, value2], 'parameter_2': [value1, value2]}\n",
"#parameters = {'n_estimators':[100,150,200]}\n",
"parameters = {'solver': ['newton-cg', 'lbfgs'], \n",
" 'C': [0.01, 0.1, 1.0, 10.0, 100.0, 1000.0]}\n",
"\n",
"# Make an fbeta_score scoring object using make_scorer()\n",
"scorer = make_scorer(fbeta_score, beta=0.5)\n",
"cv = StratifiedShuffleSplit(y_train, test_size=0.5, random_state=2)\n",
"\n",
"# Perform grid search on the classifier using 'scorer' as the scoring method using GridSearchCV()\n",
"grid_obj = GridSearchCV(clf, parameters, scoring=scorer, cv=cv)\n",
"\n",
"# Fit the grid search object to the training data and find the optimal parameters using fit()\n",
"grid_fit = grid_obj.fit(X_train, y_train)\n",
" \n",
"\n",
"\n",
"# Get the estimator\n",
"best_clf = grid_fit.best_estimator_\n",
"\n",
"best_clf.fit(X_train, y_train)\n",
"\n",
"# Make predictions using the unoptimized and model\n",
"predictions = (clf.fit(X_train, y_train)).predict(X_test)\n",
"best_predictions = best_clf.predict(X_test)\n",
"\n",
"\n",
"# Report the before-and-afterscores\n",
"print(\"Unoptimized model\\n------\")\n",
"print(\"Accuracy score on testing data: {:.4f}\".format(accuracy_score(y_test, predictions)))\n",
"print(\"F-score on testing data: {:.4f}\".format(fbeta_score(y_test, predictions, beta = 0.5)))\n",
"print(\"\\nOptimized Model\\n------\")\n",
"print(\"Final accuracy score on the testing data: {:.4f}\".format(accuracy_score(y_test, best_predictions)))\n",
"print(\"Final F-score on the testing data: {:.4f}\".format(fbeta_score(y_test, best_predictions, beta = 0.5)))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Final Model Evaluation\n",
"\n",
"* What is the optimized model's accuracy and F-score on the testing data? \n",
"* Are these scores better or worse than the unoptimized model? \n",
"* How do the results from our optimized model compare to the naive predictor benchmarks we found earlier?"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Results:\n",
"\n",
"| Metric | Benchmark Predictor | Unoptimized Model | Optimized Model |\n",
"| :------------: | :---------------: |:---------------: | :-------------: | \n",
"| Accuracy Score | 0.2478 | 0.8419 | 0.8423 |\n",
"| F-score | 0.2917 | 0.6832 | 0.6849 |\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In the table above, we can see clearly that the tuned model did significantly better on both accuracy and f-score that the benchmark predictor. We can also see that the optimized model also did better than the unoptimized model. \n",
"\n",
"the results show a start difference and confirm that the benchmark initial assumption that all individuals made more than ($50k) was not the correct approach as evident through the accuracy score and the fscore's vast improvement in the optimized model.\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"----\n",
"# Feature Importance\n",
"\n",
"An important task when performing supervised learning on a dataset like the census data we study here is determining which features provide the most predictive power. By focusing on the relationship between only a few crucial features and the target label we simplify our understanding of the phenomenon, which is most always a useful thing to do. In the case of this project, that means we wish to identify a small number of features that most strongly predict whether an individual makes at most or more than \\$50,000.\n",
"\n",
"To do this, we must choose a scikit-learn classifier (e.g., adaboost, random forests) that has a `feature_importance_` attribute, which is a function that ranks the importance of features according to the chosen classifier. In the code below, we fit this classifier to training set and use this attribute to determine the top 5 most important features for the census dataset."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Feature Relevance Observation\n",
"First: Intuition\n",
"Which five original features do we believe to be most important for prediction, and in what order would we rank them and why?\n",
"\n",
"**Answer:**\n",
"Subjectively speaking and given that we are estimating income, I would say that age, education level, sex, race, and capital gain would make the best indicators, again subjectively speaking. Those indicators are all associated with more wealth at least in the minds of the general public. Older people and those with graduate levels of education are usually in leadership and management position who, on average, earn more. Additionally, historical precedence and corporate cultures have disproportionately awarded men and specifically white men bigger salaries than women and people of color. capital gain indicates a different stream of income that not many have.\n"
]
},
{
"cell_type": "code",
"execution_count": 91,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"Index(['age', 'workclass', 'education_level', 'education-num',\n",
" 'marital-status', 'occupation', 'relationship', 'race', 'sex',\n",
" 'capital-gain', 'capital-loss', 'hours-per-week', 'native-country',\n",
" 'income'],\n",
" dtype='object')"
]
},
"execution_count": 91,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"#display column\n",
"data.columns"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Extracting Feature Importance\n",
"To do this, we must choose a `scikit-learn` supervised learning algorithm that has a `feature_importance_` attribute availble for it. This attribute is a function that ranks the importance of each feature when making predictions based on the chosen algorithm.\n",
"\n",
"In the code below, Here's what we needed to implement:\n",
" - Import a supervised learning model from sklearn if it is different from the three used earlier.\n",
" - Train the supervised model on the entire training set.\n",
" - Extract the feature importances using `'.feature_importances_'`."
]
},
{
"cell_type": "code",
"execution_count": 87,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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mxaNAdz0mdkkdy+vrlzJWgBFRNJo0qRJ9O/fH3enSZMm3HvvvRs7JBERJYAiIrXpsMMOyzvOUERkYynZbwGLiIiIyKZBCaCIiIhIyigBFBEREUkZJYAiIiIiKaOLQERSrKZv6VDIbRw+/fRTLr30UiZMmMA222xDWVkZgwYNYu+9967RWJKOOOIIbrzxRsrL898ZYdCgQfTr14+GDRsC8J3vfIeHHnqIJk2abNC6y8rKaNSoEXXq1AHg9ttv55BDDim6nj/84Q9cffXVGxRLPh07duRvf/sbHTp0YNWqVTRu3Jg777yTs846C4ADDzyQu+++u+JXUbJNnDiR+++/n8GDB+ddx+zZsznxxBOZMmXKOvOGDBnCcccdx6677lozL0hEqqUWQBEpGXfnlFNO4YgjjmDWrFlMnTqVP/zhD+v1+741bdCgQSxdurTi+ciRIzc4+csYNWoUkydPZvLkyeuV/EFIAItV6E/LHXLIIYwdOxaAN998k7Zt21Y8X7JkCe+9917Om2VnlJeXV5n8VWfIkCHMnZv98/AiUpuUAIpIyYwaNYp69epx/vnnV0zr0KEDhx12GKNHj+bEE0+smN6/f3+GDBkChFa0q6++moMPPpjy8nJef/11evTowV577VXxyxtVLZ90wQUXUF5eTrt27fjtb38LhF/0mDt3LkceeSRHHnlkxTo///xzfvnLX3L77bdXLH/NNddw0003AXDDDTfQuXNn2rdvX1FXofIte/LJJ3PggQfSrl077rrrLgCuvPJKli1bRocOHTjzzDOZPXs2+++/f8UyN954I9dccw0QWjuvvvpqDj/8cG655Rbmz5/P97//fTp37kznzp0ZM2bMOrF069atIuEbO3Ys559/fsXP2o0fP55OnTpRp04dlixZwk9+8hM6d+5Mx44dK25ondz28+fP59hjj6VTp0789Kc/ZY899uDzzz8HYPXq1Zx33nm0a9eO4447jmXLljFs2DAmTpzImWeeSYcOHVi2bFlR21FE1o8SQBEpmSlTpnDggQeu17KtWrVi3LhxHHbYYfTt25dhw4bx6quvMmDAgOoXTrjuuuuYOHEib731Fi+++CJvvfUWF198MbvuuiujRo1a56fX+vTpwyOPPFLx/NFHH+XUU0/l2WefZcaMGYwfP57JkyczadIkXnrppZzrPPLII+nQoQMHHXQQQJXL3nvvvUyaNImJEycyePBgFixYwPXXX0+DBg2YPHkyDz74YLWv8auvvuLFF1/kF7/4BZdccgmXXXYZEyZMYPjw4ZV+yi4j2QI4duxYunfvzjbbbMOiRYsYO3Ys3bp1q9h2Rx11FBMmTGDUqFFcccUVLFmypFJdv/vd7zjqqKN4/fXXOeWUU/jwww8r5s2YMYOLLrqIt99+myZNmjB8+HB69+5NeXk5Dz74IJMnT6ZBgwbVvj4R2XAaAygim4VevXoBcMABB7B48WIaNWpEo0aNqF+/Pl999VXB9Tz66KPcddddrFq1ik8++YSpU6fSvn1gbjceAAAgAElEQVT7vOU7duzIvHnzmDt3LvPnz2eHHXZg9913Z/DgwTz77LMVvzu8ePFiZsyYQffu3depY9SoUTRr1qzi+bPPPpt32cGDB/P4448D8NFHHzFjxgyaNm1a8OsDOP300yseP/fcc0ydOrXi+ddff82iRYto1KhRxbSysjK++eYbPv30U6ZPn07btm3p3Lkzr732GmPHjuVnP/tZRdwjRozgxhtvBGD58uWVEjyAV155pSL+nj17ssMOO1TMa926NR06dADCuMLZs2cX9bpEpOYoARSRkmnXrh3Dhg3LOa9u3bqsWbOm4vny5csrzd9mm20A2GqrrSoeZ56vWrWq2uUB3n//fW688UYmTJjADjvsQN++fXOWy9a7d2+GDRvGp59+Sp8+fYAwnvGqq67ipz/9abXLZ8u37OjRo3nuuecYN24cDRs25IgjjsgZX3Wvddttt614vGbNGsaNG1dty9rBBx/MsGHDaNGiBWZG165dGTNmDOPHj6dr164VcQ8fPpy2bdtWWjY5hrOq35dP7rc6deqou1dkI1IXsIiUzFFHHcWKFSu4++67K6ZNmDCBF198kT322IOpU6eyYsUKFi5cyPPPP19U3YUs//XXX7PtttvSuHFjPvvsM/79739XzGvUqBGLFi3KWXefPn0YOnQow4YNo3fv3gD06NGDe++9l8WLFwPw8ccfM2/evIJizbfswoUL2WGHHWjYsCHTp0/n1VdfrVimXr16rFy5EoCdd96ZefPmsWDBAlasWMGTTz6Zd13HHXcct956a8XzzNi+bN26dePmm2/m4IMPBkJCeP/997PLLrtUXAzTo0cP/vKXv1QkeW+88cY69Rx66KE8+uijQGgx/PLLL6vdHlVtexGpHWoBFEmxQm7bUpPMjMcff5xLL72U66+/nvr161fcBqZVq1acdtpptG/fnjZt2lR0jxaqkOW//e1v07FjR9q1a8eee+5ZMbYNoF+/fhx//PG0aNFinXGA7dq1Y9GiRey22260aNECCInVtGnTKhKm7bbbjgceeICddtqp2ljzLduzZ0/uuOMO2rdvT9u2bSta3jLxtW/fnk6dOvHggw8yYMAADjroIFq3bs0+++yTd12DBw/moosuon379qxatYru3btXXDiT1K1bNy677LKKmFq0aMHq1asrXbX8m9/8hksvvZT27dvj7pSVla2TfP72t7/ljDPO4JFHHuHwww+nRYsWNGrUqCLZzaVv376cf/75NGjQoKDWShHZcFZVc/2mrry83CdOnLixwxDZbEybNo199913Y4chW7AVK1ZQp04d6taty7hx47jgggvytjoWQsfspqWm7x2aVOovpFsqM5vk7vlvehqpBVBERGrMhx9+yGmnncaaNWvYeuutK3X3i8imQwmgiIjUmDZt2uQcGygimxZdBCKSMpvzsA9JFx2rIrVHCaBIitSvX58FCxbog1U2ee7OggULqF+//sYORWSLpC5gkRRp2bIlc+bMYf78+Rs7FJFq1a9fn5YtW27sMES2SEoARVKkXr16tG7demOHISIiG5m6gEVERERSRgmgiIiISMooARQRERFJGSWAIiIiIimjBFBEREQkZZQAioiIiKSMEkARERGRlFECKCIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikTMkSQDPraWbvmNlMM7syx/y+ZjbfzCbHv3NLFZuIiIhImtQtxUrMrA5wG3AsMAeYYGYj3H1qVtFH3L1/KWISERERSatStQB2AWa6+3vu/g0wFDipROsWERERkYRSJYC7AR8lns+J07J938zeMrNhZtaqNKGJiIiIpEtJuoAByzHNs57/C3jY3VeY2fnAfcBR61Rk1g/oB7D77rvXdJwiIlKD7L77aq1uP/vsWqtbZEtXqhbAOUCyRa8lMDdZwN0XuPuK+PRu4MBcFbn7Xe5e7u7lzZs3r5VgRURERLZkpUoAJwBtzKy1mW0N9AFGJAuYWYvE017AtBLFJiIiIpIqJekCdvdVZtYfeAaoA9zr7m+b2UBgoruPAC42s17AKuALoG8pYhMRERFJm1KNAcTdRwIjs6YNSDy+CriqVPGIiIiIpJV+CUREREQkZZQAioiIiKSMEkARERGRlFECKCIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFJGCaCIiIhIyigBFBEREUkZJYAiIiIiKaMEUERERCRllACKiIiIpIwSQBEREZGUUQIoIiIikjJKAEVERERSRgmgiIiISMooARQRERFJGSWAIiIiIimjBFBEREQkZZQAioiIiKSMEkARERGRlFECKCIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFKmZAmgmfU0s3fMbKaZXVlFud5m5mZWXqrYRERERNKkJAmgmdUBbgOOB/YDzjCz/XKUawRcDLxWirhERERE0qhuidbTBZjp7u8BmNlQ4CRgala53wN/Ai4vUVwisgmx++6rtbr97LNrrW4Rkc1NqbqAdwM+SjyfE6dVMLOOQCt3f7Kqisysn5lNNLOJ8+fPr/lIRURERLZwpUoALcc0r5hpthVwM/CL6ipy97vcvdzdy5s3b16DIYqIiIikQ6kSwDlAq8TzlsDcxPNGwP7AaDObDXQFRuhCEBEREZGaV6oEcALQxsxam9nWQB9gRGamuy9092buXubuZcCrQC93n1ii+ERERERSoyQJoLuvAvoDzwDTgEfd/W0zG2hmvUoRg4iIiIgEpboKGHcfCYzMmjYgT9kjShGTiIiISBrpl0BEREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFJGCaCIiIhIyigBFBEREUkZJYAiIiIiKaMEUERERCRllACKiIiIpIwSQBEREZGUKTgBNLNT80zvXXPhiIiIiEhtK6YF8K95pt9VE4GIiIiISGnUra6Ame0ZH25lZq0BS8zeE1heG4GJiIiISO2oNgEEZgJOSPxmZc37FLimhmMSERERkVpUbQLo7lsBmNmL7n547YckIiIiIrWp4DGASv5EREREtgyFdAEDEMf/XQd0ALZLznP33Ws4LhERERGpJQUngMBDhDGAvwCW1k44IiIiIlLbikkA2wHd3H1NbQUjIiIiIrWvmPsAvgR0rK1ARERERKQ0qmwBNLOBiaezgWfM7B+E279UcPcBNR+aiIiIiNSG6rqAW2U9/xdQL8d0EREREdlMVJkAuvuPSxWIiIiIiJRGMbeB2TPPrBXAJ7o4RERERGTzUMxVwJmfhIPws3CemLfGzEYAF7r7ZzUVnIiIiIjUvGKuAj4PeBDYG6gPtAUeAC4EDiAkk7fVdIAiIiIiUrOKaQH8HfAtd18en880swuAd939TjPrC8yo6QBFREREpGYV0wK4FVCWNW13oE58vJjiEkoRERER2QiKSdgGAS+Y2d+Aj4CWwI/jdIATgHE1G56IiIiI1LSCE0B3/5OZvQWcCnQCPgHOcfen4/wngCdqJUoRERERqTFFddnGZO/pWopFREREREqgup+C+5W7XxcfD8xXTj8FJyIiIrL5qO4ikJaJx62q+KuWmfU0s3fMbKaZXZlj/vlm9l8zm2xmr5jZfoW9BBEREREpRnU/BXdB4vF6/yycmdUh3CPwWGAOMMHMRrj71ESxh9z9jli+F/BnoOf6rlO2fHbffbVav599dq3WLyIisrEUcxsYzGxfM/uNmd0an7c1s/YFLNoFmOnu77n7N8BQ4KRkAXf/OvF0Wyr/0oiIiIiI1JCCE0AzOxV4CdgN+FGc3IjQUled3Qi3jsmYE6dlr+MiM5sF/Am4OE8c/cxsoplNnD9/fqHhi4iIiEhUTAvgQOBYdz8fWB2nvQl8u4BlLce0dVr43P02d98L+CXw61wVuftd7l7u7uXNmzcvLHIRERERqVBMArgTIeGDtcmbU1hX7RwqXyzSEphbRfmhwMlFxCYiIiIiBSomAZwE/DBrWh9gfAHLTgDamFlrM9s6LjciWcDM2iSenoB+V1hERESkVhRzI+iLgWfN7BxgWzN7BtgbOK66Bd19lZn1B54h/Hbwve7+dry34ER3HwH0N7NjgJXAl4AuwRQRERGpBdUmgGZ2GvCSu083s32AE4EnCRd1POnuiwtZkbuPBEZmTRuQeHxJMYGLiIiIyPoppAXwWmCveHXuS8CLwKPu/kGtRiYiIiIitaLaMYDuvjewK/ArYBnwC2CWmX1gZn83s3NrOUYRERERqUEFXQTi7p+5+2Pu/jN37wA0Y+0ve9xZmwGKiIiISM0q6CIQMzOgA9A9/h1CuI3Lo8DLtRadiIiIiNS4Qi4CeRLoBLwDvALcBfR190W1HJuIiIiI1IJCuoDbAiuA94FZhN/0VfInIiIispmqtgXQ3duY2c6s7f691MyaAWMI3b+vuPvk2g1TRERERGpKQWMA3f0z4LH4h5k1AfoRfq+3OeHmziIiIiKyGVjfi0AOBZoAE4F7ay06EREREalxhVwE8hThqt+tgdcIN4K+FRjn7strNzwRERERqWmFtAC+DFwHTHD3lbUcj4iIiIjUskIuArm+FIGIiIiISGkU9EsgIiIiIrLlUAIoIiIikjJKAEVERERSRgmgiIiISMooARQRERFJGSWAIiIiIimjBFBEREQkZZQAioiIiKSMEkARERGRlFECKCIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFJGCaCIiIhIyigBFBEREUkZJYAiIiIiKaMEUERERCRllACKiIiIpEzJEkAz62lm75jZTDO7Msf8n5vZVDN7y8yeN7M9ShWbiIiISJqUJAE0szrAbcDxwH7AGWa2X1axN4Byd28PDAP+VIrYRERERNKmVC2AXYCZ7v6eu38DDAVOShZw91HuvjQ+fRVoWaLYRERERFKlVAngbsBHiedz4rR8zgH+XasRiYiIiKRU3RKtx3JM85wFzc4CyoHD88zvB/QD2H333WsqPhEREZHUKFUL4BygVeJ5S2BudiEzOwb4FdDL3Vfkqsjd73L3cncvb968ea0EKyIiIrIlK1UCOAFoY2atzWxroA8wIlnAzDoCdxKSv3kliktEREQkdUqSALr7KqA/8AwwDXjU3d82s4Fm1isWuwHYDnjMzCab2Yg81YmIiIjIBijVGEDcfSQwMmvagMTjY0oVi4iIiEia6ZdARERERFJGCaCIiIhIyigBFBEREUkZJYAiIiIiKaMEUERERCRllACKiIiIpIwSQBEREZGUUQIoIiIikjJKAEVERERSRgmgiIiISMooARQRERFJGSWAIiIiIilTd2MHUEp23321WHvfWqx70+Fn+8YOQURERDaQWgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRJ1X0ARYph99nGDqEkdG9HEZH0UQugiIiISMooARQRERFJGSWAIiIiIimjBFBEREQkZZQAioiIiKSMEkARERGRlFECKCIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFKmZAmgmfU0s3fMbKaZXZljfncze93MVplZ71LFJSIiIpI2JUkAzawOcBtwPLAfcIaZ7ZdV7EOgL/BQKWISERERSau6JVpPF2Cmu78HYGZDgZOAqZkC7j47zltTophEREREUqlUXcC7AR8lns+J04pmZv3MbKKZTZw/f36NBCciIiKSJqVqAbQc03x9KnL3u4C7AMrLy9erDhFJH7sv12loy+Rn69QoIlUrVQI4B2iVeN4SmFuidYuIyBYoLUl9WhL6tOxP2DT2aam6gCcAbcystZltDfQBRpRo3SIiIiKSUJIE0N1XAf2BZ4BpwKPu/raZDTSzXgBm1tnM5gCnAnea2duliE1EREQkbUrVBYy7jwRGZk0bkHg8gdA1LCIiIiK1SL8EIiIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFJGCaCIiIhIyigBFBEREUkZJYAiIiIiKaMEUERERCRllACKiIiIpIwSQBEREZGUUQIoIiIikjJKAEVERERSRgmgiIiISMooARQRERFJGSWAIiIiIimjBFBEREQkZZQAioiIiKSMEkARERGRlFECKCIiIpIySgBFREREUkYJoIiIiEjKKAEUERERSRklgCIiIiIpowRQREREJGWUAIqIiIikjBJAERERkZRRAigiIiKSMkoARURERFJGCaCIiIhIyigBFBEREUkZJYAiIiIiKVOyBNDMeprZO2Y208yuzDF/GzN7JM5/zczKShWbiIiISJqUJAE0szrAbcDxwH7AGWa2X1axc4Av3f1bwM3A/5YiNhEREZG0KVULYBdgpru/5+7fAEOBk7LKnATcFx8PA442MytRfCIiIiKpUbdE69kN+CjxfA5wUL4y7r7KzBYCTYHPk4XMrB/QLz5dbGbv1ErEm5ZmZG2HjcX6KievIdqnWx7t0y2L9ueWJy37dI9CCpUqAcz1Sn09yuDudwF31URQmwszm+ju5Rs7Dqk5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\n",
"text/plain": [
"<matplotlib.figure.Figure at 0x25681e79358>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Import a supervised learning model that has 'feature_importances_'\n",
"from sklearn.ensemble import GradientBoostingClassifier\n",
"\n",
"# Train the supervised model on the training set using .fit(X_train, y_train)\n",
"model = GradientBoostingClassifier(random_state=0, n_estimators=370).fit(X_train, y_train)\n",
"\n",
"# Extract the feature importances using .feature_importances_ \n",
"importances = best_clf.feature_importances_\n",
"\n",
"# Plot\n",
"vs.feature_plot(importances, X_train, y_train)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Extracting Feature Importance\n",
"\n",
"Observe the visualization created above which displays the five most relevant features for predicting if an individual makes at most or above \\$50,000. \n",
"* How do these five features compare to the five features we intuitively extracted?\n",
"* How does this visualization affect your thoughts? \n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"**Answer:**\n",
"\n",
"The model's selected features chose three of the five that I've mentioned, namely; education, age, and capital gain. what's interesting is that the model also placed emphasis on the marital status as those who are married are more likely to make more than 50K. However, similar to my prediction, sex does play a role as it highlighted the important feature or being a husband. This visualization is very indicative of the structure of society at the time and the social and economic strata at that time.\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Feature Selection\n",
"How does a model perform if we only use a subset of all the available features in the data? With less features required to train, the expectation is that training and prediction time is much lower — at the cost of performance metrics. From the visualization above, we see that the top five most important features contribute more than half of the importance of **all** features present in the data. This hints that we can attempt to *reduce the feature space* and simplify the information required for the model to learn. The code cell below will use the same optimized model you found earlier, and train it on the same training set *with only the top five important features*. "
]
},
{
"cell_type": "code",
"execution_count": 90,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Final Model trained on full data\n",
"------\n",
"Accuracy on testing data: 0.8593\n",
"F-score on testing data: 0.7277\n",
"\n",
"Final Model trained on reduced data\n",
"------\n",
"Accuracy on testing data: 0.8432\n",
"F-score on testing data: 0.6886\n"
]
}
],
"source": [
"# Import functionality for cloning a model\n",
"from sklearn.base import clone\n",
"\n",
"# Reduce the feature space\n",
"X_train_reduced = X_train[X_train.columns.values[(np.argsort(importances)[::-1])[:5]]]\n",
"X_test_reduced = X_test[X_test.columns.values[(np.argsort(importances)[::-1])[:5]]]\n",
"\n",
"# Train on the \"best\" model found from grid search earlier\n",
"clf = (clone(best_clf)).fit(X_train_reduced, y_train)\n",
"\n",
"# Make new predictions\n",
"reduced_predictions = clf.predict(X_test_reduced)\n",
"\n",
"# Report scores from the final model using both versions of data\n",
"print(\"Final Model trained on full data\\n------\")\n",
"print(\"Accuracy on testing data: {:.4f}\".format(accuracy_score(y_test, best_predictions)))\n",
"print(\"F-score on testing data: {:.4f}\".format(fbeta_score(y_test, best_predictions, beta = 0.5)))\n",
"print(\"\\nFinal Model trained on reduced data\\n------\")\n",
"print(\"Accuracy on testing data: {:.4f}\".format(accuracy_score(y_test, reduced_predictions)))\n",
"print(\"F-score on testing data: {:.4f}\".format(fbeta_score(y_test, reduced_predictions, beta = 0.5)))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Effects of Feature Selection\n",
"\n",
"* How does the final model's F-score and accuracy score on the reduced data using only five features compare to those same scores when all features are used?\n",
"* If training time was a factor, would we consider using the reduced data as our training set?"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"**Answer:**\n",
"\n",
"Although both the accuracy score and the Fscores decreased, it is still pretty close and I would say that the emphasis placed on a decrease in value is highly dependent of the work environment and the requirement of any particular project.\n",
"\n",
"And again, depending on the needs of the project and the client, if they were ok with this score, I would absolutely reduce the time to run it if possible at all!\n"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python [conda root]",
"language": "python",
"name": "conda-root-py"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.6.4"
}
},
"nbformat": 4,
"nbformat_minor": 1
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment