Using Machine Learning to Analyze the 2nd Round of the 2022 Brazilian Presidential Election

Overview

The Jupyter Notebook in this repository is my Final Project for the Artificial Intelligence Diploma program of The University of Winnipeg - Professional, Applied and Continuing Education (PACE). The idea of this project is to extract the available data generated by the Electronic Voting Machines (EVM) that were used in the 2nd Round of the 2022 Brazilian Presidential Election, clean it, analyze it, and then use clustering models to find data patterns - especially hidden or non-intuitive patterns - and anomalies.

Prerequisites

• Jupyter Notebook or JupyterLab
• Python 3.7 or higher
• Necessary Python packages (listed in requirements.txt)

Installation and Setup

1. Clone the repository or download the Jupyter Notebook file.

2. Install Jupyter Notebook or JupyterLab if you haven't already.

3. Set up a Python environment and install the required packages using:

   pip install -r requirements.txt

4. Open the Jupyter Notebook environment and navigate to the notebook file to begin your analysis.

Running the Notebook

To run the notebook:

1. Open the Jupyter Notebook or JupyterLab.
2. Navigate to the location of the using-ml-to-analyze-the-2022-brazilian-elections.ipynb file.
3. Open the notebook and run the cells sequentially to perform the analysis.

PS.: in the Data Ingestion phase, item 2.2, there is a cell dedicated to run the "Bra Scraper 2022" which is essentially the web scraper bot that gets all the desired data of EVMs from the TSE website. If necessary, run it apart from the Notebook.

License

This project is licensed under the MIT License - see the LICENSE file for details.