From 3b1a06783980d6c3adcf284e617b0d9aff7b7d18 Mon Sep 17 00:00:00 2001
From: Irina <bs3559@columbia.edu>
Date: Wed, 11 Mar 2026 19:53:02 -0400
Subject: [PATCH] Adding the proposal to the app

---
 Homepage.py | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/Homepage.py b/Homepage.py
index 16664ca..9f5b149 100644
--- a/Homepage.py
+++ b/Homepage.py
@@ -15,6 +15,56 @@
 st.subheader("Team Members: Irina, Indra")
 st.caption("Source: U.S. Energy Information Administration (EIA)")
 
+# =========================
+# Project Proposal
+# =========================
+with st.expander("Project Proposal", expanded=False):
+
+    st.subheader("Project Overview")
+    st.write("""
+    This project analyzes weekly U.S. petroleum product supplied data and
+    WTI crude oil spot price data using the EIA API. Our goal is to explore
+    how petroleum supply and crude oil prices evolve over time and whether
+    they exhibit similar patterns during major economic or energy market events.
+    """)
+
+    st.subheader("Datasets")
+    st.markdown("""
+    - **Weekly U.S. Petroleum Product Supplied**  
+      https://www.eia.gov/opendata/browser/petroleum/cons/wpsup
+
+    - **Weekly WTI Crude Oil Spot Price (RWTC)**  
+      https://www.eia.gov/opendata/browser/petroleum/pri/spt
+    """)
+
+    st.subheader("Research Questions")
+    st.markdown("""
+    1. How has U.S. petroleum product supplied changed since 2012?
+    2. How has WTI crude oil price changed over the same period?
+    3. Do petroleum supply and crude oil prices show similar patterns over time?
+    4. Are there noticeable disruptions during major events such as COVID-19 period?
+    """)
+    
+    st.subheader("Link to the notebook")
+    st.markdown("[Project Notebook](https://github.com/advanced-computing/giggling-wombat/blob/main/project.ipynb)")
+
+    st.subheader("Target Visualization")
+    st.markdown("""
+    - Weekly time-series line chart of U.S. petroleum product supplied  
+    - Weekly time-series line chart of WTI crude oil price  
+    - Visual comparison of trends between the two series
+    """)
+
+    st.subheader("Known Unknowns and Challenges")
+    st.markdown("""
+    - Petroleum product supplied is a proxy for demand rather than a direct measure
+    - Weekly data can be noisy and may obscure long-term trends
+    - Oil prices and supply may react to different economic forces
+    - The project depends on API data retrieval instead of downloadable CSV files
+    """)
+
+st.divider()
+
 API_KEY = st.secrets.get("EIA_API_KEY", None)
 if not API_KEY:
     st.error("Missing EIA API key. Set it in Streamlit Secrets as EIA_API_KEY.")