Update Readme

.gitignore

@@ -0,0 +1,6 @@
+__pycache__
+.DS_Store
+*.zip
+env
+model
+.ipynb_checkpoints

README.md

@@ -5,10 +5,20 @@ Code and pretrained *Real-world* CNN model for:
 *Benedikt Lorch, Shruti Agarwal, Hany Farid. Forensic Reconstruction of Severely Degraded License Plates.
 Media Watermarking, Security, and Forensics 2019, Burlingame, CA, USA, MWSF-529.* [bibtex](http://cris.fau.de/bibtex/publication/209464175.bib)
 
+[Forensic Reconstruction of Severely Degraded License Plates - PDF](https://faui1-files.cs.fau.de/public/mmsec/license-plates/ei2019_forensic_reconstruction_of_severely_degraded_license_plates.pdf)
+
+[Can you enhance it? - Forensic Reconstruction of Severely Degraded License Plates - Slides - PDF](https://faui1-files.cs.fau.de/public/mmsec/license-plates/ei2019_forensic_reconstruction_of_severely_degraded_license_plates_slides.pdf)
+
 
 ## Getting Started
 
-Tested on Ubuntu 16.04 with Python 3.5, TensorFlow 1.4.0 and 1.10.1.
+Tested on MacOS 10.14 with Python 3.7, TensorFlow 2.1.0.
+
+
+### Requirements
+[Python 3](https://www.python.org/downloads/)
+
+[LaTeX 3](https://www.latex-project.org/get/)
 
 ### Installation
 
@@ -18,14 +28,34 @@ git clone https://github.com/btlorch/license-plates.git
 cd license-plates
 ```
 
+Setup python virtual environmennt
+```bash
+python3 -m pip install --user --upgrade pip
+python3 -m pip install --user virtualenv
+python3 -m venv env
+source env/bin/activate
+```
+
 Inside your virtual environment install required packages.
 ```bash
 pip install -r requirements.txt
 ```
 
 [Download trained model](https://faui1-files.cs.fau.de/public/mmsec/license-plates/license-plates-trained-model.zip) to `<repo>/model` or a directory of your choice.
+
+[Alternate link to trained model](https://cs.iusb.edu/~csolovey/license-plates/license-plates-trained-model.zip)
 ```bash
 wget https://faui1-files.cs.fau.de/public/mmsec/license-plates/license-plates-trained-model.zip
+```
+
+### File verification on trained model download
+```bash
+shasum -a 256 license-plates-trained-model.zip 
+	ec2fad6f73e123e181780476b6e36b34228efde475fa1e053c45bd2a17234536  license-plates-trained-model.zip
+```
+
+### Unzip trained model to model directory
+```bash
 unzip license-plates-trained-model.zip -d model
 ```
 

requirements.txt

@@ -1,14 +1,14 @@
-absl-py==0.4.1
+absl-py==0.7.0
 astor==0.7.1
 backcall==0.1.0
 bleach==2.1.4
 cloudpickle==0.5.5
 cycler==0.10.0
-dask==0.19.0
+dask==1.0.0
 decorator==4.3.0
 entrypoints==0.2.3
-gast==0.2.0
-grpcio==1.14.2
+gast==0.2.2
+grpcio==1.24.3
 h5py==2.8.0
 html5lib==1.0.1
 imageio==2.4.0
@@ -32,16 +32,15 @@ nbconvert==5.3.1
 nbformat==4.4.0
 networkx==2.1
 notebook==5.7.8
-numpy==1.14.5
+numpy==1.16.0
 pandocfilters==1.4.2
 parso==0.3.1
 pexpect==4.6.0
 pickleshare==0.7.4
 Pillow==5.2.0
-pkg-resources==0.0.0
 prometheus-client==0.3.1
 prompt-toolkit==1.0.15
-protobuf==3.6.1
+protobuf==3.8.0
 ptyprocess==0.6.0
 Pygments==2.2.0
 pyparsing==2.2.0
@@ -50,13 +49,13 @@ pytz==2018.5
 PyWavelets==1.0.0
 pyzmq==17.1.2
 qtconsole==4.4.1
-scikit-image==0.14.0
-scipy==1.1.0
+scikit-image==0.14.2
+scipy==1.4.1
 Send2Trash==1.5.0
 simplegeneric==0.8.1
-six==1.11.0
-tensorboard==1.10.0
-tensorflow==1.10.1
+six==1.12.0
+tensorboard==2.1.0
+tensorflow==2.1.0
 termcolor==1.1.0
 terminado==0.8.1
 testpath==0.3.1

src/demo.ipynb

@@ -57,7 +57,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "sess = tf.InteractiveSession()\n",
+    "sess = tf.compat.v1.InteractiveSession()\n",
     "cnn = LicensePlatesCNN(sess, checkpoint_dir, summary_dir)\n",
     "cnn.load();"
    ]

src/eval.py

@@ -9,7 +9,7 @@
 
 
 def eval(test_data, store_results_path, input_channels=3, checkpoint_dir="checkpoint", summary_dir="summary"):
-    with tf.Session() as sess:
+    with tf.compat.v1.Session() as sess:
         cnn = LicensePlatesCNN(sess=sess,
                                checkpoint_dir=checkpoint_dir,
                                summary_dir=summary_dir,