Skip to content

Latest commit

 

History

History
64 lines (33 loc) · 6.48 KB

README.md

File metadata and controls

64 lines (33 loc) · 6.48 KB

GitHub license

Notebooks Labsession Image

This repo is a set of Notebooks for the lab session of 2022-2023 in the context of module "Automatique et Traitement du signal et des images" in SICOM equivalent M1 first semester program in PHELMA and ENSE3 engineering schools. These notebooks are not the solutions of the lab sessions. They are a set of code examples to process data.

These code examples are meant to be used and adapted for SICOM internships / future lab session in Image processing and other fields. The students are highly encouraged to follow / to question these code examples as soon as possible, namely for their future lab sessions. These notebooks aim to give good code practice and are used to illustrate some explanation during the Lab sessions. The grading of lab sessions are not based on the following of these code recommendations.

How to use

  • Google Collab: Each notebook has a collab link that can be clicked on (see below). The code runs on Google Server for free, without installation. All you need is a google account to log on their platform.
  • Local: You can also clone the repo on your local computer. Just install the local NLI package and it will install the depencies. You will need a local Jupyter server (installed with conda for example) and a code editor (Jupyter Lab, Visual Studio Code). Do not run the first cells of notebooks in local, they are meant to be used on google collab.

Quick Notebooks' descriptions

These notebooks are based on the Kaggle Pokemon Dataset. Credits go to the original owners.

A quick introduction to ndarray

Open In Collab

This short notebook aims to introduce ndarray. The core elements needed for the lab sessions and other notebooks are presented here.

Image processing

Open In Collab

The notebook is about the processing of images with scikit-image. The images are treated as numpy ndarray.

Path management

Open In Collab

Managing the path in Python is a pain. The pathlib is a built-in python library that does the work for you. This is easy to use and OS independent. This short notebooks show up basic operations to save a lot of times for the rest of your Python journey.

Pythonic comprehension

Open In Collab

List and dictionary comprehensions are often seen in Python code, there are representative of clean and efficient code. This notebooks present them.

CSV processing with Pandas

Open In Collab Open In Collab Open In Collab

.csv files are commonly used to process dataset. A lot of data might be represent from few features. Pandas is a package that implements a lot of easy ways to represent and to "get-to-know" the data. This package is widely used among data analysts.

How to contribute

This repo is an invitation for students to participate in the notebooks development. The issues and the pull requests might be used to enhance the quality of the code examples or ask questions about it. Solutions or corrections of the lab sessions are stricly forbidden in the repo! If you have a problem related to the notebooks, you must provide minimal working examples to reproduce this error with a non-related lab session code.

What is NLI ?

This package has few functions that are useful for the notebooks' explanations. Actually, these functions could have been defined in notebooks. This NLI python package is made to show how to make package in python. Also there are the python files pyproject.toml, setup.cfg, setup.py so the package can be installed with pip. It can be installed directly from this repo with the line pip install git+https://github.com/AwePhD/NotebooksLabsessionImage.git.

External ressources

There are many references of the Python DataScience Handbook in the notebooks.This is a great reference book for newcomer in data science in Python. It gives all the handy features of the most wildly used library. Plus the content of the book is composed by notebooks, only!

PDSH-cover

Credits

Mathias Réus - PhD Student, Gipsa-Lab