sowmi06 / Edible-Mushroom-Classification

A project to classify the Edibility of mushroom-based on its physical features.

Edible-Mushroom-Classification

Table of contents

1. Project Description
2. Configuration Instructions
   1. System Requirements
   2. Tools and Library Requirements
3. Installation Instructions
4. Operating Instructions
5. Manifesting Directory structure
6. Copyrights
7. Contact
8. Bugs
9. Acknowledgement
10. References

Project Description

Mushroom is fleshy and edible fruit bodies of several species of fungi members of Basidiomycetes grown in ground surface or substrate of other plants such as straw and wood some of which are edible, but a minority of them are toxic. Every year, a large number of people die from eating poisonous mushrooms. It is useful to identify whether a mushroom is poisonous according to the appearance features of the mushroom. The automatic recognition of mushroom toxicity has important social and application value in effectively preventing food poisoning. An automatic identification can break through the limitation to determine whether it is toxic.

These mushroom toxicity recognition methods have some limitations, such as low accuracy, unqualified detection of unknown toxins, strict requirements for the experimental environments, sufficient professional knowledge, and complex experimental cycles. To solve these problems, we propose an automatic toxicity identification method based on visual features. Firstly, data is inspected for unbalanced set, followed by preprocessing the dataset by data wrangling(Encoding categorical features, Standardizing the features, Encoding the target variable) to convert the categorical data into numerical data Finally, various classifiers like Logistic Regression, Naive Bayes and Random Forest classifier are applied to check for the accuracies of each classifier and propose the best suitable classifier to recognize the toxicity of mushrooms, even that of some unknown species—according to their appearance features and important social and application value. The implementation result indicates that the Random Forest classifier outperforms.

Configuration Instructions

The Project requires the following tools and libraries to run the source code.

System Requirements

• Anaconda Navigator

  • Python version 3.6.0 – 3.9.0
  • pip 19.0 or later
  • Ubuntu 16.04 or later (64-bit)
  • macOS 10.12.6 (Sierra) or later (64-bit)
  • Windows 7 or later (64-bit)

• Python IDE (to run ".py" file)

  • PyCharm, Spyder or VS code

Tools and Library Requirements

• Numpy

• Scikit-learn

• Pandas

Installation Instructions

To work with the project code

• Clone the Edible-Mushroom-Classification repository into your local machine from this link : https://github.com/sowmi06/Edible-Mushroom-Classification.git

• Follow the same directory structure from the cloned repository.

Operating Instructions

The following are the steps to replicate the exact results acquired from the project:

• Satisify all the system and the tool, libraries requirements.
• Clone the Edible-Mushroom-Classification repository into your local machine.
• Run the LR_NB.py for the Logestic Regression and Naive Bayes results and Random_Forest.py for the Random forest result.
• Follow the same directory structure from the cloned repository.

Manifesting Directory structure

The following directory structure is required to replicate exact results acquired from the project:

Directory layout to repicate results

.
├── .gitignore               
├── LICENSE                
├── LR_NB.py  
├── Preprocessing.py
├── README.md
└── Random_Forest.py

Directories and Files

LR_NB.py - A ".py" file containing the proposed model implementation of the mushroom classification using Naive Bayes and Logestic Regression Classifier.

Random_Forest.py - A ".py" file containing the proposed model implementation of the mushroom classification using Random Forest Classifier.

Preprocessing.py - A ".py" file containing the preprocessing steps.

Readme.md - Readme file to execute the project.

Copyrights

The project is under the MIT. Refer LICENSE file for more information.

Contact

Feel free to drop an email for any help.

Bugs

The code is a finalized and free from bugs.

Acknowledgement

I would like to thank Dr. Thiago E. A. de Oliveira for guiding throughout research paper.

References

• Anaconda Navigator : https://docs.anaconda.com/anaconda/navigator/install/
• PyCharm IDE Installation : https://www.jetbrains.com/pycharm/download/#section=windows
• Spyder IDE Installation : https://www.psych.mcgill.ca/labs/mogillab/anaconda2/lib/python2.7/site-packages/spyder/doc/installation.html
• VS code IDE Installation: https://code.visualstudio.com/download
• Numpy Installation : https://numpy.org/install/
• Scikit learn Installation : https://scikit-learn.org/stable/install.html
• Pandas Installation: https://pandas.pydata.org/docs/getting_started/install.html