update: refresh exploratory data analysis workshop materials (#1)

* Restructure: config + workshops, add EDA deck

* Add Polars EDA notebooks and data

Introduce the exploratory data analysis workshop notebooks with Polars and add the penguins dataset, plus README links for the new materials.

* add: improved eda workshop material

* update: refresh exploratory data analysis workshop materials

Align the EDA workshop slides and canonical notebooks around the Polars-first flow, add concise intro concept slides, and remove old improved notebook variants while keeping speaker notes out of this commit.

Author: alptezbasaran

.github/workflows/deploy-page.yml

@@ -4,11 +4,9 @@ on:
   push:
     branches: [main]
     paths:
-      - "slides/**"
-      - "fundamentals/**"
-      - "loops-and-functions/**"
+      - "config/**"
+      - "workshops/**"
       - "assets/**"
-      - "_quarto.yml"
   workflow_dispatch:
 
 permissions:
@@ -35,7 +33,7 @@ jobs:
           path: |
             .quarto-cache
             ~/.cache/quarto
-          key: ${{ runner.os }}-quarto-${{ hashFiles('_quarto.yml', 'slides/index.qmd', 'fundamentals/index.qmd', 'loops-and-functions/index.qmd', 'slides/theme/**') }}
+          key: ${{ runner.os }}-quarto-${{ hashFiles('config/_quarto.yml', 'config/slides/index.qmd', 'workshops/fundamentals/index.qmd', 'workshops/loops-and-functions/index.qmd', 'workshops/exploratory-data-analysis/index.qmd', 'config/slides/theme/**') }}
           restore-keys: |
             ${{ runner.os }}-quarto-
 
@@ -46,21 +44,27 @@ jobs:
 
       - name: Render slides
         run: |
+          cd config
           quarto render slides/index.qmd
-          quarto render fundamentals/index.qmd --to revealjs
-          quarto render loops-and-functions/index.qmd --to revealjs
+          quarto render ../workshops/fundamentals/index.qmd --to revealjs
+          quarto render ../workshops/loops-and-functions/index.qmd --to revealjs
+          quarto render ../workshops/exploratory-data-analysis/index.qmd --to revealjs
 
       - name: Assemble Pages site
         run: |
           rm -rf site
           mkdir -p site
-          cp slides/index.html site/index.html
-          rsync -av slides/index_files/ site/index_files/
+          cp config/slides/index.html site/index.html
+          rsync -av config/slides/index_files/ site/index_files/ 2>/dev/null || true
           rsync -av assets/ site/assets/
-          rsync -av fundamentals/ site/fundamentals/ --exclude "*.ipynb" --exclude "*.qmd"
-          rsync -av loops-and-functions/ site/loops-and-functions/ --exclude "*.ipynb" --exclude "*.qmd"
-          # Landing page is at site root; fix logo path so it loads (../assets/ -> assets/)
-          sed -i.bak 's|../assets/|assets/|g' site/index.html && rm -f site/index.html.bak
+          rsync -av workshops/fundamentals/ site/fundamentals/ --exclude "*.ipynb" --exclude "*.qmd"
+          rsync -av workshops/loops-and-functions/ site/loops-and-functions/ --exclude "*.ipynb" --exclude "*.qmd"
+          rsync -av workshops/exploratory-data-analysis/ site/exploratory-data-analysis/ --exclude "*.ipynb" --exclude "*.qmd"
+          # Landing page: fix logo path (../../assets/ -> assets/)
+          sed -i.bak 's|../../assets/|assets/|g' site/index.html && rm -f site/index.html.bak
+          # Workshop pages: fix asset paths (../../assets/ -> ../assets/) so they load from site/fundamentals/ etc.
+          sed -i.bak 's|../../assets/|../assets/|g' site/fundamentals/index.html site/loops-and-functions/index.html site/exploratory-data-analysis/index.html 2>/dev/null || true
+          rm -f site/fundamentals/index.html.bak site/loops-and-functions/index.html.bak site/exploratory-data-analysis/index.html.bak 2>/dev/null || true
 
       - name: Upload Pages artifact (site root)
         uses: actions/upload-pages-artifact@v3

Dockerfile

@@ -23,4 +23,4 @@ COPY . .
 EXPOSE 4000
 
 # Default command: run preview for the deck
-CMD ["bash", "-lc", "quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"]
+CMD ["bash", "-lc", "cd config && quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"]

LOCAL.md

@@ -10,7 +10,7 @@
 
 1. Create and activate the environment:
 ```bash
-micromamba create -y -f environment.yml
+micromamba create -y -f config/environment.yml
 micromamba activate intro-to-prog-py
 ```
 
@@ -23,8 +23,8 @@ jupyter lab
 
 3. Execute notebooks headlessly (optional):
 ```bash
-python -m nbconvert --to notebook --execute fundamentals/fundamentals.ipynb --output executed_basic.ipynb
-python -m nbconvert --to notebook --execute loops-and-functions/loops-and-functions.ipynb --output executed_control.ipynb
+python -m nbconvert --to notebook --execute workshops/fundamentals/fundamentals.ipynb --output executed_basic.ipynb
+python -m nbconvert --to notebook --execute workshops/loops-and-functions/loops-and-functions.ipynb --output executed_control.ipynb
 ```
 
 ## Python .venv alternative
@@ -47,5 +47,5 @@ jupyter notebook
 
 ## Notes
 - Python 3.10–3.12 is supported.
-- If you add packages, update both `environment.yml` and `requirements.txt`.
+- If you add packages, update both `config/environment.yml` and `requirements.txt`.
 - The notebooks include small plots, data structures, control flow, and file I/O examples.

README.md

@@ -15,9 +15,11 @@
 
 ## Getting Started with Python
 
-### Fundamentals  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/fundamentals/fundamentals.ipynb"><img alt="Open in Colab — Fundamentals" src="https://colab.research.google.com/assets/colab-badge.svg"></a></p>
+### Fundamentals  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/workshops/fundamentals/fundamentals.ipynb"><img alt="Open in Colab — Fundamentals" src="https://colab.research.google.com/assets/colab-badge.svg"></a></p>
 
-### Loops and Functions <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/loops-and-functions/loops-and-functions.ipynb"><img alt="Open in Colab — Loops and Functions" src="https://colab.research.google.com/assets/colab-badge.svg"></a></p>
+### Loops and Functions <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/workshops/loops-and-functions/loops-and-functions.ipynb"><img alt="Open in Colab — Loops and Functions" src="https://colab.research.google.com/assets/colab-badge.svg"></a></p>
+
+### Exploratory Data Analysis <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/workshops/exploratory-data-analysis/exploratory-data-analysis.ipynb"><img alt="Open in Colab — Exploratory Data Analysis" src="https://colab.research.google.com/assets/colab-badge.svg"></a></p>
 
 These materials are used in NC State University Libraries' Data Science Services workshops covering practical data skills (Python, R, visualization, and analysis).
 
@@ -34,14 +36,18 @@ These materials are used in NC State University Libraries' Data Science Services
 
 - 🧱 Fundamentals — variables, types, lists, dicts, and more.
 - 🔁 Loops and Functions — conditionals, loops, functions, and scope.
+- 🔎 Exploratory Data Analysis (Polars) — data loading, summaries, and plots.
 
 ## 🧩 Solutions
 
 - Fundamentals — Solutions
-  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/fundamentals/fundamentals-solutions.ipynb"><img alt="Open in Colab — Solutions: Fundamentals" src="https://colab.research.google.com/assets/colab-badge.svg"></a>
+  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/workshops/fundamentals/fundamentals-solutions.ipynb"><img alt="Open in Colab — Solutions: Fundamentals" src="https://colab.research.google.com/assets/colab-badge.svg"></a>
 
 - Loops and Functions — Solutions
-  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/loops-and-functions/loops-and-functions-solutions.ipynb"><img alt="Open in Colab — Solutions: Loops and Functions" src="https://colab.research.google.com/assets/colab-badge.svg"></a>
+  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/workshops/loops-and-functions/loops-and-functions-solutions.ipynb"><img alt="Open in Colab — Solutions: Loops and Functions" src="https://colab.research.google.com/assets/colab-badge.svg"></a>
+
+- Exploratory Data Analysis — Solutions
+  <a href="https://colab.research.google.com/github/NCSU-Libraries/getting-started-with-python/blob/main/workshops/exploratory-data-analysis/exploratory-data-analysis-solutions.ipynb"><img alt="Open in Colab — Solutions: Exploratory Data Analysis" src="https://colab.research.google.com/assets/colab-badge.svg"></a>
 
 ## 💻 Use on Google Colab
 

compose.yaml

@@ -9,6 +9,6 @@ services:
       - "4000:4000"
     volumes:
       - .:/project
-    command: bash -lc "quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"
+    command: bash -lc "cd config && quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"
     environment:
       - QUARTO_LOG_LEVEL=debug

_quarto.yml config/_quarto.yml_quarto.yml renamed to config/_quarto.yml

@@ -2,7 +2,7 @@
 title: "Getting Started with Python"
 format:
   revealjs:
-    logo: ../assets/lib_logo_whiteBG.png
+    logo: ../../assets/lib_logo_whiteBG.png
 ---
 
 ## Welcome to the course materials for *Getting Started with Python*
@@ -17,5 +17,6 @@ format:
 
 ## Slide decks
 
-- [Fundamentals](./fundamentals/)
-- [Loops and Functions](./loops-and-functions/)
+- [Fundamentals](fundamentals/)
+- [Loops and Functions](loops-and-functions/)
+- [Exploratory Data Analysis](exploratory-data-analysis/)