leriomaggio / deep-learning-keras-tensorflow

Introduction to Deep Neural Networks with Keras and Tensorflow
MIT License
2.94k stars 1.27k forks source link
anaconda cudnn deep-learning keras keras-tensorflow keras-tutorials python tensorflow theano tutorial

Deep Learning with Keras and Tensorflow


### Author: Valerio Maggio #### Contacts:
@leriomaggio valeriomaggio valeriomaggio_at_gmail
```shell git clone https://github.com/leriomaggio/deep-learning-keras-tensorflow.git ``` --- ## Table of Contents - **Part I**: **Introduction** - Intro to Artificial Neural Networks - Perceptron and MLP - naive pure-Python implementation - fast forward, sgd, backprop - Introduction to Deep Learning Frameworks - Intro to Theano - Intro to Tensorflow - Intro to Keras - Overview and main features - Overview of the `core` layers - Multi-Layer Perceptron and Fully Connected - Examples with `keras.models.Sequential` and `Dense` - Keras Backend - **Part II**: **Supervised Learning** - Fully Connected Networks and Embeddings - Intro to MNIST Dataset - Hidden Leayer Representation and Embeddings - Convolutional Neural Networks - meaning of convolutional filters - examples from ImageNet - Visualising ConvNets - Advanced CNN - Dropout - MaxPooling - Batch Normalisation - HandsOn: MNIST Dataset - FC and MNIST - CNN and MNIST - Deep Convolutional Neural Networks with Keras (ref: `keras.applications`) - VGG16 - VGG19 - ResNet50 - Transfer Learning and FineTuning - Hyperparameters Optimisation - **Part III**: **Unsupervised Learning** - AutoEncoders and Embeddings - AutoEncoders and MNIST - word2vec and doc2vec (gensim) with `keras.datasets` - word2vec and CNN - **Part IV**: **Recurrent Neural Networks** - Recurrent Neural Network in Keras - `SimpleRNN`, `LSTM`, `GRU` - LSTM for Sentence Generation - **PartV**: **Additional Materials**: - Custom Layers in Keras - Multi modal Network Topologies with Keras --- # Requirements This tutorial requires the following packages: - Python version 3.5 - Python 3.4 should be fine as well - likely Python 2.7 would be also fine, but *who knows*? :P - `numpy` version 1.10 or later: http://www.numpy.org/ - `scipy` version 0.16 or later: http://www.scipy.org/ - `matplotlib` version 1.4 or later: http://matplotlib.org/ - `pandas` version 0.16 or later: http://pandas.pydata.org - `scikit-learn` version 0.15 or later: http://scikit-learn.org - `keras` version 2.0 or later: http://keras.io - `tensorflow` version 1.0 or later: https://www.tensorflow.org - `ipython`/`jupyter` version 4.0 or later, with notebook support (Optional but recommended): - `pyyaml` - `hdf5` and `h5py` (required if you use model saving/loading functions in keras) - **NVIDIA cuDNN** if you have NVIDIA GPUs on your machines. [https://developer.nvidia.com/rdp/cudnn-download]() The easiest way to get (most) these is to use an all-in-one installer such as [Anaconda](http://www.continuum.io/downloads) from Continuum. These are available for multiple architectures. --- ### Python Version I'm currently running this tutorial with **Python 3** on **Anaconda** ```python !python --version ``` Python 3.5.2 --- ## Setting the Environment In this repository, files to re-create virtual env with `conda` are provided for Linux and OSX systems, namely `deep-learning.yml` and `deep-learning-osx.yml`, respectively. To re-create the virtual environments (on Linux, for example): ```shell conda env create -f deep-learning.yml ``` For OSX, just change the filename, accordingly. ### Notes about Installing Theano with GPU support **NOTE**: Read this section **only** if after _pip installing_ `theano`, it raises error in enabling the GPU support! Since version `0.9` Theano introduced the [`libgpuarray`](http://deeplearning.net/software/libgpuarray) in the stable release (it was previously only available in the _development_ version). The goal of `libgpuarray` is (_from the documentation_) make a common GPU ndarray (n dimensions array) that can be reused by all projects that is as future proof as possible, while keeping it easy to use for simple need/quick test. Here are some useful tips (hopefully) I came up with to properly install and configure `theano` on (Ubuntu) Linux with **GPU** support: 1) [If you're using Anaconda] `conda install theano pygpu` should be just fine! Sometimes it is suggested to install `pygpu` using the `conda-forge` channel: `conda install -c conda-forge pygpu` 2) [Works with both Anaconda Python or Official CPython] * Install `libgpuarray` from source: [Step-by-step install libgpuarray user library](http://deeplearning.net/software/libgpuarray/installation.html#step-by-step-install-user-library) * Then, install `pygpu` from source: (in the same source folder) `python setup.py build && python setup.py install` * `pip install theano`. After **Theano is installed**: ``` echo "[global] device = cuda floatX = float32 [lib] cnmem = 1.0" > ~/.theanorc ``` ### Installing Tensorflow To date `tensorflow` comes in two different packages, namely `tensorflow` and `tensorflow-gpu`, whether you want to install the framework with CPU-only or GPU support, respectively. For this reason, `tensorflow` has **not** been included in the conda envs and has to be installed separately. #### Tensorflow for CPU only: ```shell pip install tensorflow ``` #### Tensorflow with GPU support: ```shell pip install tensorflow-gpu ``` **Note**: NVIDIA Drivers and CuDNN **must** be installed and configured before hand. Please refer to the official [Tensorflow documentation](https://www.tensorflow.org/install/) for further details. #### Important Note: All the code provided+ in this tutorial can run even if `tensorflow` is **not** installed, and so using `theano` as the (default) backend! ___**This** is exactly the power of Keras!___ Therefore, installing `tensorflow` is **not** stricly required! +: Apart from the **1.2 Introduction to Tensorflow** tutorial, of course. ### Configure Keras with tensorflow By default, Keras is configured with `theano` as backend. If you want to use `tensorflow` instead, these are the simple steps to follow: 1) Create the `keras.json` (if it does not exist): ```shell touch $HOME/.keras/keras.json ``` 2) Copy the following content into the file: ``` { "epsilon": 1e-07, "backend": "tensorflow", "floatx": "float32", "image_data_format": "channels_last" } ``` 3) Verify it is properly configured: ```python !cat ~/.keras/keras.json ``` { "epsilon": 1e-07, "backend": "tensorflow", "floatx": "float32", "image_data_format": "channels_last" } --- # Test if everything is up&running ## 1. Check import ```python import numpy as np import scipy as sp import pandas as pd import matplotlib.pyplot as plt import sklearn ``` ```python import keras ``` Using TensorFlow backend. ## 2. Check installed Versions ```python import numpy print('numpy:', numpy.__version__) import scipy print('scipy:', scipy.__version__) import matplotlib print('matplotlib:', matplotlib.__version__) import IPython print('iPython:', IPython.__version__) import sklearn print('scikit-learn:', sklearn.__version__) ``` numpy: 1.11.1 scipy: 0.18.0 matplotlib: 1.5.2 iPython: 5.1.0 scikit-learn: 0.18 ```python import keras print('keras: ', keras.__version__) # optional import theano print('Theano: ', theano.__version__) import tensorflow as tf print('Tensorflow: ', tf.__version__) ``` keras: 2.0.2 Theano: 0.9.0 Tensorflow: 1.0.1

If everything worked till down here, you're ready to start!