Skip to content

Latest commit

 

History

History
144 lines (114 loc) · 5.52 KB

GettingStarted.md

File metadata and controls

144 lines (114 loc) · 5.52 KB
Raw

Getting Started

HuStar Robot Academy

Lecture Notes by idebtor@gmail.com

To get started, do the first thing first:

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

These reading materials is available at my github.com/idebtor/HuStarML.

How to view markdown(.md) files in Chrome (or rendering in HTML)

  1. View them always in github website automatically and better.
  • and/or
  1. Install Markdown Viewer extension.
  2. Navigate to chrome://extensions and
    • Locate Markdown Viewer and click on the DETAILS button
    • Check the option Allow access to file URLs
  3. 크롬에서 chrome://extensions 접속 한 후,
    • Markdown Viewer 세부정보에서
    • "파일 URL에 대한 액세스 허용"을 체크하십시오
  4. Open local or remote .md file in Chrome.
  5. Enjoy nicely formatted HTML!

Install "GitHub Desktop" and "Git"

  • 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 HuStar repository into your local computer:
  • How to clone a repository from GitHub: Refer to this site.
  • Click 'watch' and 'star' at the top of the web page.
  • Then, in your computer, you may have the following github/HuStar folder as shown below:
C:\GitHub\HuStar
  • Since this HuStar 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:
  ~/HuStarML          # Machine Learning
  ~/HuStarAS          # Android Studio

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

JoyNote: How do I force git pull to overwrite local files?

  • Go to the ~/HuStarML folder.
  • Open a console and run the following two commands.
git fetch --all
git reset --hard origin/master

or

git stash

Explanation: git fetch downloads the latest from remote without trying to merge or rebase anything. Then the git reset resets the master branch to what you just fetched. The --hard option changes all the files in your working tree to match the files in origin/master

Caution: If you have any local changes, they will be lost. With or without --hard option, any local commits that haven't been pushed will be lost.

JoyNote: How do I keep my local files clean after trials?

  • Go to the ~/HuStarML folder.
  • Open a console and run the following command.
git clean -f

Explanation: To delete all untracked files.

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:

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
  >>> import tensorflow as tf
  >>> print(tf.__version__)
  2.3.0
  >>> import keras
  Using TensorFlow backend
  ```

Install the 'Code' by Microsoft - THE editor for coders

  1. The Code is a text editor that most professional coders love nowadays.
  2. Start the Code.

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

How to view Jupyter-Lab (or Jupyter Notebook) files(.ipynb) in a browser

  1. View them in github website automatically, but cannot run the code cells. and/or
  2. Follow the instructions here to install Python and Jupyter Lab.
  3. Open a console, run the following command to run the Jupyter-lab
 $ jupyter-lab

or double-click the following file on pc if available

$ _start_jupyter.bat
  1. Now, you can read, run and edit the code/markdown cells.

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

God is good all the time.