autocad-image-redraw

AutoCAD 画像の再作図

画像を、監査可能な CAD 図面として再構築します。画像は証拠として扱い、正解そのものとはみなしません。信頼できるソース DWG がある場合は、代わりに autocad-dwg-redraw を使用してください。

必ず守るルール

1. ピクセルの類似性だけを根拠に、物理的な正確さを主張しないでください。
2. ジオメトリは次の順序で確定してください。明示的なユーザー要件、読み取れる寸法、導出した制約、較正済みの画像計測、明確にラベル付けした視覚的推定。
3. 重要な値はすべて known、scaled、inferred、unreadable のいずれかとして記録してください。
4. 透視やビューごとの縮尺の違いがある場合は、各ビューまたは領域を個別に較正してください。
5. 矛盾する寸法を黙って選ばないでください。矛盾を記録し、needs_review または blocked を返してください。
6. 元画像、仕様、レポート、プレビュー、ハッシュを保持し、結果を再現できるようにしてください。

プロファイルの選択

• strict-dimensioned：エンジニアリング成果物向けです。読み取れる単位と、ジオメトリを拘束するのに十分な既知または較正済みの基準点が必要です。
• general：図面、スケッチ、スクリーンショット、品質が混在する参照画像向けの、バランスの取れた既定プロファイルです。
• hybrid：利用可能な箇所では寸法を使い、それ以外は較正済みの比率を使用します。推定したジオメトリにはラベルを付けてください。
• visual-trace：実寸を主張せず、目に見える線画を再現します。
• geometry-only：オブジェクトのジオメトリと有用な作図レイヤーを保持し、寸法、引出線、注記、表のテキストは省略します。

ソースに単位または縮尺の基準点がない場合は、visual-trace を選択するか、unitless を使用してください。図面が技術図面のように見えるという理由だけで、ミリメートルを既定値にしないでください。

実行要件

DWG の生成と検査には、AutoCAD と pywin32 を使用する Windows 環境が必要です。事前チェックと比較には Pillow、NumPy、OpenCV が必要です。DXF プレビューには ezdxf と PyMuPDF が必要です。

python -m pip install pywin32 pillow numpy opencv-python ezdxf pymupdf

エンドツーエンドのワークフロー

1. ソースを保持して事前チェックする

ソースをプロジェクトにコピーし、ハッシュを計算して、内容を解釈する前に読み取りやすさを確認します。

python scripts\preflight_image_redraw.py --image input.jpg --mode general --output reports\input-preflight.json

回転、切り抜き、解像度、コントラスト、ぼやけ、透視、遮蔽、目視できる単位、利用可能な縮尺の基準点を確認します。品質に関する警告が、直ちに作業を妨げるとは限りません。選択したプロファイルが、画像から得られない証拠を要求する場合に、作業の妨げになります。

2. 意味情報を含む再作図仕様を作成する

references/image-redraw-spec.md を使用してください。安定したエンティティ ID を作成し、各ビューを特定して、較正の基準点と証拠を記録し、生のピクセル座標に頼るのではなく制約を記述してください。

ソースと CAD の座標系は分けてください。

• ソース座標：画像のピクセル。原点は左上。
• CAD 座標：図面単位。監査しやすい位置に原点を設定。
• 較正：ソース座標と CAD 座標を結び付ける、ビュー固有のアフィン変換、ホモグラフィ、または寸法ベースの関係。

3. 作図前に仕様を検証する

python scripts\validate_image_redraw_spec.py --spec redraw-spec.json --profile general --report reports\spec-validation.json

エラー、実現不可能なジオメトリ、ID の重複、必須フィールドの欠落、無効な単位、制約の失敗を解決してください。strict-dimensioned では、単位または較正の証拠が不足している場合、作図をブロックする必要があります。

4. AutoCAD で作図する

python scripts\draw_image_spec.py --spec redraw-spec.json --output outputs\redraw.dwg

中国語のテキストには、次を使用してください。

python scripts\draw_image_spec.py --spec redraw-spec.json --output outputs\redraw.dwg --text-style CN_TEXT --text-font "C:\Windows\Fonts\simhei.ttf"

ジオメトリのみを出力する場合：

python scripts\draw_image_spec.py --spec redraw-spec.json --output outputs\redraw-geometry.dwg --geometry-only

複数の AutoCAD インスタンスやスタートページが COM の動作を妨げる場合は、読み取り可能な DWG とともに --attach-document を使用してください。AutoCAD に接続する前に --dry-run を実行してください。

AutoCAD を使わず、オープンソースのツールで大まかな視覚トレースを行うには、image_to_dxf_open_source.py を使用してください。ベクター PDF には、ラスター画像をトレースする前に pdf_vector_to_dxf.py を使用してください。どちらの方法でも、不確かなピクセルが信頼できる寸法に変換されるわけではありません。

5. CAD の出力を検査する

python scripts\inspect_dwg_output.py --dwg outputs\redraw.dwg --report reports\dwg-inspection.json

ファイルが開けること、ModelSpace が空でないこと、単位が仕様と一致すること、想定されるレイヤーとエンティティクラスが存在すること、ジオメトリのみのモードでは禁止された注釈クラスが含まれないことを確認してください。AutoCAD から監査可能な DXF を書き出し、監査とレンダリングを行います。

python scripts\render_dxf_preview.py --dxf outputs\redraw.dxf --png reports\cad-preview.png --pdf reports\cad-preview.pdf

6. ソースと比較する

ソース画像とCADプレビューの対応する点を含むアンカーJSONを作成し、次を実行します。

python scripts\compare_redraw.py --source input.jpg --cad-preview reports\cad-preview.png --anchors anchors.json --output-dir reports\comparison

並べて表示した画像、位置合わせ済みのオーバーレイ、差分表示、エッジのカバー率、エッジ距離の統計を確認します。比較結果を使って、欠落した壁、位置のずれた穴、誤った円弧、テキストの重なり、ビューのレイアウトエラーを特定します。物理的な寸法の検証には使用しないでください。

7. 反復して、判定を出す

最も影響の大きい問題を修正し、再生成して、検証を再実行します。最後に次のいずれかのステータスを設定します。

• pass：選択したプロファイルを使用し、必須のチェックにすべて合格しました。
• pass_with_warnings：重要度の低い不確実性が記録されており、成果物は使用可能です。
• needs_review：人による判断が必要です。通常は、証拠が矛盾している場合や推定に基づいている場合です。
• blocked：必須のソース証拠がありません。
• fail：出力が破損しているか、必須のチェックに違反しています。

納品物の契約

該当するものを納品します。

• 編集可能なDWGおよび監査用DXF
• 再作図仕様JSONおよび較正／アンカーJSON
• 入力の事前チェック、仕様の検証、DWGの検査レポート
• 固定ページのPNG／PDFプレビュー
• 並べて表示した画像、オーバーレイ、差分画像、メトリクスJSON
• ソース／出力ハッシュ、選択したプロファイル、単位、前提条件、警告、最終ステータスを含むマニフェスト

参照資料とスクリプト

• references/image-redraw-spec.md：一般化された仕様、証拠、ビュー、較正、制約、エンティティ。
• references/image-redraw-validation.md：受け入れポリシー、チェック、メトリクス、ステータス、レポートの契約。
• scripts/preflight_image_redraw.py：ソース画像の品質と証拠のゲート。
• scripts/validate_image_redraw_spec.py：仕様のセマンティクスと制約の検証。
• scripts/draw_image_spec.py：JSONからDWGへのAutoCADレンダラー。
• scripts/inspect_dwg_output.py：AutoCAD COMを介した読み取り専用のDWG構造検査。
• scripts/render_dxf_preview.py：DXF監査と、決定論的な固定ページプレビュー。
• scripts/compare_redraw.py：位置合わせによるビジュアル比較とエッジメトリクス。
• scripts/image_to_dxf_open_source.py：大まかなラスタからDXFへのベースライン。
• scripts/pdf_vector_to_dxf.py：ベクターPDFの抽出経路。