Skip to content

Latest commit

 

History

History
225 lines (164 loc) · 9.53 KB

GettingStarted.md

File metadata and controls

225 lines (164 loc) · 9.53 KB

그런즉 너희가 먹든지 마시든지 무엇을 하든지 다 하나님의 영광을 위하여 하라 (고전10:31)


NOTE: The following materials have been compiled and adapted from the numerous sources including my own. Please help me to keep this tutorial up-to-date by reporting any issues or questions. Send any comments or criticisms to idebtor@gmail.com Your assistances and comments will be appreciated.


Getting Started

To get started, do the first thing first:

  1. Read README.
  2. Read Syllabus.
  3. Read 'GettingStarted' - this file
  4. Follow instructions in 'GettingStarted' as soon as possible(ASAP).

This is available at github.com/idebtor/JoyAI.

Three ways to view markdown(.md) files

GitHub

  1. View them always in github website automatically and better.
  2. GitHub does not support LaTex yet. You may not see the well-formatted math equations.

Web Browser (Chrome/Edge)

  1. Install Markdown Preview Plus extension in your browser(Chrome, Edge).
  2. Go to extensions, 도구 더보기 혹은 확장 in the browser's setting
  3. Locate Markdown Preview Plus and click on the DETAILS 세부정보
  4. Check the option Allow access to file URLs, 파일 URL에 대한 액세스 허용
  5. Drag and drop ~.md file in your brower.
  6. For LaTex, check the math option in Markdown Preview Plus icon in your brower top menubar'.
  7. Enjoy nicely formatted HTML!

Visual Studio Code

  1. Install Markdown All in One & Auto-Open Preview extensions in your Code.
  2. Enjoy nicely formatted HTML!

Refer to my tutorial: https://youtu.be/sS1viPcXDIo

Join Piazza

There are two ways to join Piazza, connect to the www.piazza.com.

  • To join Piazza, you may need the following information and

    • School: Handong Global University
    • Course: Artificial Intelligence Applications for ALL
  • If you have an email address that ends with ~.hgu.edu or ~.handong.edu domain and use it everyday, go the www.piazza.com and follow the instructions in the website.

  • On your request with your email address, I may register it for you. We'll be conducting all class-related discussion here this term. The quicker you begin asking questions on Piazza (rather than via emails), the quicker you'll benefit from the collective knowledge of your classmates and instructors. We encourage you to ask questions when you're struggling to understand a concept—you can even do so anonymously.

Install Anaconda

Anaconda is a Python and R distribution package. It aims to provide everything you need (python wise) for data science "out of the box". It includes:

  • The core python language
  • 300+ python "packages" (libraries)
  • Jupyter Lab, Jupyter Notebook, adn Spyder (IDE/editor)
  • conda, Anaconda's own package manager, used for updating Anaconda and packages

To install the anaconda:

  • Visit website Anaconda Distribution

    • Choose one of Windows/MacOS/Linux
    • Python 3.x Version Download
  • At the beginning of installation, check the following option

    • Add Anaconda to my PATH environment variable as shown below:

  • Need help? Follow this guide.

After your installation

Do the following in cmd windows or in PowerShell to check your successful installation; ($ is just a prompt of your console, >>> is a prompt from Python.)

  $ python
  >>> Python 3.8.10 (default, May 19 2021, 11:45:54) [MSC v.1916 64 bit (AMD64)] :: Anaconda, Inc. on win32
      Type "help", "copyright", "credits" or "license" for more information.
  >>> import math
  >>> math.sqrt(2)
  1.4142135623730951
  >>> exit()

Need more installation?

Use the following command if you need more installation of packages (-U for upgrade only):

  $ pip install a_package_name
  $ pip install -U a_package_name              

Install "Git" and "GitHub Desktop"

  • Install git from this site for your computer.
  • Install GitHub Desktop

After installation of GitHub Desktop, be a member if already not.

  • Clone the GitHub JoyAI repository into your local computer(e.g. C:/github/joyai):

  • How to clone a repository from GitHub:

  • Click 'watch' and 'star' at the top of the web page^^.

  • Then, in your computer, you may have the following github/JoyAI folder as shown below (user may be different in your system.):

    • C:\Users\user\Documents\GitHub\JoyAI
    • C:\github\joyai

    I recommend you make the path simple as possible like C:\github\joyai\

  • Since this JoyAI repository can be updated anytime, keep this local repository as "read-only". Don't code yours here!.

  • Copy them into your own repository or your own local development folders in your computer you can easily access them. They should look like the following:

    ~/JoyAI/ppts
    ~/JoyAI/ipynb
    ~/JoyAI/01GettingStarted.md
    ~/JoyAI/README.md             
    ~/JoyAI/Syllabus       
    

    Note for Multi-screen users: Remove the following file if GitHub Desktop is displayed off-screen. Restart Desktop GitHub. (user below may be different in your system.)

    C:\Users\user\AppData\Roaming\GitHub Desktop\window-state.json
    

Are ready for 'Hello World!' program in Python?

  • Open a console. (You may use Anaconda Prompt, cmd or powershell in Windows.)
$ python
>>> print('Hello World!')
>>> 1 + 2
3
>>> exit()
$

A few ways to start Jupyter-lab or Jupyter notebook

Method 1: This method may not work unless you have set PATH environment variable.

  1. Using File Explorer, navigate to where your Jupyter notebook file is
  2. Using File menu in File Explorer, click Open PowerShell(PS).
  3. At PS console, enter the following:
```
PS C:\> jupyter-lab
PS C:\> jupyter notebook
```

Method 2: This is one-line batch command file that runs Jupyter-lab.

  1. Get a copy of the batch file start_jupyter.bat which is available at https://github.com/idebtor/JoyAI
  2. Place the batch file at the folder where your notebook file is.
  3. Double-click the batch file.

Method 3: This option always works:

  1. Go to the Windows menu <Start> -> <Anaconda 3> -> <Anaconda Prompt>
  2. At a console, enter the following:
    (base) C:\Users\user> jupyter-lab
    (base) C:\Users\user> jupyter notebook

Method 4: This is not recommended since it is too slow to get into the notebook.

  1. Using Anaconda Navigator, choose Jupyter Notebook or Jupyter-lab

Are ready for cloning another open-source program in GitHub?

Let's clone some open-source packages that uses with MNIST dataset and classifies user's hand-writing digits interactively.

  • Clone the following two github sites
https://github.com/scrambledpie/Drawing-Mnist-and-Cifarizing-image-files
https://github.com/rhammell/mnist-draw

Drawing-Mnist-and-Cifarizing-image-files

Once you clone this source code, you may see the folder named Drawing-Mnist-and-Cifarizing-image-files and ipynb files in your local folder.

The following Jupyter notebook code provides a blank canvas in the notebook so that a user may create their own test samples to input into a trained neural net in Keras. Some code borrowed from Francois Chollet https://github.com/fchollet

  • Run the code cells one by one in DrawMyOwnNumbers.ipynb
  • If you see some error messages, read and attempt to resolve the problems.
  • You may be asked to install more packages/modules. Then how would you do?

Minist-draw (unstable)

  • (I am still experiencing a difficulty to run this program in some machines.)

  • Follow the instructions in README. Then you may be able to start a web server and display a web page that has a user interface getting user's hand-writing digits and recognize them interactively.

  • If you experience an error something like

127.0.0.1 - - [04/Mar/2019 14:55:50] b'ModuleNotFoundError: No module named \'numpy.core._multiarray_umath\'\r\nImportError: numpy.core.multiarray failed to import\r\n\r\nThe above exception was the direct cause of the following exception:\r\n\r\nTraceback (most recent call last):\r\n  File "<frozen importlib._bootstrap>", line 980,
  • install numpy with -U (upgrade) option as shown below:
    pip install -U numpy
    

References

What's Next?


One thing I know, I was blind but now I see. John 9:25