Populator Project

📘 Overview

The Populator Project is a Python-based demographic data analysis tool that processes regional population CSV files. It identifies population patterns by age group and location, calculates averages and standard deviations, and computes correlation coefficients between demographic regions.

---

🧩 Features

• Reads population and area CSV files.
• Identifies age groups based on a given age.
• Calculates averages and standard deviations for demographic regions.
• Finds areas with the largest population in a specific age group.
• Computes correlation coefficients between two SA2 areas.

---

⚙️ Usage Example

python3 -c "from scripts.populator import main; OP1, OP2, OP3, OP4 = main('data/SampleData_Areas.csv', 'data/SampleData_Populations.csv', 18, '401011001', '401021003'); print(OP1, OP2, OP3, OP4)"

---

🧮 Expected Outputs

• OP1 → Age group bounds (e.g., [15, 19])
• OP2 → Statistics for two SA3 regions.
• OP3 → State-level SA3 area with largest population in that age group.
• OP4 → Correlation coefficient between the two SA2 areas.

---

🧠 Project Structure

populator-project/
│
├── data/
│   ├── SampleData_Areas.csv
│   └── SampleData_Populations.csv
│
├── scripts/
│   └── populator.py
│
├── docs/
│   └── Debugging_Notes.txt
│
├── README.md
├── LICENSE
└── .gitignore

---

🪪 License

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

---

👤 Author: @cuddiecoder