This project aims to predict housing prices in the Boston area using various machine learning models. It leverages the Boston Housing dataset, applying preprocessing techniques, feature engineering, and model evaluation to understand and predict housing prices effectively.
Before running this project, ensure you have the following installed:
- Python 3.8 or later
- pip (Python package manager)
- Clone the repository to your local machine:
git clone https://github.com/pramodyasahan/Boston-Housing-Project.git
- Navigate to the project directory:
cd Boston-Housing-Project
- Install the required Python packages:
pip install -r requirements.txt
To run the project and train the machine learning model, execute the main.py
script with the necessary command-line arguments. For example:
python main.py --model_type linear_regression
--data_path
: Path to the raw dataset. Default isdata/raw/HousingData.csv
.--data_processed_path
: Path to save the processed dataset. Default isdata/processed/Clean_HousingData.csv
.--model_path
: Path to save the trained model. Default ismodels/linear_regression.joblib
.--model_type
: Type of model to train. Supported values includelinear_regression
,logistic_regression
,svm
,random_forest_regression
, anddecision_tree_regression
.
Boston-Housing-Project/
├── data/
│ ├── raw/ # Original dataset
│ └── processed/ # Preprocessed dataset
├── src/
│ ├── data/ # Data loading and preprocessing scripts
│ ├── features/ # Feature engineering scripts
│ ├── models/ # Model training, prediction, and evaluation scripts
├── requirements.txt # Python package dependencies
└── main.py # Main script to run the project
This project includes several machine learning models for predicting housing prices:
- Linear Regression
- Logistic Regression (for classification tasks related to housing)
- Support Vector Machine (SVM)
- Random Forest
- Decision Tree
Contributions to improve the project are welcome. Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/AmazingFeature
). - Commit your changes (
git commit -m 'Add some AmazingFeature'
). - Push to the branch (
git push origin feature/AmazingFeature
). - Open a pull request.
Distributed under the MIT License. See LICENSE
for more information.
Project Link: https://github.com/pramodyasahan/Boston-Housing-Project