The current repository contains different scripts, in which functions are implemented in Python from scratch, to carry out a classification problem using a random forest algorithm.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

You need Python 3.x to run the following code. You can have multiple Python versions (2.x and 3.x) installed on the same system without problems.

In Ubuntu, Mint and Debian you can install Python 3 like this:

sudo apt-get install python3 python3-pip

The Jupyter Notebook which can be installed through Python's package manager:

pip3 install --upgrade pip
pip3 install jupyter

For other Linux flavors, OS X and Windows:

Python is available at http://www.python.org/getit/
Jupyter Notebook at https://jupyter.readthedocs.io/en/latest/install.html

• The files "sonar-all-data.csv" and "wheat_seeds.csv" correspond to the dataset used in the notebook.

• "Open_conversion_data.py" contains all initial operations to be done to read the data from a CSV file, modify the variable types in the different columns (features) of the dataset, as well as data re-scaling, such as normalization and standardization. For more information on the different operations, the reader is referred to the Jupyter notebook Open_conversion_data.ipynb where the different functions are more elaborated.

• In "Algorithm_test_harness.py" 2 approaches to split a dataset are implemented, to understand how the split between training and testing occur for machine learning problems. The main algorithm procedure based on the data split is also implemented, to evaluate the performances of a particular model.

• "Performance_assessment.py" is a Python script in which accuracy metrics to measure machine learning algorithms performance are introduced, and implemented in a simple way. The Jupyter notebook Performance_assessment.ipynb is available for more details.

• "Tree_model_RF.py" is the Python implementation of the Random Forest (RF) model for a classification problem, and following a Classification And Regression Trees (CART) approach.

• "Sonar_case_study.py" is the main Python script, calling the different functions from the scripts above, to perform a classification analysis of the sonar case, with the implemented random forest model. To change to the wheat seeds dataset, the user just needs to change the file in the load_csv function call.

• "Sonar_case_study.ipynb" is the Jupyter notebook version of the ".py" script.

• "Random_Forest_from_scratch.pdf" is the pdf file with explanation on the different steps required to implement from zero, a RF model, with application on the sonar dataset.

The different ".py" files need to be placed in the same folder for the main script to be run. The code is then ready to be used on the wheat seeds dataset and just requires running the following command:

python Sonar_case_study.py

The notebook can be directly opened on GitHub. An alternative way to open the notebooks, is to run the Jupyter Notebook. This can be done by executing the following command at the Terminal (Mac/Linux) or Command Prompt (Windows):

jupyter notebook

This will print some information about the notebook server in your terminal, including the URL of the web application (by default, http://localhost:8888):

$ jupyter notebook
[I 11:47:00.830 NotebookApp] Serving notebooks from local directory: C:\Users\EC-PM-3
[I 11:47:00.830 NotebookApp] The Jupyter Notebook is running at:
[I 11:47:00.830 NotebookApp] http://localhost:8888/?token=d22181d47f4826316a37161bb8c8469d77a5851bf9ab2c1f
[I 11:47:00.830 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).

It will then open your default web browser to this URL.

When the notebook opens in your browser, you will see the Notebook Dashboard, which will show a list of the notebooks, files, and subdirectories in the directory where the notebook server was started. The notebook can then be chosen by navigating in the Notebook Dashboard.

For more information on how to run a specific jupyter notebook, you can go to the following link.

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

We use SemVer for versioning. For the versions available, see the tags on this repository.

• David Cicoria - Initial work - DavidCico

See also the list of contributors who participated in this project.