This template project provides some structure for your open data project in the MADE module at FAU. This repository contains (a) a data science project that is developed by the student over the course of the semester, and (b) the exercises that are submitted over the course of the semester. Before you begin, make sure you have Python and Jayvee installed. We will work with Jupyter notebooks. The easiest way to do so is to set up VSCode with the Jupyter extension.
Your data engineering project will run alongside lectures during the semester. We will ask you to regularly submit project work as milestones so you can reasonably pace your work. All project work submissions must be placed in the project folder.
Jupyter Notebooks can be exported using nbconvert (pip install nbconvert). For example, to export the example notebook to html: jupyter nbconvert --to html examples/final-report-example.ipynb --embed-images --output final-report.html
During the semester you will need to complete exercises, sometimes using Python, sometimes using Jayvee. You must place your submission in the exercises folder in your repository and name them according to their number from one to five: exercise<number from 1-5>.<jv or py>.
In regular intervalls, exercises will be given as homework to complete during the semester. We will divide you into two groups, one completing an exercise in Jayvee, the other in Python, switching each exercise. Details and deadlines will be discussed in the lecture, also see the course schedule. At the end of the semester, you will therefore have the following files in your repository:
./exercises/exercise1.jvor./exercises/exercise1.py./exercises/exercise2.jvor./exercises/exercise2.py./exercises/exercise3.jvor./exercises/exercise3.py./exercises/exercise4.jvor./exercises/exercise4.py./exercises/exercise5.jvor./exercises/exercise5.py
We provide automated exercise feedback using a GitHub action (that is defined in .github/workflows/exercise-feedback.yml).
To view your exercise feedback, navigate to Actions -> Exercise Feedback in your repository.
The exercise feedback is executed whenever you make a change in files in the exercise folder and push your local changes to the repository on GitHub. To see the feedback, open the latest GitHub Action run, open the exercise-feedback job and Exercise Feedback step. You should see command line output that contains output like this:
Found exercises/exercise1.jv, executing model...
Found output file airports.sqlite, grading...
Grading Exercise 1
Overall points 17 of 17
---
By category:
Shape: 4 of 4
Types: 13 of 13