より良い OCR のために C#35 のフィルター ウィザードを使用する方法

IronOCRフィルターウィザードは自動的に最適なOCR設定を見つけるために画像上ですべての前処理フィルターの組み合わせをテストし、最高の信頼スコアと結果を再現するために必要な正確なC#コードの両方を返します。

OCRのための画像の前処理は困難です。 複数のフィルターを使用することで、認識を向上させることができますが、適切な組み合わせを見つけるには、広範な試行錯誤が必要です。 画像にはそれぞれ独自の課題があり、手作業によるテストには時間がかかります。 これは、低画質のスキャン画像や、ノイズや歪みのレベルがさまざまな画像を扱う場合に特に当てはまります。

IronOCRのOcrInputFilterWizardはこの問題を解決します。 フィルタウィザードは、フィルタの組み合わせを自動的に評価し、OCRの信頼性と精度を最大化します。 最適な設定を徹底的にテストし、最適なフィルタの組み合わせをコード・スニペットとして返すので、結果を簡単に再現できます。 この機能は、OcrInputクラスとシームレスに統合され、画像へのフィルタ適用を簡素化します。

このガイドでは、フィルタウィザードがどのように動作するかを示し、それが使用するコードスニペットとパラメータを紹介します。 その他の OCR ワークフローの最適化については、画質補正に関するガイドをご覧ください。

クイックスタート: 理想的な画像フィルターチェーンを自動的に検出する

IronOCRのフィルターウィザードを使用して、すべての前処理フィルターの組み合わせをテストし、最適なコードスニペットを入手してください。 1行で最高信頼度スコアと、類似画像に対する正確なC#フィルターチェーンを返します。

```cs :title=Get Best OCR Filters Instantly 文字列 code = OcrInputFilterWizard.Run("image.png", out double confidence, new IronTesseract())；

<div class="hsg-featured-snippet">
    <h3>最小限のワークフロー（5ステップ）</h3>
    <ol>
        <li>フィルターウィザードを使用するには、C# ライブラリをダウンロードしてください。</li>
        <li>IronTesseractエンジンをインスタンス化する</li>
        <li>入力画像を<code>OcrInputFilterWizard</code>に読み込みます</li>
        <li>フィルタウィザード<code>Run</code> 、信頼度などの出力を確認します。</li>
        <li>与えられたコードを利用して入力画像に適用し、結果を確認します。</li>
    </ol>
</div>

## フィルター ウィザードはどのように機能しますか?

`OcrInputFilterWizard.Run`メソッドは3つのパラメータを取ります：入力画像、結果の信頼度を表すoutパラメータ、そしてTesseract Engineインスタンスです。 高度なエンジン制御については、[Tesseract詳細設定](https://ironsoftware.com/csharp/ocr/examples/csharp-configure-setup-tesseract/)のガイドをご覧ください。

最高の信頼スコアを達成するために、前処理フィルタの複数の組み合わせをテストします。 最高信頼度スコアは、入力画像に適用するフィルタセットを決定します。 このアプローチは、[画像の向き補正](https://ironsoftware.com/csharp/ocr/how-to/image-orientation-correction/)やその他の複雑な前処理ステップを必要とする難しい画像に効果的に作用します。

フィルターウィザードには、プリセットや組み合わせの制限はありません。 また、包括的なフィルターテストにより、最高の信頼スコアを達成することに重点を置いています。 処理中のリアルタイムのフィードバックのために、[ウィザードの操作を監視する進捗追跡](https://ironsoftware.com/csharp/ocr/how-to/progress-tracking/)を実装してください。

組み合わせテストで利用可能なフィルタ：

- `input.Contrast()` - テキストを明瞭にするためにコントラストを調整します。
- `input.Sharpen()` - エッジの定義を強化します。
- `input.Binarize()` - 白黒に変換します。
- `input.ToGrayScale()` - 色情報を削除します。
- `input.Invert()` - 色を反転します。
- `input.Deskew()` - 斜めのテキストを修正します。
- `input.Scale(...)` - 最適な寸法にリサイズします。
- `input.Denoise()` - ピクセルノイズを除去します。
- `input.DeepCleanBackgroundNoise()`-高度なノイズ除去
- `input.EnhanceResolution()` - 低画質の解像度を改善します。
- `input.Dilate()`、`input.Erode()` - テキストの絞り込み操作

フィルタの詳細については、[画像フィルタに関するチュートリアル](https://ironsoftware.com/csharp/ocr/tutorials/c-sharp-ocr-image-filters/)を参照してください。 その他の前処理テクニックは、[画像補正フィルター](https://ironsoftware.com/csharp/ocr/how-to/image-correction-filters/)ガイドにあります。

この徹底的なテスト方法には、処理時間が必要です。大規模な処理には、[マルチスレッド サポート](https://ironsoftware.com/csharp/ocr/how-to/async/)を使用して、複数の画像を同時に処理します。

### テストにはどのような画像を使用すればよいですか?

この例では、フィルターウィザードの機能を示すために、人工ノイズの多いスクリーンショットを使用しています。 フィルタ ウィザードは、[スキャンしたドキュメント](https://ironsoftware.com/csharp/ocr/how-to/read-scanned-document/)から[テキスト付き写真](https://ironsoftware.com/csharp/ocr/how-to/read-photo/)まで、さまざまな画像タイプを効果的に処理します。

<div class="content-img-align-center">
    <div class="center-image-wrapper" style="width=50%">
         <img src="/static-assets/ocr/how-to/filter-wizard/filter-wizard-sample.webp" alt="フィルターウィザードのデモンストレーションのために劣化したテキストを示すノイズパターンで重く破損したテスト画像" class="img-responsive add-shadow">.
    </div>
</div>

テスト画像を選択する際には、以下の要素を考慮してください：
- **画像解像度**：通常、DPIが高い画像ほど良い結果が得られます。 最適化のヒントについては、[DPI設定](https://ironsoftware.com/csharp/ocr/how-to/dpi-setting/)に関するガイドを参照してください。
- **ドキュメントタイプ**：異なるドキュメントタイプは、特定のフィルタの組み合わせから恩恵を受けます。 [アイデンティティ文書](https://ironsoftware.com/csharp/ocr/troubleshooting/identity-documents/)は、標準的なテキスト文書とは異なる前処理が必要な場合があります。
- **ソースの品質**: フィルターウィザードは問題のある画像を得意としますが、可能な限り利用可能な最高品質のソースから始めます。

### 自分のコードでフィルタ ウィザードを実行するにはどうすればよいですか?

```csharp
:path=/static-assets/ocr/content-code-examples/how-to/filter-wizard-process.cs

フィルタウィザードは、さまざまな入力形式を処理します。 サポートされているフォーマットについては、入力画像に関するガイドを参照してください。 PDFファイルを処理したり、動的な画像ソースのストリームを直接操作することもできます。

バッチ処理のシナリオについては、次の例を参考にしてください：

/* :path=/static-assets/ocr/content-code-examples/how-to/filter-wizard-batch.cs */
using IronOcr;
using System;
using System.IO;

// Process multiple similar images
var ocr = new IronTesseract();
string[] imageFiles = Directory.GetFiles(@"C:\Images", "*.png");

// Run Filter Wizard on first image to discover optimal settings
string optimalCode = OcrInputFilterWizard.Run(imageFiles[0], out double baselineConfidence, ocr);
Console.WriteLine($"Baseline confidence: {baselineConfidence:P2}");
Console.WriteLine($"Optimal filter sequence discovered");

// Apply discovered filters to all images
foreach (string imagePath in imageFiles)
{
    using (var input = new OcrImageInput(imagePath))
    {
        // Apply the filter sequence discovered by the wizard
        // The actual filters would be applied here based on the wizard output
        var result = ocr.Read(input);
        Console.WriteLine($"Processed: {Path.GetFileName(imagePath)} - Confidence: {result.Confidence:P2}");
    }
}

/* :path=/static-assets/ocr/content-code-examples/how-to/filter-wizard-batch.cs */
using IronOcr;
using System;
using System.IO;

// Process multiple similar images
var ocr = new IronTesseract();
string[] imageFiles = Directory.GetFiles(@"C:\Images", "*.png");

// Run Filter Wizard on first image to discover optimal settings
string optimalCode = OcrInputFilterWizard.Run(imageFiles[0], out double baselineConfidence, ocr);
Console.WriteLine($"Baseline confidence: {baselineConfidence:P2}");
Console.WriteLine($"Optimal filter sequence discovered");

// Apply discovered filters to all images
foreach (string imagePath in imageFiles)
{
    using (var input = new OcrImageInput(imagePath))
    {
        // Apply the filter sequence discovered by the wizard
        // The actual filters would be applied here based on the wizard output
        var result = ocr.Read(input);
        Console.WriteLine($"Processed: {Path.GetFileName(imagePath)} - Confidence: {result.Confidence:P2}");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

フィルタウィザードはどのような結果を返しますか?

.

フィルターウィザードの出力は、この特定の画像に対して達成可能な最良の結果として65%の信頼度を示しています。 信頼度スコアは、OCRの精度を評価するための重要な指標です。 結果の信頼性については、専用ガイドをご覧ください。

入力画像には極端な歪みと人工的なノイズが含まれています。これは、困難なシナリオにおけるフィルタウィザードの機能を示しています。 本番用には、可能な限り高品質のソース画像から始めてください。

生成されたコード・スニペットは以下を提供します：

• 正確なフィルタシーケンス: 最適な結果を得るためには、操作の順序が重要です。
• メソッドチェイニング：実装が簡単な、クリーンで読みやすいコード
• 推測するパラメータはありません: 各フィルタは最高のパフォーマンスを発揮するように設定されています。

推奨されるフィルタの組み合わせを適用するにはどうすればよいですか?

フィルタウィザードを実行した後、提供されたコードスニペット設定を入力画像に適用して、結果と信頼性を確認してください。 これにより、文書処理パイプラインの類似画像間で再現可能な結果が保証されます。

どのように推奨コードを実装しますか?

:path=/static-assets/ocr/content-code-examples/how-to/filter-wizard-best-combination.cs

using IronOcr;
using System;

// Initialize the Tesseract engine
var ocrTesseract = new IronTesseract();

// Load the image into an OcrInput object
using (var input = new OcrImageInput("noise.png"))
{
    // Apply the exact filter chain recommended by the Wizard's output
    input.Invert();
    input.DeNoise();
    input.Contrast();
    input.AdaptiveThreshold();

    // Run OCR on the pre-processed image
    OcrResult result = ocrTesseract.Read(input);

    // Print the final result and confidence
    Console.WriteLine($"Result: {result.Text}");
    Console.WriteLine($"Confidence: {result.Confidence}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

フィルターアプリケーションの順序は非常に重要です。 フィルタウィザードは、使用するフィルタとその最適な順序の両方を決定します。 このインテリジェントな順序付けにより、フィルタウィザードは複雑な前処理シナリオで威力を発揮します。

OCRプロセスの制御を強化するために、エラー処理と検証の実装を検討してください：

/* :path=/static-assets/ocr/content-code-examples/how-to/filter-wizard-validation.cs */
using IronOcr;
using System;

var ocrEngine = new IronTesseract();

try
{
    using (var input = new OcrImageInput(@"C:\Images\document.png"))
    {
        // Apply Filter Wizard recommended sequence
        input.Invert();
        input.DeNoise();
        input.Contrast();
        input.AdaptiveThreshold();

        // Configure additional OCR settings
        ocrEngine.Configuration.ReadBarCodes = false;
        ocrEngine.Configuration.RenderSearchablePdf = true;

        // Perform OCR with timeout protection
        var result = ocrEngine.Read(input);

        // Validate results
        if (result.Confidence >= 0.6)
        {
            Console.WriteLine("OCR successful with high confidence");
            // Process the extracted text
        }
        else
        {
            Console.WriteLine("Low confidence result - consider manual review");
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR processing error: {ex.Message}");
}

/* :path=/static-assets/ocr/content-code-examples/how-to/filter-wizard-validation.cs */
using IronOcr;
using System;

var ocrEngine = new IronTesseract();

try
{
    using (var input = new OcrImageInput(@"C:\Images\document.png"))
    {
        // Apply Filter Wizard recommended sequence
        input.Invert();
        input.DeNoise();
        input.Contrast();
        input.AdaptiveThreshold();

        // Configure additional OCR settings
        ocrEngine.Configuration.ReadBarCodes = false;
        ocrEngine.Configuration.RenderSearchablePdf = true;

        // Perform OCR with timeout protection
        var result = ocrEngine.Read(input);

        // Validate results
        if (result.Confidence >= 0.6)
        {
            Console.WriteLine("OCR successful with high confidence");
            // Process the extracted text
        }
        else
        {
            Console.WriteLine("Low confidence result - consider manual review");
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR processing error: {ex.Message}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

フィルターを適用した後の最終的なOCR結果はどうなりますか?

IronOCRは大きく歪んだ状態でもほとんどのテキストを抽出します。 信頼度は、フィルタウィザードのレポートと一致します。 OCR結果の詳細な処理については、データ出力に関するガイドを参照してください。