Skip to content

GettingStarted.md

Latest commit

 

History

History
194 lines (145 loc) · 8.06 KB

GettingStarted.md

File metadata and controls

194 lines (145 loc) · 8.06 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. Lecture notes by idebtor@gmail.com

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/DSpy.

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!

Joining 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: Data Structures in Python

  • 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
  • 200+ python "packages" (libraries)
  • Spyder (IDE/editor) and Jupyter Notebook
  • 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 DSpy repository into your local computer (e.g. C:/github/dspy):

  • 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/DSpy folder as shown below (user may be different in your system.):

    • C:\Users\user\Documents\GitHub\DSpy
    • C:\GitHub\DSpy
      I recommend you to make the path simple as possible like C:\github\dspy

  • Since this DSpy 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:

    ~/DSpy/ppt
~/DSpy/ipynb
~/DSpy/GettingStarted.md
~/DSpy/README.md             
~/DSpy/AIX20001Syllabus

    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/DSpy
  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

References

What's Next?

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