Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 50 additions & 0 deletions Homepage.py
Original file line number Diff line number Diff line change
Expand Up @@ -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**

Check failure on line 33 in Homepage.py

View workflow job for this annotation

GitHub Actions / tests

ruff (W291)

Homepage.py:33:49: W291 Trailing whitespace help: Remove trailing whitespace
https://www.eia.gov/opendata/browser/petroleum/cons/wpsup

- **Weekly WTI Crude Oil Spot Price (RWTC)**

Check failure on line 36 in Homepage.py

View workflow job for this annotation

GitHub Actions / tests

ruff (W291)

Homepage.py:36:49: W291 Trailing whitespace help: Remove trailing whitespace
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?
""")

Check failure on line 47 in Homepage.py

View workflow job for this annotation

GitHub Actions / tests

ruff (W293)

Homepage.py:47:1: W293 Blank line contains whitespace help: Remove whitespace from blank line
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

Check failure on line 53 in Homepage.py

View workflow job for this annotation

GitHub Actions / tests

ruff (W291)

Homepage.py:53:71: W291 Trailing whitespace help: Remove trailing whitespace
- Weekly time-series line chart of WTI crude oil price

Check failure on line 54 in Homepage.py

View workflow job for this annotation

GitHub Actions / tests

ruff (W291)

Homepage.py:54:59: W291 Trailing whitespace help: Remove trailing whitespace
- 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.")
Expand Down
Loading