Heat Mapping Project

This is a Python-based project to capture temperature and humidity data using a Raspberry Pi. This repo includes the main script for data capture, setup instructions, and test scripts for development and debugging.

This is part of a larger project to map heat across urban environments.

📦 Project Structure

heat-project/
 |--- README.md                 <-- You are here.
 |--- src/                      <-- Main  Python Scripts
 | |--- capture_data.py         <-- Main Script
 |--- test_scripts/             <-- tests
 |--- data/                     <-- Data Repo
 |--- logs/
 |--- docs/                     
 | |--- setup_instructions.md   <-- Setup instructions
 | |--- images/
 | |--- misc/
 |--- env/                      <-- vitural environment for Python
 |--- requirement.txt           <-- Python dependencies
 |--- .gitignore                

🚀 Quick Start

If you have a Raspberry Pi all set up, you can follow the instructions below. Otherwise, start here to set up your Pi and install all the dependencies.

1. Clone the repository

git clone https://github.com/marositesUSC/heat_project.git
cd heat-project

2. Create and activate a virtual environment

python -m venv env
source env/bin/activate

After you activate your virtual environment you should notice (env) in your console. Keep it activated now, but if you want, you can deactivate your virtual environment by running the command deactivate.

3. Install Dependencies

pip install -r requirements.txt

4. Run the data capture script

python src/capture_data.py

If you want the script to run on boot, check out the instructions here.

🛠 Hardware Setup

Here is a basic wiring diagram for connecting the sensors to the

For temperature and humidity, we use I²C communication for the SHT3x sensors.

For location data, we connect via UHAT to an Adafruit Ultimate GPS moduel and GSPD.

More setup details can be found in docs/setup_instructions.md.

If you have a working Pi, you can clone it to a new device. Follow these instructions.