search

LTS5 / iapr2024

2 stars 5 forks source link

readme

Image Analysis and Pattern Recognition

General information

Objective of this course

Learn the basic methods of digital image analysis and pattern recognition: pre-processing, image segmentation, shape representation and classification. These concepts will be illustrated by applications in computer vision and medical image analysis.

Objective of this repository

This repository contains the material for the labs and project associated with the EPFL master course EE-451 Image Analysis and Pattern Recognition.

Labs instructions

The lab assignments aim to impart practical implementation skills related to the topics covered in class and serve as preparation for the final project. The final project is a hands-on endeavor that consolidates the concepts covered throughout the course. The labs themselves are in the form of Jupyter Notebooks, and need to be solved in groups of three students. Please make your groups on Moodle before March 8th.

It is important to note that the labs will be graded. For each lab, each group is required to submit one Jupyter notebook on Moodle, following the naming convention lab_x_SCIPER1_SCIPER2_SCIPER3.ipynb, where 'x' indicates the lab number, and SCIPER1, SCIPER2, and SCIPER3 denote the SCIPER of each group member.

To ensure uniformity and minimize code conflicts, we strongly advise following the provided Installation Instructions below.

Important Note: Before submitting each notebook, please execute the command Kernel > Restart & Run All to run the entire notebook from scratch. This ensures that the code runs correctly. We will re-run each notebook during evaluation to verify the correctness of your code.

Installation instructions

Python and packages

We will be using git, Python, and packages from the Python scientific stack. If you don't know how to install these on your platform, we recommend to install Anaconda or Miniconda, both are distributions of the conda package and environment manager. Please follow the below instructions to install it and create an environment for the course:

  1. Download the latest Python 3.x installer for Windows, macOS, or Linux from https://www.anaconda.com/download or https://conda.io/miniconda.html and install with default settings. Skip this step if you have conda already installed (from Miniconda or Anaconda). Linux users may prefer to use their package manager.
    • Windows: Double-click on the .exe file.
    • macOS: Double-click on the .pkg file.
    • Linux: Run bash Anaconda3-latest-Linux-x86_64.sh in your terminal.
  2. Open a terminal. For Windows: open the Anaconda Prompt from the Start menu.
  3. It is recommended to create an environment dedicated to this course with conda create -n iapr python=3.9.18.
  4. Activate the environment:
    • Linux/macOS: conda activate iapr.
    • Windows: activate iapr.
  5. Install the packages we will be using for this course:
    • conda install notebook
  6. You can deactivate the environment whenever you are done with deactivate
  7. Install git if not already installed with conda install git.
  8. Follow git instructions in the Github section below.

Github

Git serves as a valuable tool for collaborative teamwork. To seamlessly access the upcoming labs and projects we'll be releasing throughout the semester, and to facilitate collaboration using Git, we highly recommend following these steps:

  1. Initiate the process by creating a private empty repository for your group, <my_group_repo>, on Github. Ensure that it does not include README.md and .gitignore.
  2. Clone your group remote repository locally using the command: git clone https://github.com/<my_group_repo>.
  3. Establish the course repository, iapr, as a remote repository by executing the command: git remote add upstream https://github.com/LTS5/iapr2024.git (or use the SSH variant if preferred).
  4. Stay up-to-date by fetching and merging changes from the iapr repository into your local branch with: git pull upstream main.
  5. Once you've collected the code, push it to your remote repository: git push origin main.

Throughout the semester, we will periodically update the iapr repository with new labs and the project. To sync with the latest data, execute git pull upstream main. Exercise caution for potential conflicts; it's advisable to rename your Juypter Notebooks to lab_x_SCIPER1_SCIPER2_SCIPER3.ipynb (See Lab instructions) to prevent accidental overwriting of your code during merges.

Python editors

Jupyter is a very useful editor that run directly in a web browser. You can have Python and Markdown cells, hence it is very useful for examples, tutorials and labs. We encourage to use it for the lab assignments. To launch a Jupyter Notebook: