enerlytics 0.1.0__tar.gz

enerlytics-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Huseyin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

enerlytics-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: enerlytics
+Version: 0.1.0
+Summary: Renewable energy insights dashboard — data-driven exploration of energy systems and consumption patterns.
+Author-email: Huseyin Kucukogul <huseyinkucukogulcontact@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Huseyin
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/Kucukogul/enerlytics
+Project-URL: Repository, https://github.com/Kucukogul/enerlytics
+Keywords: energy,renewable energy,data science,dashboard,analytics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: plotly>=5.0.0
+Requires-Dist: streamlit>=1.20.0
+Dynamic: license-file
+
+# 🌍 Renewable Energy Insights Dashboard
+
+The **Renewable Energy Insights Dashboard** is a data analysis project focused on the **United States**, exploring how renewable energy production — including solar, wind, hydroelectric, geothermal, and biomass — has evolved from 1973 to 2024. By transforming raw U.S. Energy Information Administration (EIA) data into interactive insights, this project supports data-driven decisions for a sustainable energy future.
+
+---
+
+## 🎯 Objectives
+
+- Analyze U.S. renewable energy production by **year, energy source, and sector** (e.g., electric power, industrial)
+- Identify long-term **growth trends** and **structural shifts** in energy mix
+- Create **interactive visualizations** to reveal patterns and anomalies
+- Deliver insights through a user-friendly **Streamlit dashboard**
+
+---
+
+## 🧩 Tech Stack
+
+| Category         | Tools / Libraries                     |
+|------------------|---------------------------------------|
+| Programming      | Python                                |
+| Data Handling    | Pandas, NumPy                         |
+| Visualization    | Matplotlib, Seaborn, Plotly           |
+| Dashboard        | Streamlit                             |
+| Deployment       | Streamlit Cloud / Render              |
+| Version Control  | Git & GitHub                          |
+
+---
+
+## 📊 Features
+
+✅ Clean and aggregate monthly EIA data into **annual totals**  
+✅ Visualize **historical trends (1973–2024)** by energy type  
+✅ Compare contributions of **solar, wind, hydro, geothermal, biomass, and waste**  
+✅ Interactive Streamlit dashboard with dynamic filtering  
+✅ Modular design — ready to extend with **time-series forecasting** (e.g., Prophet, ARIMA)

enerlytics-0.1.0/README.md

@@ -0,0 +1,35 @@
+# 🌍 Renewable Energy Insights Dashboard
+
+The **Renewable Energy Insights Dashboard** is a data analysis project focused on the **United States**, exploring how renewable energy production — including solar, wind, hydroelectric, geothermal, and biomass — has evolved from 1973 to 2024. By transforming raw U.S. Energy Information Administration (EIA) data into interactive insights, this project supports data-driven decisions for a sustainable energy future.
+
+---
+
+## 🎯 Objectives
+
+- Analyze U.S. renewable energy production by **year, energy source, and sector** (e.g., electric power, industrial)
+- Identify long-term **growth trends** and **structural shifts** in energy mix
+- Create **interactive visualizations** to reveal patterns and anomalies
+- Deliver insights through a user-friendly **Streamlit dashboard**
+
+---
+
+## 🧩 Tech Stack
+
+| Category         | Tools / Libraries                     |
+|------------------|---------------------------------------|
+| Programming      | Python                                |
+| Data Handling    | Pandas, NumPy                         |
+| Visualization    | Matplotlib, Seaborn, Plotly           |
+| Dashboard        | Streamlit                             |
+| Deployment       | Streamlit Cloud / Render              |
+| Version Control  | Git & GitHub                          |
+
+---
+
+## 📊 Features
+
+✅ Clean and aggregate monthly EIA data into **annual totals**  
+✅ Visualize **historical trends (1973–2024)** by energy type  
+✅ Compare contributions of **solar, wind, hydro, geothermal, biomass, and waste**  
+✅ Interactive Streamlit dashboard with dynamic filtering  
+✅ Modular design — ready to extend with **time-series forecasting** (e.g., Prophet, ARIMA)

enerlytics-0.1.0/app/dashboard.py

@@ -0,0 +1,121 @@
+import streamlit as st
+import pandas as pd
+import numpy as np
+import matplotlib.pyplot as plt
+from sklearn.linear_model import LinearRegression
+from sklearn.preprocessing import PolynomialFeatures
+import os
+
+@st.cache_data
+def load_data():
+    current_dir = os.path.dirname(__file__)
+    project_root = os.path.dirname(current_dir)
+    data_path = os.path.join(project_root, "data", "renewable_energy.csv")
+
+    if not os.path.exists(data_path):
+        raise FileNotFoundError(f"Data file not found: {data_path}")
+
+    df = pd.read_csv(data_path)
+    energy_cols = [
+        'Hydroelectric Power', 'Geothermal Energy', 'Solar Energy',
+        'Wind Energy', 'Wood Energy', 'Waste Energy', 'Biomass Energy',
+        'Total Renewable Energy'
+    ]
+
+    for col in energy_cols:
+        if col not in df.columns:
+            df[col] = 0.0
+    annual = df.groupby('Year')[energy_cols].sum().reset_index()
+    return annual
+
+annual_data = load_data()
+
+st.set_page_config(page_title="Renewable Energy Insights", layout="wide")
+st.title("🌍 U.S. Renewable Energy Insights Dashboard")
+st.markdown("""
+Explore how renewable energy production in the United States has evolved from 1973 to 2024.  
+Data source: U.S. Energy Information Administration (EIA).
+""")
+
+st.sidebar.header("🔍 Customize View")
+energy_type = st.sidebar.selectbox(
+    "Select Energy Source",
+    options=[
+        "Total Renewable Energy",
+        "Solar Energy",
+        "Wind Energy",
+        "Hydroelectric Power",
+        "Geothermal Energy",
+        "Biomass Energy",
+        "Wood Energy",
+        "Waste Energy"
+    ]
+)
+
+forecast_enabled = st.sidebar.checkbox("Show Forecast (2025–2030)", value=False)
+
+st.subheader(f"Annual {energy_type} Production (1973–2024)")
+fig1, ax1 = plt.subplots(figsize=(10, 4))
+ax1.plot(annual_data['Year'], annual_data[energy_type],
+         marker='o', linewidth=2, color='tab:blue')
+ax1.set_xlabel("Year")
+ax1.set_ylabel("Production (Trillion Btu)")
+ax1.grid(True, alpha=0.3)
+st.pyplot(fig1)
+
+st.subheader(f"Yearly Change in {energy_type}")
+annual_data['Change'] = annual_data[energy_type].diff()
+fig2, ax2 = plt.subplots(figsize=(10, 4))
+
+positive = annual_data[annual_data['Change'] >= 0]
+negative = annual_data[annual_data['Change'] < 0]
+
+ax2.bar(positive['Year'], positive['Change'], color='green', label='Increase')
+ax2.bar(negative['Year'], negative['Change'], color='red', label='Decrease')
+ax2.axhline(0, color='black', linewidth=0.8)
+ax2.set_xlabel("Year")
+ax2.set_ylabel("Change (Trillion Btu)")
+ax2.legend()
+ax2.grid(axis='y', alpha=0.3)
+st.pyplot(fig2)
+
+if forecast_enabled:
+    st.subheader(f"Forecast: {energy_type} (2025–2030)")
+
+    X = annual_data[['Year']].values
+    y = annual_data[energy_type].values
+
+    poly = PolynomialFeatures(degree=2)
+    X_poly = poly.fit_transform(X)
+    model = LinearRegression()
+    model.fit(X_poly, y)
+
+    future_years = np.arange(2025, 2031).reshape(-1, 1)
+    future_poly = poly.transform(future_years)
+    future_pred = model.predict(future_poly)
+    future_pred = np.maximum(future_pred, 0)
+
+    all_years = np.concatenate([annual_data['Year'].values, future_years.flatten()])
+    all_pred = np.concatenate([model.predict(X_poly), future_pred])
+
+    fig3, ax3 = plt.subplots(figsize=(10, 4))
+    ax3.plot(annual_data['Year'], annual_data[energy_type],
+             label='Historical', color='blue', marker='o')
+    ax3.plot(all_years, all_pred,
+             label='Forecast (Polynomial)', color='orange', linestyle='--')
+    ax3.axvline(2024.5, color='gray', linestyle=':', label='Forecast Start')
+    ax3.set_xlabel("Year")
+    ax3.set_ylabel("Production (Trillion Btu)")
+    ax3.legend()
+    ax3.grid(True, alpha=0.3)
+    st.pyplot(fig3)
+
+
+    forecast_df = pd.DataFrame({
+        'Year': future_years.flatten(),
+        f'{energy_type} (Forecast)': future_pred
+    })
+    st.dataframe(forecast_df.round(2))
+
+st.markdown("---")
+st.caption("Built with using Streamlit | Data: U.S. Renewable Energy Consumption")

enerlytics-0.1.0/enerlytics.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: enerlytics
+Version: 0.1.0
+Summary: Renewable energy insights dashboard — data-driven exploration of energy systems and consumption patterns.
+Author-email: Huseyin Kucukogul <huseyinkucukogulcontact@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Huseyin
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/Kucukogul/enerlytics
+Project-URL: Repository, https://github.com/Kucukogul/enerlytics
+Keywords: energy,renewable energy,data science,dashboard,analytics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: plotly>=5.0.0
+Requires-Dist: streamlit>=1.20.0
+Dynamic: license-file
+
+# 🌍 Renewable Energy Insights Dashboard
+
+The **Renewable Energy Insights Dashboard** is a data analysis project focused on the **United States**, exploring how renewable energy production — including solar, wind, hydroelectric, geothermal, and biomass — has evolved from 1973 to 2024. By transforming raw U.S. Energy Information Administration (EIA) data into interactive insights, this project supports data-driven decisions for a sustainable energy future.
+
+---
+
+## 🎯 Objectives
+
+- Analyze U.S. renewable energy production by **year, energy source, and sector** (e.g., electric power, industrial)
+- Identify long-term **growth trends** and **structural shifts** in energy mix
+- Create **interactive visualizations** to reveal patterns and anomalies
+- Deliver insights through a user-friendly **Streamlit dashboard**
+
+---
+
+## 🧩 Tech Stack
+
+| Category         | Tools / Libraries                     |
+|------------------|---------------------------------------|
+| Programming      | Python                                |
+| Data Handling    | Pandas, NumPy                         |
+| Visualization    | Matplotlib, Seaborn, Plotly           |
+| Dashboard        | Streamlit                             |
+| Deployment       | Streamlit Cloud / Render              |
+| Version Control  | Git & GitHub                          |
+
+---
+
+## 📊 Features
+
+✅ Clean and aggregate monthly EIA data into **annual totals**  
+✅ Visualize **historical trends (1973–2024)** by energy type  
+✅ Compare contributions of **solar, wind, hydro, geothermal, biomass, and waste**  
+✅ Interactive Streamlit dashboard with dynamic filtering  
+✅ Modular design — ready to extend with **time-series forecasting** (e.g., Prophet, ARIMA)

enerlytics-0.1.0/enerlytics.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+app/__init__.py
+app/dashboard.py
+enerlytics.egg-info/PKG-INFO
+enerlytics.egg-info/SOURCES.txt
+enerlytics.egg-info/dependency_links.txt
+enerlytics.egg-info/entry_points.txt
+enerlytics.egg-info/requires.txt
+enerlytics.egg-info/top_level.txt

enerlytics-0.1.0/enerlytics.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

enerlytics-0.1.0/enerlytics.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+enerlytics = enerlytics.dashboard:main

enerlytics-0.1.0/enerlytics.egg-info/requires.txt

@@ -0,0 +1,4 @@
+pandas>=1.5.0
+numpy>=1.24.0
+plotly>=5.0.0
+streamlit>=1.20.0

enerlytics-0.1.0/enerlytics.egg-info/top_level.txt

@@ -0,0 +1 @@
+app

enerlytics-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "enerlytics"
+version = "0.1.0"
+description = "Renewable energy insights dashboard — data-driven exploration of energy systems and consumption patterns."
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "Huseyin Kucukogul", email = "huseyinkucukogulcontact@gmail.com" }]
+requires-python = ">=3.10"
+keywords = ["energy", "renewable energy", "data science", "dashboard", "analytics"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "pandas>=1.5.0",
+    "numpy>=1.24.0",
+    "plotly>=5.0.0",
+    "streamlit>=1.20.0",
+]
+
+[project.scripts]
+enerlytics = "enerlytics.dashboard:main"
+
+[project.urls]
+Homepage = "https://github.com/Kucukogul/enerlytics"
+Repository = "https://github.com/Kucukogul/enerlytics"
+
+[tool.setuptools.packages]
+find = { where = ["."], include = ["app*"] }
+
+[tool.setuptools.package-dir]
+enerlytics = "app"

enerlytics-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+