From: Martin Pitt <martin@piware.de>
Date: Fri, 28 Aug 2020 05:37:04 +0000 (+0200)
Subject: README.md: First steps and resources
X-Git-Url: https://piware.de/gitweb/?a=commitdiff_plain;h=729ae7ea896340b69a4021e0201b9d1c8d29ee89;p=handwriting-recognition.git

README.md: First steps and resources
---

729ae7ea896340b69a4021e0201b9d1c8d29ee89
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ad14945
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# Resources
+
+Basics:
+ - [Learn numpy](https://numpy.org/learn/)
+ - [MNIST database of handwritten digits](http://yann.lecun.com/exdb/mnist/)
+ - [Neuron](https://en.wikipedia.org/wiki/Artificial_neuron)
+ - [Perceptron](https://en.wikipedia.org/wiki/Perceptron)
+ - [3Blue1Brown video series](https://www.youtube.com/playlist?list=PLZHQObOWTQDNU6R1_67000Dx_ZCJB-3pi)
+
+Too high-level for first-time learning, but apparently very abstract and powerful for real-life:
+ - [keras](https://keras.io/)
+ - [tutorial how to recognize handwriting with keras/tensorflow](https://data-flair.training/blogs/python-deep-learning-project-handwritten-digit-recognition/)
+
+# Dependencies
+
+    sudo dnf install -y python3-numpy python3-matplotlib
+
+# Steps
+
+ - Do the [NumPy quickstart tutorial](https://numpy.org/devdocs/user/quickstart.html); example:
+
+```py
+import numpy as np
+import matplotlib.pyplot as plt
+grad = np.linspace(0,1,10000).reshape(100,100)
+plt.imshow(grad, cmap='gray')
+plt.show()
+
+plt.imshow(np.sin(np.linspace(0,10000,10000)).reshape(100,100) ** 2, cmap='gray')
+# does not work with QT_QPA_PLATFORM=wayland
+plt.show(block=False)
+plt.close()
+```
+
+ - Get the handwritten digits training data with `./download-mnist.sh`
diff --git a/screenshots/numpy-linspace.png b/screenshots/numpy-linspace.png
new file mode 100644
index 0000000..85e3a9d
Binary files /dev/null and b/screenshots/numpy-linspace.png differ
diff --git a/screenshots/numpy-sinpattern.png b/screenshots/numpy-sinpattern.png
new file mode 100644
index 0000000..cf5aca1
Binary files /dev/null and b/screenshots/numpy-sinpattern.png differ