Image-Processing-Node-Editor

[Japanese/English]

[!IMPORTANT] 本リポジトリは今後積極的にメンテナンスされません。
開発および主要機能は Multimodal-Node-Editor に統合・引き継がれています。
https://github.com/Kazuhito00/Multimodal-Node-Editor

Image-Processing-Node-Editor

ノードエディターベースの画像処理アプリです。 処理の検証や比較検討での用途を想定しています。

Note

ノードは作成者(高橋)が必要になった順に追加しているため、 画像処理における基本的な処理を担うノードが不足していることがあります。

opencv-python   4.5.5.64 or later
onnxruntime-gpu 1.12.0   or later
dearpygui       1.11.0   or later
mediapipe       0.8.10   or later ※mediapipeノード実行に必要
protobuf        3.20.0   or later ※mediapipeノード実行に必要
filterpy        1.4.5    or later ※motpyノード実行に必要

Installation

以下の何れかの方法で環境を準備してください。

• スクリプトを直接実行
  1. リポジトリをクローンgit clone https://github.com/Kazuhito00/Image-Processing-Node-Editor
  2. パッケージをインストール pip install -r requirements.txt
  3. 「main.py」を実行python main.py
• Dockerを利用
  1. Image-Processing-Node-Editor/docker/nvidia-gpu を参照
• 実行ファイルを利用(Windowsのみ)
  1. ipn-editor_win_x86_64.zipをダウンロード
  2. 「main.exe」を実行
• pipインストールを利用※インストールされるディレクトリ名が「node」「node_editor」となってしまうため修正予定→pip利用時はvenv等の仮想環境でのインストールを強く推奨
  1. ビルドツールをインストールWindows：https://visualstudio.microsoft.com/ja/visual-cpp-build-tools/Ubuntu：sudo apt-get install build-essential libssl-dev libffi-dev python3-dev
  2. Numpy、Cython、wheelをインストールpip install Cython numpy wheel
  3. GitHubリポジトリを指定し、pipインストールpip install git+https://github.com/Kazuhito00/Image-Processing-Node-Editor
  4. 以下コマンドでアプリケーションを起動ipn-editor

Usage

アプリの起動方法は以下です。

python main.py

• --setting ノードサイズやVideoWriterの設定が記載された設定ファイルパスの指定 デフォルト：node_editor/setting/setting.json
• --unuse_async_draw 非同期描画を使用しない→GUIイベントループとノードの更新処理を直列に実施※ノード異常終了時などの原因調査用 デフォルト：指定なし

Create Node

メニューから作成したいノードを選びクリック

Connect Node

出力端子をドラッグして入力端子に接続 端子に設定された型同士のみ接続可能

Delete Node

削除したいノードを選択した状態で「Del」キー

Export

メニューから「Export」を押し、ノード設定(jsonファイル)を保存

Import

Exportで出力したノード設定(jsonファイル)を読み込む

Node

ドロップダウンリストでモデルを指定し、CPU/GPUチェックボックスで推論時のデバイスを変更可能 ※モデルがGPU推論に対応していない場合はGPUにチェックを入れてもCPU推論 ノードが使用するモデルのライセンスは「node/deep_learning_node/XXXXXXXX/」の各ディレクトリを参照

今後大きく仕様を変更する可能性のあるノード

Node(Another repository)

他リポジトリで公開しているノードです。 Image-Processing-Node-Editor で使用するには、各リポジトリのインストール方法に従ってください。

Json2Deom

Image-Processing-Node-Editor の Export(json) から OpenCVのデモコードを生成する試験的なツールです。 https://github.com/Kazuhito00/ipne-json2demo

ToDo

• RGB Histgramノードのグラフ部分が常に最前面に表示される問題の調査
• 複数ノードを接続したノードを削除した際に接続線が残る問題の調査
• Import機能がノード追加前にしか利用できない挙動の修正

Author

高橋かずひと(https://twitter.com/KzhtTkhs)

License

Image-Processing-Node-Editor is under Apache-2.0 license. Image-Processing-Node-Editorのソースコード自体はApache-2.0 licenseですが、 各アルゴリズムのソースコードは、それぞれのライセンスに従います。 詳細は各ディレクトリ同梱のLICENSEファイルをご確認ください。

License(Image)

サンプルで表示している画像はフリー素材ぱくたそ様、NHKクリエイティブ・ライブラリー様からお借りしています。