Merge branch 'master' of https://github.com/lukas/ml-class

Author: lukas

README.md

@@ -2,56 +2,23 @@
 
 These are materials I use for various classes on deep learning.  Each file is a self contained unit that demonstrates a specific thing.  Downloading or cloning this repository before class is a great way to follow along.
 
-# Reusing the materials
-
-Please feel free to use these materials for your own classes/projects etc.  If you do that, I would love it if you sent me a message and let me know what you're up to.
-
 # Videos
 
-You can find video overviews of a lot of the material at https://youtu.be/Zxrk88rA7fA.
-
-## Prerequisites
-
-These classes are intended for people who are comfortable wirth python.
-
-### Reading material for people who haven't done a lot of programming
-
-If you are uncomfortable opening up a terminal, I strongly recommend doing a quick tutorial before you take this class.  Setting up your machine can be painful but once you're setup you can get a ton out of the class.  I recommend getting started ahead of time.
-
-If you're on Windows I recommend checking out http://thepythonguru.com/.
-
-If you're on a Mac check out http://www.macworld.co.uk/how-to/mac/coding-with-python-on-mac-3635912/
+You can find short, free video classes at https://youtu.be/Zxrk88rA7fA.  The code for all of the videos is in the directory *videos*.
 
-If you're on linux, you're probably already reasonably well setup :).
+# Examples
 
-If you run into trouble, the book Learn Python the Hard Way has installation steps in great detail: https://learnpythonthehardway.org/book/ex0.html.  It also has a refresher on using a terminal in the appendix.
+In my in-person classes, I typically use a lot of the examples in the directory *examples*.  This code is liable to change as I update things.
 
-### Reading material for people who are comfortable with programming, but haven't done a lot of python
-
-If you are comfortable opening up a terminal but want a python intro/refresher check out https://www.learnpython.org/ for a really nice introduction to Python.
-
-### Suggestions for people who have done a lot of programming in python
-
-A lot of people like to follow along with ipython or jupyter notebooks and I think that's great!  It makes data exploration easier.  I also really appreciate pull requests to make the code clearer.
-
-If you've never used pandas or numpy - they are great tools and I use them heavily in my work and for this class.  I assume no knlowedge of pandas and numpy but you may want to do some learning on your own.  You can get a quick overview of pandas at http://pandas.pydata.org/pandas-docs/stable/10min.html.  There is a great overview of numpy at https://docs.scipy.org/doc/numpy/user/quickstart.html.
-
-## Installation
-I recommend running this code in a pre-configured environment.  You can rent an AWS EC2 node with any of the "Deep Learning" AMIs from aws.amazon.com or a GCP instance.
-
-Once you have a cloud machine setup run:
-
-```
-pip install -r requirements.txt
-```
+# Reusing the materials
 
-You can also install this class locally, but it may be trickier.
+Please feel free to use these materials for your own classes/projects etc.  If you do that, I would love it if you sent me a message and let me know what you're up to.
 
 ### Windows
 
 #### Git
 
-Install git: https://git-scm.com/download/win
+Install git if you don't have it: https://git-scm.com/download/win
 
 #### Anaconda
 
@@ -78,19 +45,6 @@ activate ml-class
 
 Whenever you start a new terminal, you will need to call `activate ml-class`.
 
-#### Common problems
-
-The most common problem is an old version of python.  Its easy to have multiple versions of python installed at once and Macs in particular come with a default version of python that is too old to install tensorflow.
-
-Try running:
-
-```
-python --version
-```
-
-If your version is less than 2.7.12, you have a version issue.  Try reinstalling python 2.
-
-
 #### Clone this github repository
 ```
 git clone https://github.com/lukas/ml-class.git
@@ -125,39 +79,28 @@ If you get an error message here, most likely you don't have git installed.  Go
 ```
 pip install -r requirements.txt
 ```
-## Check installation
 
-To make sure your installation works go to the directory where this file is and run
-```
-python test-scikit.py
-```
 
-You should see the output "Scikit is installed!"
+### Reading material for people who haven't done a lot of programming
 
-```
-python test-keras.py
-```
+If you are uncomfortable opening up a terminal, I strongly recommend doing a quick tutorial before you take this class.  Setting up your machine can be painful but once you're setup you can get a ton out of the class.  I recommend getting started ahead of time.
 
-You should see the output "Using TensorFlow backend.  Keras is installed!"
+If you're on Windows I recommend checking out http://thepythonguru.com/.
 
-##Troubleshooting on Ubuntu
+If you're on a Mac check out http://www.macworld.co.uk/how-to/mac/coding-with-python-on-mac-3635912/
 
-If the above 2 commands fail and you see an error "ImportError no module named".. verify if you have multiple versions of python installed, specially if you are on Ubuntu version 16 or higher.
+If you're on linux, you're probably already reasonably well setup :).
 
-Run python --version 
-	-- may be you have v2.7?
-Run python3 --version
-	-- may be you have python 3.5+?
+If you run into trouble, the book Learn Python the Hard Way has installation steps in great detail: https://learnpythonthehardway.org/book/ex0.html.  It also has a refresher on using a terminal in the appendix.
 
-If you have python3 installed, verify your ml-class installation by running below commands
-python3 test-scikit.py
-```
+### Reading material for people who are comfortable with programming, but haven't done a lot of python
 
-You should see the output "Scikit is installed!"
+If you are comfortable opening up a terminal but want a python intro/refresher check out https://www.learnpython.org/ for a really nice introduction to Python.
 
-```
-python3 test-keras.py
-```
+### Suggestions for people who have done a lot of programming in python
+
+A lot of people like to follow along with ipython or jupyter notebooks and I think that's great!  It makes data exploration easier.  I also really appreciate pull requests to make the code clearer.
+
+If you've never used pandas or numpy - they are great tools and I use them heavily in my work and for this class.  I assume no knlowedge of pandas and numpy but you may want to do some learning on your own.  You can get a quick overview of pandas at http://pandas.pydata.org/pandas-docs/stable/10min.html.  There is a great overview of numpy at https://docs.scipy.org/doc/numpy/user/quickstart.html.
 
-You should see the output "Using TensorFlow backend.  Keras is installed!"