Urban Microclimate Classification Project

Overview

This repository contains the source code for the "Urban Microclimate Classification Project," which analyzes urban balcony microclimates. The project aims to categorize these microclimates based on temperature and solar radiation data, enabling personalized plant recommendations in urban settings.

Project Structure

• API_and_Data/: Contains scripts for interacting with various APIs and handling data retrieval and preprocessing. It includes scripts for the Boum and FYTA APIs, data fetching, and historical weather data processing.

• clustering_new_data/: This directory contains the application used to predict new data clusters.

• data/: Stores all the collected and processed data, including historical weather data, survey data, and various data frames in CSV and pickled formats. The data is not included for security reasons

• main_project/: Features the primary Jupyter notebook (data_processing_and_clustering.ipynb) encapsulating the entire data processing and clustering process.

• model/: Contains the saved models and scalers used in the project, such as KMeans models for temperature and radiation, along with their respective scalers.

• msc/: Includes additional scripts for temperature error correction, data visualization, and mathematical computations relevant to the study.

• plots/: A directory for storing generated plots and visualizations.

Getting Started

1. Clone this repository to your local machine:

git clone https://github.com/maloan/micro_climate_classification.git  

2. Install the required dependencies:

pip install -r requirements.txt  

Usage

To run the project, follow these steps based on the specific aspect you are interested in:

1. Data Analysis and Clustering: Execute the data_processing_and_clustering.ipynb notebook in the main_project/ directory.
2. Categorizing a new Microclimate: Execute the microclimate_predictor.py program in the clustering_new_data/ directory.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.