Repolode
OpenStitching

OpenStitching/stitching

OpenCVのstitchingモジュールをベースに、重なり合う写真からパノラマを高速かつ堅牢に生成するPythonパッケージです。

スター
2,641
フォーク
218
未解決の Issue
7
最終コミット
4 日前

これは何?

stitchingは、重なり合う画像を1枚のパノラマに合成するPythonパッケージです。OpenCVのstitchingモジュールをベースに、OpenCVのサンプル`stitching_detailed.py`の処理フローに沿っているため、特徴点の検出、マッチング、カメラ推定、ブレンディングの各工程を確認できます。

利用方法は3通りあります。ファイルパスやワイルドカードを指定できるコマンドラインツールの`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は、重なり合う画像を1枚のパノラマに合成する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 の数値は毎日更新されます。

関連プロジェクト