Repolode
OpenStitching

OpenStitching/stitching

OpenCV의 stitching 모듈을 기반으로 겹치는 사진에서 파노라마를 빠르고 안정적으로 만드는 Python 패키지입니다.

스타
2,641
포크
218
열린 이슈
7
마지막 커밋
5일 전

어떤 프로젝트인가요?

stitching은 겹치는 이미지를 하나의 파노라마로 합치는 Python 패키지입니다. OpenCV의 stitching 모듈을 기반으로 하며 OpenCV의 stitching_detailed.py 예제 흐름을 따르기 때문에, 특징 검출·매칭·카메라 추정·블렌딩으로 이어지는 파이프라인을 숨기지 않고 직접 확인할 수 있습니다.

이 패키지는 세 가지 방식으로 사용할 수 있습니다. 파일 경로나 와일드카드를 받는 `stitch` 명령줄 도구, Python을 설치하지 않은 환경을 위한 Docker 이미지, 그리고 특징 검출기나 신뢰도 임계값 같은 설정을 받는 Python `Stitcher` 클래스입니다. 아핀 움직임이 있는 경우에는 `AffineStitcher` 변형을 사용할 수 있으며, verbose 모드에서는 중간 결과를 저장해 스티칭이 잘못된 지점을 확인할 수 있습니다.

디스플레이가 없는 서버 및 컨테이너 환경을 위해 별도의 헤드리스 빌드인 `stitching-headless`도 제공됩니다. 함께 제공되는 튜토리얼 노트북에서는 스티칭 결과를 분석할 수 있도록 RANSAC 매치와 시임 선을 보여 줍니다.

핵심 기능

  • 01OpenCV의 stitching 파이프라인을 사용해 겹치는 이미지로 파노라마를 만듭니다.
  • 02파일 목록이나 와일드카드를 받는 `stitch` 명령줄 도구를 제공합니다.
  • 03검출기와 신뢰도 임계값을 설정할 수 있는 Python `Stitcher` 클래스를 제공합니다.
  • 04아핀 움직임을 처리하는 `AffineStitcher`를 포함합니다.
  • 05verbose 모드에서 중간 결과를 저장해 문제를 진단할 수 있습니다.
  • 06서버와 Docker 컨테이너용 헤드리스 변형을 제공합니다.

활용 사례

  • 스크립트나 파이프라인에서 겹치는 사진을 일괄 처리해 파노라마를 만듭니다.
  • 건축 도면 같은 스캔하거나 촬영한 조각 이미지를 스티칭합니다.
  • 서버의 Docker 컨테이너에서 파노라마 생성을 실행합니다.

빠른 시작

  1. 1

    pip으로 PyPI에서 패키지를 설치합니다

    pip install stitching
  2. 2

    CLI로 현재 디렉터리에 있는 모든 JPG 파일을 스티칭합니다

    stitch *.jpg

사용 전 알아둘 점

  • 이미지 스티칭에는 OpenCV의 stitching 모듈이 필요하며, 이로 인해 의존성이 크게 늘어납니다.

포함된 컬렉션

토픽

#computer-vision#image-stitching#panorama#opencv#python#opencv-python

자주 묻는 질문

stitching은(는) 무엇인가요?
OpenCV의 stitching 모듈을 기반으로 겹치는 사진에서 파노라마를 빠르고 안정적으로 만드는 Python 패키지입니다. stitching은 겹치는 이미지를 하나의 파노라마로 합치는 Python 패키지입니다. OpenCV의 stitching 모듈을 기반으로 하며 OpenCV의 stitching_detailed.py 예제 흐름을 따르기 때문에, 특징 검출·매칭·카메라 추정·블렌딩으로 이어지는 파이프라인을 숨기지 않고 직접 확인할 수 있습니다.
stitching은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
stitching은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
stitching은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. stitching의 마지막 커밋은 2026년 11월 2일입니다.
stitching은(는) 어디에 사용할 수 있나요?
스크립트나 파이프라인에서 겹치는 사진을 일괄 처리해 파노라마를 만듭니다. 건축 도면 같은 스캔하거나 촬영한 조각 이미지를 스티칭합니다. 서버의 Docker 컨테이너에서 파노라마 생성을 실행합니다.
stitching는 어떻게 설치하나요?
pip으로 PyPI에서 패키지를 설치합니다: pip install stitching CLI로 현재 디렉터리에 있는 모든 JPG 파일을 스티칭합니다: stitch *.jpg
stitching은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/OpenStitching/stitching

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

관련 프로젝트