data-mining-course

An undergraduate course on data mining.

This project is maintained by chatox

Rules for course at UPF (2025)

1. Grades

Continuous evaluation will be based in the following elements:

Your grade will be computed as:

To pass the course under continuous evaluation, all of the following must be true:

If one of the conditions above fails:

1.1. Getting a grade in the practical sessions (PSxx, individual)

To obtain a grade in the practical session, you must:

Extra points might be added to your grade, allowing you to have up to 12 points (instead of 10) in some practice sessions, however your total practice grade is capped at 10 points.

Not delivering your work means a zero grade in that session.

:unamused: Do not work alone and isolated during the practice session. You can prevent simple mistakes by talking to someone else. You can work in pairs, but each one should submit their own work individually and the deliverables must be different.

:rage: Do not work in groups of three or more during the practice session. Feel free to exchange ideas with other students, but do not copy from others.

:heavy_check_mark: It is OK to use generative AI for:

:warning: It is absolutely not OK to feed the practice questions to an AI-enabled assistant for it to do the practice for you, or to generate text responses using an AI-enabled assistant.

:warning: Copying the work from other person/group in your class, are considered by the university as serious misconduct (“falta grave”). The instructor will make a case for the university to sanction this serious misconduct, as per the university regulations, with a suspension from the university for a minimum of six months and a maximum of four years.

1.2. Getting a grade in the exam

Midterm exams and final exams are individual work.

Not coming to an exam means a zero grade in that test, unless you can justify your absence to the professor (profesor de teoría).

:warning: Copying during an exam, knowingly facilitating the copy of others, elaborating, lending, or facilitating instruments for copying during an exam, are considered by the university as serious misconduct (“falta grave”). The instructor will make a case for the university to sanction this serious misconduct, as per the university regulations, with a suspension from the university for a minimum of six months and a maximum of four years.

2. Guidelines for submitting your work

2.1. Exams

The exam will usually be with pen and paper.

2.2. Practices

Your code is delivered as a self-contained Python notebook. This notebook should be readable and understandable on its own by a person familiar with the course’s topic. Think of the notebook as a report in which you tell a story, and tell that story well and professionally.

Remember to identify the authorship and date of your code, and the generative AI model you used to assist you, if any. Include as many markdown cells between code cells as needed to explain what you are doing and what we are looking at.

Follow good programming practices:

These are some of the most common mistakes in code, these deduct points from your grade:

  1. Delivering code that does not execute from beginning to end; to prevent this, make sure that Kernel > Restart and run all works in your notebook, because that is how practice instructors review your code
  2. Delivering code that runs on an online platform (such as Google Colab) but that does not run when executed as a local notebook, because that is how practice instructors run your code
  3. Not including comments explaining how your code works; these are important for practice instructors to properly review your code
  4. Including unnecessary code that is not actually used, except if you used that code to understand the data
  5. Leaving cells that you were asked to remove when delivering
  6. Removing cells that you were not asked to remove; in particular, questions and requests (usually in blue) are used by the instructors to guide their reviewing, do not remove them
  7. Including code that does the same thing twice or more (use functions)
  8. Giving cryptic names to your variables or functions
  9. Using an inconsistent coding style
  10. Using code cells to write text intended to be read, instead, use markdown cells for that; the only text you should have in code cells are brief commentaries to understand a piece of code
  11. Including plots without a scale or without a label

2.3. Personal project

See personal project

These are some of the most common mistakes in reports, these deduct points from your grade:

  1. Failing to include your name in the first page
  2. Exceeding the number of pages
  3. Having the required number of pages but with text that has no substance and is just filling up space
  4. Including screenshots, instead of exporting the images
  5. Including screenshots of tables, instead of writing the table in the document
  6. Copy-pasting tables formatted in ASCII
  7. Delivering in the wrong format such as .docx
  8. Delivering a report that is not understandable or does not look professional at all

We expect nothing less than top-quality work

Delivering consistently top-quality work takes time and effort, but it can be very rewarding both personally and professionally :sunglasses:

Check your answers, your code, and your reports as many times as needed to ensure they are correct. Be particularly careful when incorporating snippets of code generated by AI.

Be precise: use the section numbers (1.1, 1.2, …) of the notebook to present your results, and refer to sections by their number. If you need to refer to your figures or tables, number them and refer to them by numbers. Do not include ambiguous statements or plots without a scale or a legend. Do not use colors if you do not explain what each color means. State clearly your assumptions and limitations.

Be careful with the presentation of your work. For instance, do not use low-quality screenshots, poorly cropped screenshots showing toolbars and window borders. Instead, export and save high-quality images from each application. Do not copy-paste or screenshot tables into a report without making them actual tables.

As a data scientist your reports and code should be (among other things) correct, understandable, pristine, clear, and pleasant to look at. Ensure you set aside enough time to review, improve, and polish your work. Get used to produce top-quality work and it will become a habit.

3. Asking questions

If you need help installing software or packages in your computer, please ask your classmates, for instance through the Aula Global’s forum. Teaching staff does not have the bandwidth to debug your installation.

To ask for an appointment, send an e-mail to the course’s professor. No appointments will be given in the 72 hours before midterm or final exams.