a3-MeganDsouza-DarlinaPhan-NandiniBasavaraj-AdamMarkenson

.env

@@ -1,12 +1,14 @@
 VITE_BASE_PATH="/study/"
 VITE_FIREBASE_CONFIG='
 {
-  apiKey: "AIzaSyAm9QtUgx1lYPDeE0vKLN-lK17WfUGVkLo",
-  authDomain: "revisit-utah.firebaseapp.com",
-  projectId: "revisit-utah",
-  storageBucket: "revisit-utah.appspot.com",
-  messagingSenderId: "811568460432",
-  appId: "1:811568460432:web:995f6b4f1fc8042b5dde15"
+  apiKey: "AIzaSyDnDMdTOuZjEP9rADW66GFFZttHD3jAwlo",
+  authDomain: "wpi-datavis-2025.firebaseapp.com",
+  projectId: "wpi-datavis-2025",
+  storageBucket: "wpi-datavis-2025.firebasestorage.app",
+  messagingSenderId: "671149596953",
+  appId: "1:671149596953:web:d6a0dcca66648e4cd02588"
 }
 '
-VITE_STORAGE_ENGINE="firebase" # "firebase" or "localStorage" or your own custom storage engine
+VITE_RECAPTCHAV3TOKEN="6LeLH9MqAAAAANZiz-dFmDWFHYFW_7R3mD1vZMMG"
+
+VITE_STORAGE_ENGINE="localStorage" # "firebase" or "localStorage" or your own custom storage engine

.github/workflows/deploy.yaml → .github/workflows/deploy_website.yaml

@@ -21,20 +21,20 @@ jobs:
           cache: 'yarn'
 
       - run: yarn install --immutable
-      - run: yarn build
+
+      - name: Build with .env file
+        if: ${{ vars.VITE_STORAGE_ENGINE == '' }}
+        run: yarn build
+
+      - name: Build with github environment variables
+        if: ${{ vars.VITE_STORAGE_ENGINE != '' }}
+        run: VITE_STORAGE_ENGINE=$VITE_STORAGE_ENGINE yarn build
+        env:
+          VITE_STORAGE_ENGINE: ${{ vars.VITE_STORAGE_ENGINE }}
 
       - uses: peaceiris/actions-gh-pages@v3
         name: Deploy
-        id: deploy
         if: ${{ github.ref == 'refs/heads/main' }}
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./dist
-
-      - uses: peter-evans/repository-dispatch@v2
-        name: Build documentation in revisit.dev
-        if: ${{ steps.deploy.outcome == 'success' }}
-        with:
-          token: ${{ secrets.PAT }}
-          repository: revisit-studies/reVISit-studies.github.io
-          event-type: study_repo_publish

.github/workflows/playwright.yml

@@ -3,6 +3,7 @@ name: Playwright Tests
 on:
   pull_request:
     branches:
+      - dev
       - main
 
 jobs:
@@ -23,7 +24,7 @@ jobs:
             cache_dir: ~/.cache/ms-playwright
 
           - project: webkit
-            os: macos-latest
+            os: macos-14
             cache_dir: ~/Library/Caches/ms-playwright
     steps:
       - uses: actions/checkout@v3
@@ -55,7 +56,7 @@ jobs:
 
       - name: Upload test results
         if: failure()
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: playwright-report
           path: playwright-report

.github/workflows/release.yaml

@@ -0,0 +1,53 @@
+name: Release new version
+
+on:
+  pull_request:
+    branches: [main]
+    types: [closed]
+
+jobs:
+  release:
+    if: github.event.pull_request.merged
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.PAT }}
+
+      - name: Run make-release.sh to modify version numbers across the repo
+        run: |
+          find src public -type f -exec env LANG=C sed -i -E "s/githubusercontent\.com\/re[Vv][Ii][Ss]it-studies\/study\/.*\/src/githubusercontent.com\/revisit-studies\/study\/${{ github.event.pull_request.title }}\/src/g" {} +
+          find src public -type f -exec env LANG=C sed -i -E "s/github.com\/re[Vv][Ii][Ss]it-studies\/study\/tree\/v[^\/]*\/([^\s]*)/github.com\/revisit-studies\/study\/tree\/${{ github.event.pull_request.title }}\/\1/g" {} +
+
+      - name: Commit changes
+        run: |
+          git config --local user.email "jackwilburn@tutanota.com"
+          git config --local user.name "Jack Wilburn"
+          git add .
+          git commit -m "Release version ${{ github.event.pull_request.title }}"
+          git tag -a ${{ github.event.pull_request.title }} -m "Release version ${{ github.event.pull_request.title }}"
+          git push --follow-tags
+
+      - uses: peter-evans/repository-dispatch@v2
+        name: Build documentation in revisit.dev if repo is in revisit-studies
+        if: ${{ github.repository_owner == 'revisit-studies' }}
+        with:
+          token: ${{ secrets.PAT }}
+          repository: revisit-studies/reVISit-studies.github.io
+          event-type: study_repo_publish
+
+      - uses: peter-evans/repository-dispatch@v2
+        name: Build documentation in revisit.dev if repo is in revisit-studies
+        if: ${{ github.repository_owner == 'revisit-studies' }}
+        with:
+          token: ${{ secrets.PAT }}
+          repository: revisit-studies/revisitpy
+          event-type: study_repo_publish
+
+      - uses: peter-evans/repository-dispatch@v2
+        name: Build documentation in revisit.dev if repo is in revisit-studies
+        if: ${{ github.repository_owner == 'revisit-studies' }}
+        with:
+          token: ${{ secrets.PAT }}
+          repository: revisit-studies/revisitpy-server
+          event-type: study_repo_publish

.github/workflows/release_github.yaml

@@ -0,0 +1,24 @@
+name: Create release
+
+on:
+  push:
+    tags:
+      - v*
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release pushed tag
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Create release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          tag: ${{ github.ref_name }}
+        run: |
+          gh release create "$tag" \
+              --repo="$GITHUB_REPOSITORY" \
+              --title="${tag}" \
+              --generate-notes

.gitignore

@@ -29,3 +29,7 @@ dist-ssr
 /playwright/.cache/
 
 docs/
+docsLibraries/
+
+public/__revisit-widget
+src/public/__revisit-widget

CLASSREADME.md

@@ -0,0 +1,44 @@
+# Assignment 3 - Replicating a Classic Experiment  
+
+In this assignment, we conducted a controlled experiment about the accuracy of people gauging different kinds of data visualizations. d3 was used to make the visualizations and ReVISit was used to conduct the experiment. After we collected data, we did some data-analysis. 
+
+<img src="study-1.png" alt="">
+<img src="study-2.png" alt="">
+
+## Visualizations
+
+Results: <img src="bootstrapped_CIs.png" alt="">
+<img src="image.png" alt="">
+
+We chose 3 visualizations and from best to worst, they were
+
+Bar
+
+<img src="bar.png" alt="">
+The average Cleveland and McGill error rate for our bar chart was 1.53, which was the lowest error rate produced overall. Looking at the bootstrapped confidence interval, most of the points are clustered towards the bottom, meaning that most participants were not too far off from the actual value. The points tended to be spread around the mean error which leaned towards the bottom. This error rate was very close to the one that Cleveland and McGill obtained from their study but ours was slightly higher.
+
+---
+Bubble
+
+<img src="bubble.png" alt="">
+The average Cleveland and McGill error rate for our bubble chart was 2.403, which was also very close to the error rate of our pie chart. Looking at the bootstrapped confidence interval, the points seem to be more spread out with some points having very low error rates, some having error rates close to the mean, and some having high error rates. Since the confidence intervals for the bubble and pie charts overlap, the differnce in their errors are not statistically significant. The error rate we obtained is slightly lower than the one Cleveland and McGill obtained from their study for a bubble chart.
+
+---
+Pie
+
+<img src="pie.png" alt="">
+
+The average Cleveland and McGill error rate for our pie chart was 2.456, which was the highest error rate produced overall. Looking at the bootstrapped confidence interval, the points seem similair to the CI for our bubble chart except they are slightly more spread out and have more points concentrated towards the top.This visualization had the lowest accuracy and had a lot of variation among participants. The error rate we obtained is slightly lower than the one Cleveland and McGill obtained from their study for a bubble chart.
+---
+
+
+### Technical Achievement
+
+One of our technical achievements was learning how to set and use ReVISit, a library to make web-based studies. While there wasn't a significant amount of setup, there was a lot of debugging since we were all unfamiliar with the application. Once we figured out how to at least locally host the experiment, we also ran into issues with how to apply the randomness as full randomness of the order, types of charts, percent differences, etc. would require a significant amount of work. Instead, we settled on a set order for the percent differences and type of visualization for ease of data analysis but randomized what it looked like each time. We aditionally used Excel to obtain our error rates and R to obtain our bootstrapped confidence intervals. We used the log function in Excel and learned to to create bootstraped confidence intervals in R.
+
+### Design Achievement
+
+We decided to branch out and instead of doing both a bar chart and a stacked bar chart, which would have been very similar, decided to do a pie and bubble chart. While both are circular, their d3 development was quite different. A struggle that occured with the pie chart was making the dots that marked the pieces actually show up in the center of each slice. With the bubble charts, it would sometimes generate too many circles and make the visualization look messy, possibly skewing the data. However, the design choices to use these data visualization types gives us a more interesting data analysis. We aditionally designed our confidence intervals in one graph to make it easier to compare. We made the mean interval a seperate color as well so that it is easy to distinguish from the rest of the points.
+
+#### Note
+The survey is supposed to be hosted [here](https://dar-th0va-dar.github.io/a3-revisit/) but we couldn't figure out why it wasn't working in time