docs : update README with course structure and streamlined content

beachdweller · claude · beachdweller · commit f09bf66039a3 · 2026-02-08T00:00:58.000+09:00
Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/README.md b/README.md
@@ -6,166 +6,95 @@
 
 [![how to use NMISP repo](https://i.ytimg.com/vi/_GN74MRLYcI/hqdefault.jpg)](https://youtu.be/_GN74MRLYcI)
 
-이 소프트웨어는 다양한 수치 해법을 [`Python`](https://ko.wikipedia.org/wiki/%ED%8C%8C%EC%9D%B4%EC%8D%AC) 언어와 그 확장 기능인 `SciPy` 를 이용하여 설명하고자 함.<br>
-This software aims to describe various numerical methods in [`Python`](https://en.wikipedia.org/wiki/Python_%28programming_language%29) programming language and its extesion `SciPy`.
-
-## How to Open in [Google Colab](https://colab.research.google.com)<br>[구글 코랩](https://colab.research.google.com)에서 읽는 법
-
-1. Open an `ipynb` file of [this repository](https://github.com/kangwonlee/nmisp)<br>이 [저장소](https://github.com/kangwonlee/nmisp)의 `ipynb` 파일을 엶
-1. Click on ![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)<br>![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg) 클릭
-1. Try `Run all` of `Runtime`<br>`런타임` 아래 `모두 실행` 시도
-
-## How to commit changes on [Google Colab](https://colab.research.google.com) to Github<br>[구글 코랩](https://colab.research.google.com)의 변경 사항을 Github 에 반영하는 법
-
-1. [Fork](https://github.com/kangwonlee/nmisp/fork) the repository<br>저장소의 [분기](https://github.com/kangwonlee/nmisp/fork) 사본을 만듦
-1. Open the ipynb file from the forked repository<br>분기된 저장소에서 ipynb 파일을 엶
-1. Click on ![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)<br>![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg) 클릭
-1. Make changes<br>파일을 수정
-1. Choose `Save a copy in GitHub` under `File` menu<br>`파일` 메뉴 아래 `Github 에 사본 저장`
-1. Adjust permissions and/or retry if necessary<br>필요시 권한 조정 후 재시도
-
-## 설치 항목<br>Software to install
+이 저장소는 다양한 수치 해법을 [`Python`](https://ko.wikipedia.org/wiki/%ED%8C%8C%EC%9D%B4%EC%8D%AC) 언어와 그 확장 기능인 `SciPy` 를 이용하여 설명하고자 함.<br>
+This repository aims to describe various numerical methods in [`Python`](https://en.wikipedia.org/wiki/Python_%28programming_language%29) programming language and its extension `SciPy`.
+
+## 과정 구성<br>Course Structure
+
+```mermaid
+flowchart TD
+    A["00 Introduction<br>소개"]
+    B["10 Root Finding<br>방정식의 근"]
+    C["15 Optimization<br>최적화"]
+    D["20 Probability & Statistics<br>확률과 통계"]
+    E["28 Interpolation<br>보간법"]
+    F["30 Numerical Integration<br>수치 적분"]
+    G["35 SymPy<br>기호 연산"]
+    H["40 Linear Algebra 1<br>선형대수 1"]
+    I["50 ODE<br>상미분방정식"]
+    J["60 Linear Algebra 2<br>선형대수 2"]
+
+    A --> B
+    A --> D
+    A --> H
+    B --> C
+    B --> E
+    E --> F
+    F --> G
+    F --> I
+    H --> J
+    H --> I
+```
 
-### 깃 버전 관리 소프트웨어 : 명령행 실행 환경<br>Git Version Control Software : Commadline interface
+| 폴더<br>Folder | 주제<br>Topic | 주요 내용<br>Key Contents |
+|:---:|:---:|:---|
+| `00_introduction` | 소개<br>Introduction | 부동소수점, 파이썬 복습<br>Floating point, Python review |
+| `10_root_finding` | 방정식의 근<br>Root Finding | 순차, 이분법, 뉴턴-랩슨<br>Sequential, Bisection, Newton-Raphson |
+| `15_optimization` | 최적화<br>Optimization | 커브피팅, 분류, 선형계획<br>Curve fitting, Classification, LP |
+| `20_probability` | 확률 통계<br>Probability | 확률변수, 회귀, 판다스<br>Random variables, Regression, Pandas |
+| `28_interpolation` | 보간법<br>Interpolation | 보간법<br>Interpolation |
+| `30_num_int` | 수치 적분<br>Numerical Integration | 직사각형, 사다리꼴, 심프슨, 수렴 차수<br>Rectangle, Trapezoid, Simpson, Convergence order |
+| `35_sympy` | 기호 연산<br>SymPy | 기호 연산, 보 반력<br>Symbolic math, Beam reaction |
+| `40_linear_algebra_1` | 선형대수 1<br>Linear Algebra 1 | 벡터, 내적, 외적, 행렬<br>Vectors, Dot/Cross product, Matrix |
+| `50_ode` | 상미분방정식<br>ODE | 오일러, 훈, 룽게-쿠타<br>Euler, Heun, Runge-Kutta |
+| `60_linear_algebra_2` | 선형대수 2<br>Linear Algebra 2 | 연립방정식, 고유값, 가우스 소거<br>Systems of equations, Eigenvalues, Gauss elimination |
 
-* 우분투 리눅스의 경우 다음과 같이 설치<br>For Ubuntu Linux, install as follows
+## [Google Colab](https://colab.research.google.com) 에서 실행하기<br>Running on [Google Colab](https://colab.research.google.com)
 
-``` sh
-apt-get install git
-```
+### 노트북 열기<br>Opening a notebook
 
-* Windows 의 경우 아래 링크에서 다운로드 가능<br>Download for Windows available at the following link :  [Git for Windows](https://git-scm.com/download/win)
+1. 이 [저장소](https://github.com/kangwonlee/nmisp)의 `ipynb` 파일을 엶<br>Open an `ipynb` file of [this repository](https://github.com/kangwonlee/nmisp)
+1. ![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg) 클릭<br>Click on ![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)
+1. `런타임` 아래 `모두 실행` 시도<br>Try `Run all` under `Runtime`
 
-##### 간단한 추천 사항<br>A few simple recommendations
+### 변경 사항 저장하기<br>Saving changes to GitHub
 
-* 명령행에서 사용 Command line interface<br>
-* 실습실 환경에서는 credential manager 설치 삼가<br>Credential manager may not be a best choice for a computer lab
-* 아래 IDE 가운데 Microsoft Visual Studio Code 선택시 다음과 같이 생각해 볼 수 있음<br>
-To use Microsoft Visual Studio Code among IDEs below, an administrator may consider followings<br>
+1. 저장소의 [분기](https://github.com/kangwonlee/nmisp/fork) 사본을 만듦<br>[Fork](https://github.com/kangwonlee/nmisp/fork) the repository
+1. 분기된 저장소에서 `ipynb` 파일을 엶<br>Open the `ipynb` file from the forked repository
+1. ![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg) 클릭<br>Click on ![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)
+1. 파일을 수정<br>Make changes
+1. `파일` 메뉴 아래 `Github 에 사본 저장`<br>Choose `Save a copy in GitHub` under `File` menu
 
-| 항목<br>Key | 값<br>Value |
-|:-------:|:-------:|
-| git 기본 편집기 <br> Default editor for Git | MS VS Code |
-| 경로 환경 조정 <br> Adjusting Path environment | Use Git from the Windows Command Prompt |
-| 터미널 에뮬레이터 <br>Terminal emulator | Use Windows' default console window |
-| 자격 인증 관리자 활성화  <br> Enable Git Credential Manager | 전산 실습 환경의 경우, 선택 해제<br>If computer lab, unselect |
+## 로컬 설치<br>Local Installation
 
-이후 MS vscode 에서도 한두가지 추가 설정을 실시하면 내장 터미널로 `git-bash` 를 사용할 수 있음<br>
-With a few additional configurations in MS vscode, one could use `git-bash` as the integrated terminal.
+### 요구 사항<br>Requirements
 
-### 파이썬 프로그래밍 언어<br>Python Programming Language
+* [Git](https://git-scm.com/downloads)
+* [Miniconda](https://docs.conda.io/en/latest/miniconda.html) 또는<br>or [Anaconda](https://www.anaconda.com/download)
 
-#### [Miniconda](https://docs.conda.io/en/latest/miniconda.html) <br>
-
-* Python 3.7 이후<br>Python 3.7 or latter
-* 64bit 판 추천<br>Recommend 64 bit versions
-* 리눅스 명령어 환경에서 다음 실행<br>Run following commands in a Linux shell
+### 설치 및 실행<br>Setup and Run
 
 ``` sh
-# Download & install miniconda
-wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
-chmod +x Miniconda3-latest-Linux-x86_64.sh
-./Miniconda3-latest-Linux-x86_64.sh
-source ~/.bashrc
-
-# Install python modules
 git clone https://github.com/kangwonlee/nmisp
-pushd nmisp
-# You may choose a different environment configuration under ./tests/ folder
-conda env create -n nmisp -f ./tests/environment.2020.07.yml
-
-# Start the jupyter notebook
+cd nmisp
+conda env create -n nmisp -f ./tests/environment.2023.09.yml
 conda activate nmisp
-jupyter notebook &
-# please do not close the shell
-
-# to run tests
-pytest -n auto tests/
+jupyter notebook
 ```
 
-#### [Anaconda](https://www.anaconda.com/distribution/) <br>
-
-* Python 3.7.x 이후<br>Python 3.7.x or latter
-* 2019.07판 이후<br>Latter or equal to 2019.07
-* 명령행에서 실행해야 할 경우, 경로에 추가하도록 설정<br>To run from a command line, configure to add python to the PATH
-* 경로 이름에 한글을 사용할 수 없음<br>Use ASCII characters for path name
-* In addition, some of the following modules may be needed<br>아래 모듈 중 일부 추가 설치가 필요할 수 있음
+### 테스트 실행<br>Running Tests
 
 ``` sh
-conda install conda-forge::tensorflow
-conda install pytorch::pytorch
-conda install pytorch::torchvision
-```
-
-### 깃 버전 관리 소프트웨어 : 그래픽 실행 환경<br>Git Version Control Software : Graphic user interface
-
-아래 가운데 택일<br>Choose one from below
-* [SourceTree](https://www.sourcetreeapp.com/download/)
-* [Github Desktop](https://desktop.github.com/)
-
-### 통합 개발 환경<br>Integrated Development Environment
-
-* iPython 노트북 (`.ipynb`) 파일 사용시는 반드시 필요하지 않을 수 있음<br>May not need one for iPython notebook (`.ipynb`) files
-* 아래 가운데 택일<br>Choose one from below
-
-#### Spyder
-
-* Anaconda 와 함께 설치될 수 있음.<br>Anaconda may include spyder.
-
-#### [PyCharm Community](https://www.jetbrains.com/pycharm/download/)
-
-* PyCharm 을 실행시키기 위해 [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/index.html) 를 설치해야 할 수 있음 (2016 09)<br>
-PyCharm may need [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/index.html) to run.
-
-#### [Microsoft Visual Studio Code](https://code.visualstudio.com/download)
-
-* Anaconda 설치 후 설치 선택 가능<br>
-Installation [button](https://blogs.msdn.microsoft.com/pythonengineering/2018/02/15/visual-studio-code-is-now-shipping-with-anaconda/) available at the end of Anaconda installation<br>
-* [다운로드](https://code.visualstudio.com/download) 받아서 설치도 가능<br>
-Possible to [download](https://code.visualstudio.com/download) and install from the website<br>
-[Setup Overview](https://code.visualstudio.com/docs/setup/setup-overview) /
-[Python Configuration Instruction](https://code.visualstudio.com/docs/python/python-tutorial)
-* Windows 에서 `git-bash`를 내장 터미널로 사용하려면 다음과 같은 추가 설정이 필요함.\[[참고](https://code.visualstudio.com/docs/editor/integrated-terminal)\]<br>
-In Windows, to use `git-bash` as the integrated terminal, following additional settings would eable it.\[[Ref](https://code.visualstudio.com/docs/editor/integrated-terminal)\]
-
-1. File > Preferences > Settings [[참고 Ref](https://code.visualstudio.com/docs/getstarted/settings)\]
-2.
-```json
-"terminal.integrated.shell.windows": **path to bash.exe here**
+conda activate nmisp
+pytest -n auto tests/
 ```
 
 ### 설치 동영상<br>Installation video
 [![설치 동영상 Installation video](https://i.ytimg.com/vi/NAQn1jQws3Q/hqdefault.jpg)](https://www.youtube.com/embed/videoseries?list=PLA6B0Lmr9oJNVqYMpfpbXxQCZxNrS1Xuo)
 
-## `jupyter` 노트북<br>`jupyter` notebook
-
-* 이 저장소 는 주로 [`jupyter` 노트북](http://blog.ncsoft.com/?p=21870)으로 만들어져 있음.<br>
-This repository is mostly written in [`jupyter` notebook](http://arogozhnikov.github.io/2016/09/10/jupyter-features.html).<br>
-* `jupyter` 노트북은 웹브라우저를 통해 프로그램 코드를 수정 실행하고 LaTex 수식을 포함한 문서 작성이 가능함.<br>
-Through a web browser, `jupyter` notebook enables editing & running program codes and writing documents including LaTex equations.<br>
-
-## `jupyter` 노트북 실행시키는 법<br>How to start the `jupyter` notebook
-
-* 적당한 folder 를 만듦 <br> Make an appropriate folder
-* Git 또는 SourceTree 를 이용하여 위 folder 아래 이 원격 저장소를 `git clone` <br> Using the Git or SourceTree, `git clone` this repository under the folder
-* `cmd` 또는 `git bash` 실행한 후 `cd` 명령으로 `clone` 된 지역 저장소 folder로 이동 <br> Start `cmd` or `git bash` and using the `cd` command change working folder to the cloned folder
-* `cmd` 또는 `git bash` 에서 각각 `cd` 또는 `pwd` 로 `clone` 된 folder 인지 확인 <br>Check location using `cd` or `pwd` in `cmd` or `git bash`
-* `jupyter notebook` 실행 <br>Run `jupyter notebook`
-* 필요에 따라 `~/.bashrc` 파일에 다음 내용을 추가<br>As necessary, add following lines to `~/.bashrc` file
-
-
-``` sh
-alias log='git log --oneline --graph --all --decorate'
-alias nb='jupyter notebook --no-browser &'
-```
-
-### 실행 동영상 (`git bash`) <br>Instruction video (`git bash`)
-
-[![실행 동영상 (SourceTree) Instruction video (SourceTree)](https://i.ytimg.com/vi/El77Whu9UsE/hqdefault.jpg)](https://www.youtube.com/embed/videoseries?list=PLA6B0Lmr9oJO4x4NWWedfHnCOfelU3L39)
-
-## 알림 <br> Acknowledgement
+## 알림<br>Acknowledgement
 
 * This software was initially supported by the Korea Ministry of Land, Infrastructure, and Transportation. It was also supported by the Korean Agency for Infrastructure Technology Advancement. (18TLRP-B117133-03)
 <br>이 소프트웨어는 대한민국 국토교통부 건설교통과학기술진흥원 교통물류연구사업의 지원을 받아 시작되었음. (18TLRP-B117133-03)
-* Also, this software got help from generative artificial intelligence : Google Gemini Advance in improving the text and source code quality.
-<br>또한, 이 소프트웨어는 문장과 코드 품질 향상을 위해 생성형 인공지능 구글 제미니 어드밴스의 도움을 받았음.
+* Also, this software got help from generative artificial intelligence : Google Gemini Advance and Anthropic Claude Opus 4.6 in improving the text and source code quality.
+<br>또한, 이 소프트웨어는 문장과 코드 품질 향상을 위해 생성형 인공지능 구글 제미니 어드밴스와 앤스로픽 클로드 오퍼스 4.6의 도움을 받았음.
