Repolode
ShisatoYano

ShisatoYano/AutonomousVehicleControlBeginnersGuide

자율주행 제어 알고리즘을 다루는 Python 샘플 코드와 가이드 문서로, 초보자가 학습 자료로 활용하기 좋습니다.

스타
1,936
포크
319
열린 이슈
66
마지막 커밋
16시간 전

어떤 프로젝트인가요?

이 저장소에는 자율주행 알고리즘을 구현한 Python 샘플 프로그램과 각 프로그램의 설계 문서가 모여 있습니다. 위치 추정, 매핑, 경로 계획, 경로 추종, 인지 기능을 다루며, 각 알고리즘은 애니메이션 데모를 보여 주는 실행 가능한 시뮬레이션으로 제공됩니다.

이 프로젝트는 알고리즘과 자율주행 스택의 소프트웨어 아키텍처를 함께 학습할 수 있는 기술 가이드입니다. Extended Kalman Filter 위치 추정과 NDT 지도 생성 등이 예제로 포함되어 있습니다. Python 3.13과 NumPy, SciPy, Matplotlib 등의 명시된 의존성을 설치한 뒤 src/simulations 디렉터리에서 시뮬레이션을 실행할 수 있으며, MPC 경로 추종에는 CasADi와 do-mpc도 필요합니다. Docker 개발 컨테이너 설정도 제공됩니다.

작성자는 차량 내비게이션의 각 단계에서 알고리즘을 바꿔 끼우고 결과를 비교할 수 있는 시뮬레이터를 향후 개발할 계획입니다.

핵심 기능

  • 01위치 추정, 매핑, 경로 계획, 경로 추종, 인지 알고리즘을 위한 Python 샘플 코드.
  • 02각 알고리즘에 애니메이션 데모를 포함한 실행 가능한 시뮬레이션이 제공됩니다.
  • 03각 프로그램의 구조를 설명하는 설계 문서가 제공됩니다.
  • 04환경을 검증하기 위한 단위 테스트를 pytest로 실행할 수 있습니다.
  • 05의존성을 자동으로 설치하는 Docker 개발 컨테이너 설정이 제공됩니다.

활용 사례

  • 실행 가능한 Python 예제를 통해 자율주행 알고리즘 학습.
  • 자율주행 개념을 가르치는 강의나 교육 자료로 코드 활용.
  • 시뮬레이션에서 위치 추정 및 경로 추종 방법을 프로토타이핑하거나 비교.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/ShisatoYano/AutonomousVehicleControlBeginnersGuide
  2. 2

    환경을 설정합니다(WSL의 Docker 개발 컨테이너를 사용하거나 명시된 Python 요구 사항을 설치합니다)

  3. 3

    단위 테스트를 실행해 환경이 제대로 작동하는지 확인합니다

    . run_test_suites.sh
  4. 4

    확장 칼만 필터를 사용한 위치 추정과 같은 시뮬레이션 예제를 실행합니다

    python src/simulations/localization/extended_kalman_filter_localization/extended_kalman_filter_localization.py

사용 전 알아둘 점

  • Python 3.13.x와 NumPy, SciPy, CasADi, do-mpc 등의 여러 라이브러리가 필요합니다.
  • README에서는 네이티브 환경 또는 VM의 Linux를 권장하며, WSL을 통해 Windows에서 사용할 경우 Docker 설정이 필요합니다.
  • 설계 문서는 아직 완성되지 않았으며 계속 업데이트되고 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

AutonomousVehicleControlBeginnersGuide은(는) 무엇인가요?
자율주행 제어 알고리즘을 다루는 Python 샘플 코드와 가이드 문서로, 초보자가 학습 자료로 활용하기 좋습니다. 이 저장소에는 자율주행 알고리즘을 구현한 Python 샘플 프로그램과 각 프로그램의 설계 문서가 모여 있습니다. 위치 추정, 매핑, 경로 계획, 경로 추종, 인지 기능을 다루며, 각 알고리즘은 애니메이션 데모를 보여 주는 실행 가능한 시뮬레이션으로 제공됩니다.
AutonomousVehicleControlBeginnersGuide은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
AutonomousVehicleControlBeginnersGuide은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
AutonomousVehicleControlBeginnersGuide은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. AutonomousVehicleControlBeginnersGuide의 마지막 커밋은 2026년 11월 6일입니다.
AutonomousVehicleControlBeginnersGuide은(는) 어디에 사용할 수 있나요?
실행 가능한 Python 예제를 통해 자율주행 알고리즘 학습. 자율주행 개념을 가르치는 강의나 교육 자료로 코드 활용. 시뮬레이션에서 위치 추정 및 경로 추종 방법을 프로토타이핑하거나 비교.
AutonomousVehicleControlBeginnersGuide는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/ShisatoYano/AutonomousVehicleControlBeginnersGuide 환경을 설정합니다(WSL의 Docker 개발 컨테이너를 사용하거나 명시된 Python 요구 사항을 설치합니다) 단위 테스트를 실행해 환경이 제대로 작동하는지 확인합니다: . run_test_suites.sh 확장 칼만 필터를 사용한 위치 추정과 같은 시뮬레이션 예제를 실행합니다: python src/simulations/localization/extended_kalman_filter_localization/extended_kalman_filter_localization.py
AutonomousVehicleControlBeginnersGuide은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ShisatoYano/AutonomousVehicleControlBeginnersGuide

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트