-
Notifications
You must be signed in to change notification settings - Fork 546
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
201 changed files
with
4,608 additions
and
173 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,91 @@ | ||
# 기여하기 | ||
|
||
<p align="center"> | ||
<a href="CONTRIBUTING.md">English</a> | | ||
<a href="CONTRIBUTING.zh-CN.md">简体中文</a> | | ||
<a href="CONTRIBUTING.de-DE.md">Deutsch</a> | | ||
<a href="CONTRIBUTING.fr-FR.md">Français</a> | | ||
<a href="CONTRIBUTING.es-ES.md">Español</a> | | ||
<span>한국어</span> | ||
</p> | ||
|
||
## 과정 | ||
|
||
1. 구현하고 싶은 변경 사항을 설명하는 이슈를 제출합니다. 사소한 변경이나 버그 수정인 경우 3단계로 건너뛰어도 됩니다. | ||
2. 이슈에서 범위가 논의된 후, 자신에게 할당합니다. OpenBot 프로젝트의 "해야 할 일" 열에 나타나야 합니다. | ||
3. 프로젝트를 포크하고 로컬로 클론합니다: | ||
|
||
`git clone https://github.com/<user_id>/OpenBot.git` | ||
|
||
4. 브랜치를 생성합니다: | ||
|
||
`git checkout -b <branch-name>` | ||
|
||
여기서 `<branch-name>`은 작업의 범위를 간결하게 설명합니다. | ||
|
||
5. 작업을 수행하고, 좋은 커밋 메시지를 작성한 후, 포크한 저장소에 브랜치를 푸시합니다: | ||
|
||
```bash | ||
git add <modified file> | ||
git commit -m <meaningful description> | ||
git push --set-upstream origin <branch-name> | ||
``` | ||
|
||
6. GitHub에서 [풀 리퀘스트 요청](https://github.com/intel-isl/OpenBot/pulls)을 생성하고 이슈에 연결합니다. OpenBot 프로젝트의 "진행 중" 열에 나타나야 합니다. | ||
7. 받을 수 있는 코드 리뷰 피드백을 반영하여 포크한 저장소에 푸시합니다. 풀 요청은 자동으로 업데이트됩니다. | ||
8. 세상을 더 나은 곳으로 만들었다는 보상으로 원하는 음료를 마십니다. | ||
|
||
## 가이드라인 | ||
|
||
- 나머지 코드와 동일한 스타일과 포맷을 사용합니다. | ||
- Java (Android) 및 Python 코드에 대한 내용은 [아래](#Formatting)를 참조하세요. | ||
- 다른 코드의 경우, 가능한 한 잘 어울리도록 노력하세요. | ||
- 변경한 코드와 관련된 문서를 업데이트합니다. | ||
- 제3자 종속성을 포함하고 싶다면, 먼저 이슈에서 논의하세요. | ||
- 풀 요청은 가능한 한 적은 변경으로 단일 기능을 구현해야 합니다. | ||
- 임시 파일이나 바이너리 파일이 포함되지 않도록 합니다 (gitignore가 대부분 이를 처리해야 합니다). | ||
- 풀 요청을 제출하기 전에 마스터 브랜치를 자신의 브랜치에 리베이스/머지합니다. | ||
- 가능하다면 Windows, Linux 및 OSX에서 코드를 테스트합니다. | ||
|
||
## 초기화 | ||
|
||
### Java | ||
|
||
Java 코드를 포맷하기 위해 gradle 스크립트를 사용합니다. `android` 디렉토리에 있어야 합니다. | ||
|
||
코드를 확인하려면 다음을 사용하세요: | ||
|
||
```bash | ||
./gradlew checkStyle | ||
``` | ||
|
||
모든 파일에 스타일을 적용하려면 다음을 실행합니다: | ||
|
||
```bash | ||
./gradlew applyStyle | ||
``` | ||
|
||
### Python | ||
|
||
Python 코드 포맷에는 [black](https://pypi.org/project/black/)을 사용합니다. | ||
|
||
현재 디렉토리의 코드를 확인하려면: | ||
|
||
```bash | ||
black --check . | ||
``` | ||
|
||
현재 디렉토리의 모든 파일에 스타일을 적용하려면: | ||
|
||
```bash | ||
black . | ||
``` | ||
|
||
## 추가 자료 | ||
|
||
오픈 소스 프로젝트에 기여하는 방법에 대한 더 많은 정보가 필요하다면, 다음 두 가지 참고 자료를 추천합니다: | ||
|
||
- [오픈 소스에 기여하는 방법](http://opensource.guide/how-to-contribute/) | ||
- [GitHub 프로젝트에 기여하는 초보자 가이드](https://akrabat.com/the-beginners-guide-to-contributing-to-a-github-project/) | ||
|
||
감사합니다! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
## 면책 조항 | ||
|
||
<p align="center"> | ||
<a href="DISCLAIMER.md">English</a> | | ||
<a href="DISCLAIMER.zh-CN.md">简体中文</a> | | ||
<a href="DISCLAIMER.de-DE.md">Deutsch</a> | | ||
<a href="DISCLAIMER.fr-FR.md">Français</a> | | ||
<a href="DISCLAIMER.es-ES.md">Español</a> | | ||
<span>한국어</span> | ||
</p> | ||
|
||
OpenBot 프로젝트는 교육, 실험 및 오락 목적으로 접근 가능한 로봇 솔루션을 제공하는 오픈 소스 이니셔티브입니다. 다음 면책 조항은 OpenBot 소프트웨어 및 하드웨어 설계의 사용 조건을 설명합니다. | ||
|
||
### 소프트웨어 면책 조항 | ||
|
||
- OpenBot 소프트웨어는 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. | ||
- OpenBot 프로젝트의 기여자 및 유지 관리자는 소프트웨어 사용으로 인해 발생할 수 있는 데이터 손실이나 손해에 대해 책임지지 않습니다. | ||
- 사용자는 OpenBot 소프트웨어 사용이 모든 관련 법률 및 규정을 준수하는지 확인할 책임이 있습니다. | ||
- 소프트웨어를 악의적이거나 비윤리적인 목적으로 잘못 사용하는 것은 엄격히 금지됩니다. | ||
|
||
### 하드웨어 면책 조항 | ||
|
||
- OpenBot 하드웨어 설계는 교육 및 실험 목적으로 제공되며 모든 사용 사례에 적합하지 않을 수 있습니다. | ||
- 사용자는 OpenBot 하드웨어의 구현이 해당 지역의 안전 기준 및 규정을 준수하는지 확인할 책임이 있습니다. | ||
- OpenBot 프로젝트의 기여자 및 유지 관리자는 OpenBot 하드웨어 설계를 기반으로 한 로봇의 건설, 수정 또는 작동으로 인해 발생하는 부상, 손상 또는 손실에 대해 책임지지 않습니다. | ||
- 사용자는 OpenBot 기반 로봇을 구축하고 운영할 때 주의를 기울이고 안전을 최우선으로 할 것을 권장합니다. | ||
|
||
### 일반 면책 조항 | ||
|
||
- OpenBot 프로젝트의 기여자 및 유지 관리자는 OpenBot 소프트웨어 및 하드웨어 설계의 사용 또는 오용으로 인해 직접적 또는 간접적으로 발생하는 손해 또는 손실에 대한 책임을 부인합니다. | ||
- 사용자는 OpenBot 리소스를 책임감 있게, 윤리적으로, 모든 적용 가능한 법률 및 규정을 준수하여 사용할 것을 권장합니다. | ||
|
||
OpenBot 소프트웨어 및 하드웨어 설계를 사용함으로써, 귀하는 이 면책 조항의 내용을 읽고 이해하며 동의했음을 인정합니다. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,97 @@ | ||
<a href="https://www.openbot.org/" target="_blank"> | ||
<img align="center" alt="Banner" width="100%" src="docs/images/banner.jpg" /> | ||
</a> | ||
|
||
<h1 align="center"><a>스마트폰을 로봇으로 변신시키기</a></h1> | ||
|
||
<p align="center"> | ||
<img alt="GitHub build" src="https://img.shields.io/github/actions/workflow/status/isl-org/OpenBot/gradle.yml?branch=master"></a> | ||
<img alt="GitHub issues" src="https://img.shields.io/github/issues/isl-org/OpenBot"></a> | ||
<img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/isl-org/OpenBot"></a> | ||
<img alt="GitHub forks" src="https://img.shields.io/github/forks/isl-org/OpenBot"></a> | ||
<img alt="GitHub stars" src="https://img.shields.io/github/stars/isl-org/OpenBot"></a> | ||
<img alt="Github downloads" src="https://img.shields.io/github/downloads/isl-org/OpenBot/total"></a> | ||
<img alt="Github size" src="https://img.shields.io/github/repo-size/isl-org/OpenBot"></a> | ||
<img alt="Github license" src="https://img.shields.io/github/license/isl-org/OpenBot"></a> | ||
</p> | ||
|
||
<p align="center"> | ||
<a href="README.md">English</a> | | ||
<a href="README.zh-CN.md">简体中文</a> | | ||
<a href="README.de-DE.md">Deutsch</a> | | ||
<a href="README.fr-FR.md">Français</a> | | ||
<a href="README.es-ES.md">Español</a> | | ||
<span>한국어</span> | ||
</p> | ||
|
||
OpenBot은 스마트폰을 저렴한 로봇의 두뇌로 활용합니다. 약 50만원의 아두이노 RC카를 로봇 본체 역할을 하도록 설계했습니다. 안드로이드 스마트폰용 소프트웨어는 사람 추적 및 실시간 자율 주행과 같은 고급 로봇 워크로드를 지원합니다. | ||
## OpenBot 시작하기 | ||
|
||
- [면책 조항](DISCLAIMER.ko-KR.md) 읽기 | ||
- [로봇 본체](body/README.ko-KR.md) 만들기 | ||
- [Arduino 펌웨어](firmware/README.ko-KR.md) 플래시하기 | ||
- [Android 앱](android/README.ko-KR.md) 설치하기 | ||
- [컨트롤러](controller/README.ko-KR.md)를 통해 로봇 조종하기 | ||
- [Playground](open-code/README.ko-KR.md)에서 로봇을 프로그래밍하기 | ||
- [주행 정책](policy/README.ko-KR.md) 훈련하기 | ||
|
||
## 소 스코드 다운로드 | ||
|
||
- 저장소를 [zip 파일](https://github.com/intel-isl/OpenBot/archive/master.zip)로 다운로드하여 원하는 폴더에 압축을 풀 수 있습니다. | ||
- 다음 명령어를 사용하여 GitHub에서 OpenBot 저장소를 복제할 수 있습니다: | ||
```bash | ||
git clone https://github.com/intel-isl/OpenBot.git | ||
``` | ||
- OpenBot 저장소를 포크한 다음 로컬 복사본을 복제할 수 있습니다. 특히 [기여](CONTRIBUTING.ko-KR.md)를 하려는 경우 이 방법을 권장합니다. | ||
## 비디오 | ||
|
||
<a href="https://www.youtube.com/watch?v=RbzPXywJifA" > | ||
<img align="center" width="300" alt="youtube video" src="https://img.youtube.com/vi/RbzPXywJifA/hqdefault.jpg" /> | ||
</a> | ||
|
||
<a href="https://www.youtube.com/watch?v=qc8hFLyWDOM" > | ||
<img align="center" width="300" alt="youtube video" src="https://img.youtube.com/vi/qc8hFLyWDOM/hqdefault.jpg" /> | ||
</a> | ||
|
||
## OpenBot을 사용한 멋진 프로젝트 | ||
|
||
이미 OpenBot을 사용하는 멋진 프로젝트가 많이 있습니다. 아래는 그 중 일부입니다. 이미지를 클릭하면 각 프로젝트로 이동합니다. | ||
<p float="left"> | ||
<a href="https://www.thingiverse.com/thing:4670884" target="_blank"> | ||
<img alt="Tank OpenBot" width="24%" src="docs/images/openbot_tank.jpg" /> | ||
</a> | ||
<a href="https://diyrobocars.com/2020/12/14/an-improved-version-of-the-intel-openbot" target="_blank"> | ||
<img alt="2WD OpenBot" width="24%" src="docs/images/openbot_2wd.jpg" /> | ||
</a> | ||
<a href="https://custom-build-robots.com/raspberry-pi-robot-cars/openbot-your-smartphone-controls-a-robot-car-introduction/13860?lang=en" target="_blank"> | ||
<img alt="Cardboard OpenBot" width="24%" src="docs/images/chassis_cardboard_1.jpg" /> | ||
</a> | ||
<a href="https://www.youtube.com/watch?v=PEj8jWapGt4" target="_blank"> | ||
<img alt="Baby Yoda OpenBot" width="24%" src="docs/images/openbot_yoda.jpg" /> | ||
</a> | ||
</p> | ||
|
||
## 연락처 | ||
|
||
- OpenBot 커뮤니티와 연결하려면 [Slack 채널](https://join.slack.com/t/openbot-community/shared_invite/zt-jl8ygxqt-WNRNi9yzh7Lu60qui6Nh6w)에 참여하세요. | ||
- [Email](mailto:openbot.team@gmail.com)로 연락주세요. | ||
|
||
## 기여 | ||
|
||
[기여 가이드라인](CONTRIBUTING.ko-KR.md)을 읽어주세요. 어디서부터 시작해야 할지 잘 모르겠다면 [열린 이슈](https://github.com/intel-isl/OpenBot/issues)를 참조하세요. | ||
## 인용 | ||
|
||
OpenBot을 사용하는 경우 [논문](https://arxiv.org/abs/2008.10631)을 인용해 주세요. | ||
|
||
```bib | ||
@inproceedings{mueller2021openbot, | ||
title = {OpenBot: Turning Smartphones into Robots}, | ||
author = {M{\"u}ller, Matthias and Koltun, Vladlen}, | ||
booktitle = {Proceedings of the International Conference on Robotics and Automation (ICRA)}, | ||
year = {2021}, | ||
} | ||
``` | ||
|
||
<a href="https://www.openbot.org//" target="_blank"> | ||
<img align="center" alt="Footer" width="100%" src="docs/images/footer.gif" /> | ||
</a> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.