🌿 Green Development Planner

Striving for a more sustainable Earth.

Geoff McKay, CC BY 2.0 https://creativecommons.org/licenses/by/2.0, via Wikimedia Commons

👀 The Challenge

One of the world's pressing challenges is achieving equal access to renewable energy in developing nations, a key to sustainable development and economic prosperity. Addressing this issue requires strategic resource allocation, which requires a deep understanding of each nation's energy needs and renewable capacity. By targeting areas where financial support of green energy projects yields the most impact, we can guide efforts and investments to foster development, equity, and environmental conservation.

💡 Our vision

We have developed a dashboard to illuminate these critical insights for decision-makers and funding bodies. Our dashboard highlights where resources can make the most significant impact. By providing a clear global overview of energy consumption, potential for renewables, current investment flows, and country's GDP, we empower stakeholders to make data-driven decisions. Our ultimate goal is to facilitate the global transition to renewable energy, a key step towards global equity and sustainability.

📚 A Quick Overview

Our dashboard offers a high-level overview of renewable energy metrics across the globe. The interactive world map enables users to select and visualize data spanning 20 years, featuring six key indicators: the percentage of renewable energy in total energy consumption, electricity access rates (% of population), financial investments in clean energy projects, and electricity generation breakdown by sources (i.e., fossil fuels, nuclear, and renewables) for each country. A time slider allows for a historical perspective on these indicators.

On the right, the dashboard provides a country-specific analysis with two arc charts, two bar charts and two cards. The arc charts display the ratio of energy consumption by energy source and the electricity generation mix over the last five years. The bar charts compares a country's electricity access and financial flow for clean energy against the world average, again over the last five years. By using the average data of a latest five-year period, we ensure that the information captures the most recent situations, offering users an up-to-date, actionable snapshot of energy development. The two cards at the bottom display the selected country's population and GDP per capita.

💻 Use the App

Explore our dashboard to unlock insights into renewable energy access here. Intuitive controls and dynamic visuals guide strategic resource allocation. Dive in to make informed decisions for sustainable growth.

🪜 How to get support?

Need help or feedback? Open an issue on our GitHub – we're ready to assist your journey towards informed actions for a sustainable future.

📖 Developer's Guide

Step 1: Clone the repository

Start by cloning the repository to your local machine. Open your terminal and run the following command:

$ git clone git@github.com:UBC-MDS/DSCI-532_2024_6_Green-Development-Planner.git

Step 2: Create the virtual environment

Create a new Conda environment using the environment.yml file provided in this repository. This file contains all the necessary dependencies.

To create the environment, open your terminal and navigate to the directory where the environment.yml file is located. Then, run the following command:

$ conda env create -f environment.yml
$ conda activate green-development-planner

Step 3: Configure the Application for Development

For development purpose, set debug=True in file src/app.py.

if __name__ == "__main__":
    app.run_server(debug=True)

Step 4: Change the path for reading data

Navigate into src/data/data.py and comment the section under # For deployment on render.

world = gpd.read_parquet("../data/preprocessed/world_countries.parquet")
gdf = gpd.read_parquet("../data/preprocessed/preprocessed_gdf.parquet")
consump_pie_data = pd.read_parquet("../data/preprocessed/consump_pie_data.parquet")
elec_pie_data = pd.read_parquet("../data/preprocessed/elec_pie_data.parquet")
access_to_electricity = pd.read_parquet("../data/preprocessed/access_to_electricity.parquet")
financial_flow = pd.read_parquet("../data/preprocessed/financial_flow.parquet") 
gdp_per_capita = pd.read_parquet("../data/preprocessed/gdp_per_capita.parquet")
population = pd.read_parquet("../data/preprocessed/population_df.parquet")

Then uncomment the section under # For development on local machine.

# world = gpd.read_parquet("data/preprocessed/world_countries.parquet")
# gdf = gpd.read_parquet("data/preprocessed/preprocessed_gdf.parquet")
# consump_pie_data = pd.read_parquet("data/preprocessed/consump_pie_data.parquet")
# elec_pie_data = pd.read_parquet("data/preprocessed/elec_pie_data.parquet")
# access_to_electricity = pd.read_parquet("data/preprocessed/access_to_electricity.parquet")
# financial_flow = pd.read_parquet("data/preprocessed/financial_flow.parquet") 
# gdp_per_capita = pd.read_parquet("data/preprocessed/gdp_per_capita.parquet")
# population = pd.read_parquet("data/preprocessed/population_df.parquet")

Note: Before deployment on render.com, remember to reverse this step (comment the development section and uncomment the deployment section).

Step 5: Run the dashboard

Navigate to the project root directory and use the following command.

$ python ./src/app.py

✨ Contributing

Contributions are welcome! Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

👥 Contributors

• Ben Chen (\@phchen5)
• Yi Han (\@yhan178)
• Ian MacCarthy (\@ianm99)
• Joey Wu (\@joeywwwu)

©️ License

This Green Development Planner dashboard was created by Ben Chen, Yi Han, Ian MacCarthy, and Joey Wu. It is licensed under the terms of the MIT license.