Skip to content

Docker Container 1: Anomaly Detection via Simple Methods

License

Notifications You must be signed in to change notification settings

guskun8/01-ad-simple

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

title author
AI in the Industry Tutorials (Density Estimation for Simple Methods)
michele.lombardi2@unibo.it

Anomaly Detection via Simple Methods

This is the first lecture of the 2021/2022 edition of the "AI in the Industry" course, from University of Bologna. Each lecture consists of a tutorial that tackles a simplified industrial problem and tackles it using AI techniques, from Machine Learning to Combinatorial Optimization (and later on their combination).

While the whole course looks like cookbook, the real goal is using examples to teach how industrial problem can be methodically approaches, analyzed, and tackles using a combination of techniques.

This tutorial in particular tackles a simple anomaly detection task via density estimation techniques. The focus is on building an end-to-end solution, where calibrating the detection threshold can be as important as building the density estimation model itself. Being the first lecture, it also contains specific details about the course and the student evaluation methods.

Accessing the Lecture

Local Execution (Preferred)

Students are strongly encouraged to run all lectures locally. Doing this will require to:

git clone https://github.com/a3i-2022-2023/01-ad-simple
  • Start the container via Docker Compose, from the main directory of the tutorial:
docker-compose up

On linux systems, you may need to start the docker service first.

No matter which OS your are running, the first execution of this process will be fairly long, since Docker will need to download a base image for the container (think of a virtual machine disk) and then some boilerplate configuration steps will need to be performed (e.g. installing jupyter in the container). Subsequent runs will be much faster.

The process will end with a message such as this one:

To access the notebook, open this file in a browser:
    file:///home/lompa/.local/share/jupyter/runtime/nbserver-1-open.html
Or copy and paste this URL:
    http://127.0.0.1:39281/?token=0cd92163797c3b3abe67c2b0aea57939867477d6068708a2

Copying one of the two addresses in a file browser will provide access to the Jupyter server running in the spawned container. By default, the main lecture folders is shared with the container environment, so any modification you make in the contain will reflect in the host system, and the other way round.

Once you are done, pressing CTRL+C on the terminal will close the Docker container.

For more information about how Docker works (such as the difference between images and containers, or how to get rid of all of them once you are done with the tutorial), you can check the Docker documentation.

Read-only Access and PDF Notes

You can inspect the individual notebooks in by just clicking on any *.ipynb file in the notebooks directory: github provides a notebook viewer that mostly works, though this access method may occasionally have issue when displaying plots.

The repository contains PDF notes for all the notebooks. They can be used for read-only access (with more consistent results compared to the github notebook viewer), but more importantly they can be useful to add annotations. Just keep in mind that in case of updates, cloning the repository will replace the PDF files.

About

Docker Container 1: Anomaly Detection via Simple Methods

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Jupyter Notebook 97.3%
  • HTML 1.6%
  • Other 1.1%