自社製品
AdaMachineVision
AdaMachineVision(AMV)は、Ada 2022で書いたマシンビジョンライブラリです。ブロブ解析、キャリパー、パターンの位置決めなどのツールを備え、ロジックを置いたSPARKのカーネルは実行時エラーが起きないことを証明しています。Cからも使えます。
AdaMachineVisionとは
画像、座標空間、図形と領域、そしてブロブ解析やキャリパー、パターンの探索などのビジョンツールを提供するライブラリです。
カーネルはSPARKで書き、実行時エラーが起きないことを証明しています。Cからも使え、ほかのライブラリには依存しません。
特長
ツールの共通の使い方と座標空間ツリー
どのツールもRunで実行し、実行の状態をRun_Statusから読みます。Blob、Caliper、Find Line、Find Circle、CNL Search、PMAlignは、実行のパラメーターをRun_Paramsに設定し、結果をResultsから読む形です。画像は座標空間ツリーを持ち、ルートの下に足した座標空間での位置を扱えます。
実行時エラーが起きないことを証明したカーネル
ロジックはすべてSPARKのカーネル(AMV.Kernels.*)に置いています。どのカーネルについても、実行時エラーが起きないことをgnatproveで証明しています。2026年11月12日の時点で、チェックは34,514項目あり、すべて証明済みです。pragma Assumeも、正当化で済ませたチェックもありません。証明の前提と、証明していない部分は、下の「証明の範囲と限界」に書きました。
Cからも使える
カーネルが外へ公開する関数はC互換の型を受け取り、入力をすべて検査して、失敗を例外ではなく状態値で返します。これらの関数をCの呼び出し規約で公開しているので、そのままC API(include/amv.h)として使えます。AdaのAPIはこれらの関数を呼んで、失敗の状態値を例外に変えるだけの薄い層です。
Cのプログラムは最初の関数を呼ぶ前にadainit()を、最後にadafinal()を呼び、Adaのランタイムと一緒にリンクします。2つの関数はAdaのバインダーが生成するものです。リポジトリのCの例とテストは、gprbuildでAdaのソースと一緒にビルドする構成です。
ほかのライブラリに依存しない
ビルドに要るのはGNATとgprbuildだけです。画像ファイルの読み書き(PNM、BMP)もライブラリの中に実装しています。
提供している機能
バージョン0.1.0で、実装とテストが済んでいるのは次のとおりです。
| コア | 2次元の変換、座標空間ツリー、8ビットと16ビットのグレー画像、プレーナーカラー画像、画像ファイル(PNM、BMP)、図形と領域、浮動小数点の画像演算、直線と円のフィット、ツールの枠組み |
|---|---|
| Blob | ブロブ解析。固定、相対、動的のしきい値とソフトしきい値、連結性とブロブの親子関係、各種の測定値、フィルターと並べ替え |
| Caliper | キャリパー、Find Line、Find Circle |
| Dimensioning | 22個の測定ツール、直線・円・楕円のフィット、8個の形状生成ツール |
| Image Processing | Histogram、PixelMap、SobelEdge、Sharpness、1枚の画像に対する演算(IPOneImage)、アフィン変換、領域のコピー(CopyRegion)、2枚の画像の演算(IPTwoImage)、画像の形式の変換(ImageConvert)、極座標の展開(PolarUnwrap) |
| CNL Search | 正規化相関による探索。学習用と探索用のマスク、部分的な一致 |
| PMAlign | 回転と拡大縮小があるパターンの位置決め。学習用と探索用のマスク |
| CalibFix | Fixture、N点のフィット、N点キャリブレーション、チェッカーボードによるキャリブレーション(透視と放射方向のゆがみを含むモードあり) |
| ToolGroup / ToolBlock | ツールをまとめて実行する枠組み |
PMAlignの探索は公開文献に基づくAMV独自の手法です。
バーコードの読み取りとOCRはバージョン0.1.0の対象外です。
コードの例
画像を作り、ルートの下にfixtureの座標空間を足して、画素の位置をその座標空間での位置に変換する例です。リポジトリのexamples/quick_look.adbから、冒頭のコメントを除いたものです。
with Ada.Text_IO;
with AMV;
with AMV.Image_File;
with AMV.Images;
with AMV.Misc;
with AMV.Transforms;
procedure Quick_Look is
Image : AMV.Images.Ks_Image_8_Grey :=
AMV.Images.Create (Width => 64, Height => 48, Value => 0);
X, Y : AMV.Real;
begin
Image.Set_Pixel (X => 10, Y => 20, Value => 255);
-- A fixture space under the root: its origin is at (5, 3) in the
-- root and its axes are turned by 30 degrees. Parent_From_New maps
-- fixture coordinates into the root (the parent).
Image.Coordinate_Space_Tree.Add_Space
(Parent_Space_Name => "@",
New_Space_Name => "Fixture",
Parent_From_New =>
AMV.Transforms.Create_Rigid
(Rotation => AMV.Misc.Deg_To_Rad (30.0),
Translation_X => 5.0,
Translation_Y => 3.0));
Image.Set_Selected_Space_Name ("@\Fixture");
-- Where is the centre of pixel (10, 20) in the selected space?
Image.Get_Transform (".", "#").Map_Point (10.0, 20.0, X, Y);
Ada.Text_IO.Put_Line
("pixel (10, 20) is at" & X'Image & "," & Y'Image & " in "
& Image.Selected_Space_Name);
AMV.Image_File.Write_Image ("quick_look.pgm", Image);
Ada.Text_IO.Put_Line ("wrote quick_look.pgm");
end Quick_Look;
画素(10, 20)の中心はfixtureの座標でおよそ(12.83, 12.22)にあります。リポジトリのexamplesには、ワッシャーの穴を数えて良否を判定するブロブ解析の例と、PMAlignで部品の位置を求めてからキャリパーで寸法を測る例もあります。ブロブ解析の例にはC APIを使ったものも入れました。
証明の範囲と限界
証明の対象と限界は、docs/PROOF.mdに書いています。要点は次のとおりです。
- カーネルは実行時エラーが起きないことを証明しています。同じ文書に挙げた性質については機能的な正しさも証明しています。
- 証明は、浮動小数点の値が有限であることを前提にしています。NaNと無限大はカーネルの入力の検査で弾き、失敗の状態値を返します。弾けることは証明ではなくテストで確かめています。
- 薄いAdaのAPI、画素を共有するための参照カウント、メモリの確保やCのメモリとのコピーを行う小さな補助などは、証明していません。
- 浮動小数点の結果については決めた範囲に収まることと、オーバーフローしないことを証明しています。精度はテストで確かめています。
- 検出や計測の精度も証明の対象ではありません。合成画像のテストと、公開されている実画像を使ったテストで確かめています。バージョン0.1.0の
make testはAdaで26,487項目、Cで914項目を検査します。 - Cから渡されるポインターとハンドルが有効であること、結果を受け取るポインターがほかの引数と重ならないことについては、呼び出し側を信頼しています。
入手とビルド
ソースはGitHubのリポジトリにあります。ビルドに要るものは次のとおりです。
- GNAT 16.1とgprbuild 26(GNAT 14でもAdaのビルドとテストは通ります)
- 証明をやり直す場合は、gnatprove 16.1
リポジトリのCIはUbuntu 24.04でビルド、テスト、証明を実行しています。WindowsでのビルドはCIでは確かめていません。
make buildで静的ライブラリ(build/lib/libamv.a)ができます。make testでAdaのテストとC APIのテストを、make proveでカーネルの証明を実行します。
バージョン
CHANGELOG.mdに記録している最初のバージョンは0.1.0(2026年11月12日)です。リポジトリのmainには、その後の変更(CHANGELOGのUnreleased)が入っています。C APIのABIのバージョンは、0.1.0が2、mainが3です。
1.0.0より前なので、マイナーバージョンの更新で互換性が変わることがあります。C APIの互換性が変わるときは、ABIのバージョン(ks_abi_version)を上げ、CHANGELOGに記録します。
ライセンス
AMVはデュアルライセンスです。どちらが当てはまるかは、利用の目的で決まります。
| 非商用の利用 | 無償です。PolyForm Noncommercial License 1.0.0が当てはまります。商用化を見込まない個人の学習、趣味の制作、研究や、教育機関、公的な研究機関、慈善団体、政府機関による利用が当たります。 |
|---|---|
| 商用の利用 | 有償の商用ライセンスが要ります。AMVを組み込んだ製品やサービスを販売する場合や、企業が自社の生産ラインや検査ラインで動かす場合などです。費用はお問い合わせください。 |
どちらに当たるか分からないときも、お問い合わせからお尋ねください。詳しい条件はリポジトリのLICENSING.ja.mdとLICENSE.mdにあります。
ソースは公開していますが、無償のライセンスが商用利用を除くので、「オープンソースの定義」でいうオープンソースではありません。無償のライセンスは、法律が許す範囲で、ソフトウェアを現状のまま無保証で提供すると定めています。
著作権表示は「Copyright (c) 2026 Go Komura」です。著作権者のGo Komura(小村 豪)は小村ソフトの代表で、商用ライセンスのお問い合わせは小村ソフトが受け付けています。
導入のご相談
商用ライセンスのほか、次のようなご相談を受けています。
- AMVで自社の検査や計測の処理を組めるかを確かめたい
- AMVを使った検査や計測の処理をC#やC++のアプリから呼びたい
- カメラの画像取得、装置との連携、結果の保存まで含めたアプリを作りたい
アプリケーションの開発はマシンビジョン・画像処理Windowsソフトウェア開発としてお受けしています。
よくある質問
- AdaMachineVisionは無償で使えますか?
- 非商用の利用であれば、PolyForm Noncommercial License 1.0.0のもとで無償で使えます。商用化を見込まない個人の学習、趣味の制作、研究や、教育機関、公的な研究機関などによる利用が当たります。製品やサービスへの組み込み、企業の生産ラインや検査ラインでの利用など、それ以外の利用には有償の商用ライセンスが要ります。
- CやC#から使えますか?
- Cからは使えます。ロジックを置いたカーネルの関数をCの呼び出し規約で公開しており、include/amv.hがそのC APIです。失敗は例外ではなく状態値で返ります。Cのプログラムは最初にadainit()を、最後にadafinal()を呼び、Adaのランタイムと一緒にリンクします。ライブラリは静的ライブラリとしてビルドされ、C#向けのラッパーは同梱していません。C#から使うには、C APIを共有ライブラリにまとめてP/Invokeで呼ぶ作業が要ります。
- 証明しているのは何ですか?
- SPARKで書いたカーネルについて、実行時エラー(範囲外アクセス、オーバーフロー、0による除算など)が起きないことをgnatproveで証明しています。リポジトリのdocs/PROOF.mdに挙げた性質については、機能的な正しさも証明しています。証明は浮動小数点の値が有限であることを前提にしていて、NaNと無限大は検査で弾きます。浮動小数点の計算の精度と、検出や計測の精度は証明の対象ではなく、テストで確かめています。
- バーコードの読み取りやOCRはできますか?
- バージョン0.1.0には入っていません。バーコードの読み取りとOCRは対象外です。
ご相談はこちら
このページの内容に近い課題があれば、現状と必要な支援の形を添えてご相談ください。