小学生時代の僕へ、「OCRで【いつもの作業】やっておいたよ！」

# はじめに
***皆さん苦手な食べ物はありますでしょうか？***
私にはいくつか苦手な食べ物がありますが、その中でも***「豆全般」苦手***です。

え？豆？なんで？ってよく言われますが、正直なんでかはよくわかりません。
細胞が拒否している（アレルギーではありません）のかなと思います。
（こしあん、味噌、醤油OK/つぶあん、豆腐NG）

前置きはさておき、私は小学生の頃毎月配布される給食の献立表をもらったらすぐに、***豆が書かれている箇所すべてにマーカーを引いていました(笑)***。

献立表にマーカーを引くメリットは以下の通りです。

- 前もって豆が出てくるとわかるため心の準備ができる
- その日の給食までに、友人に食べてほしいとお願いできる

とはいえ、毎月献立表のすべての豆にマーカーを引くのは非常に大変です。
そこで、今回はどうにか「小学生の頃の僕」を楽にしてあげたいと思います。

# 調べてみた
じゃあ実際にどうやるのか？と考え調べてみたところなにやら***「OCR」***という技術がよさげな感じがした。

### OCRとは？
> OCRは、Optical Character Reader（またはRecognition）の略で、画像データのテキスト部分を認識し、文字データに変換する光学文字認識機能のことを言います。具体的にいうと、紙文書をスキャナーで読み込み、書かれている文字を認識してデジタル化する技術です。
参考：[業務効率ツールとして注目！「OCR」とは](https://www.ricoh.co.jp/service/cloud-ocr/column/ocr/)

OCRを使って、献立表を認識し、文字データに変換しNGワード（まめ等）をハイライトすればよさそう。
もっとスマートなやり方はあるとは思いますが、~~思い浮かばなかった~~OCRを使ってみたいのでこの方法でやっていきます。

「OCR プログラミング」と調べてみると***「Tesseract」***というワードがちらほら確認できました。Tesseractは、オープンソースのOCRエンジンである。
追加で調べてみると、TesseractをJavaScriptに移植した***Tesseract.js***があるらしいので今回はこれを使ってみることにします。

参考：[テキスト認識エンジン「Tesseract」をJavaScriptに移植した「Tesseract.js」](https://mag.osdn.jp/16/10/26/160000#:~:text=Tesseract.js%E3%81%AF%E3%80%81%E7%B1%B3HP,JavaScript%E3%81%AB%E7%A7%BB%E6%A4%8D%E3%81%97%E3%81%9F%E3%82%82%E3%81%AE%E3%80%82&text=Web%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6%E5%86%85%E3%81%A7%E3%82%82%E5%8B%95%E3%81%8F,%E3%81%A7%E5%8B%95%E3%81%8B%E3%81%99%E3%81%93%E3%81%A8%E3%82%82%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82)

# 開発
今回は、しっかりと完成させるというよりはお試しで作ってみるだけなのでTesseract.jsはCDNで使用します。

```html
<body>
    <div>
        <input type="file" id="uploader">
    </div>
    <div>
        進捗: <span id="progress">0</span>%
    </div>
    <div>
        <div id="ocrResult"></div>
    </div>
</body>
```

```javascript

const files = evt.target.files;
    if (files.length == 0) {
        return;
    }

    Tesseract
        .recognize(files[0], { lang: 'jpn', tessedit_pageseg_mode: "RAW_LINE" })
        .progress(function (p) {
            // 進歩状況の表示
            let progressArea = document.getElementById("progress");
            progressArea.innerText =  p.status + " " + Math.round(p.progress * 100);
        })
        .then(function (result) {
            // 結果の表示
            $replaceResult = highlight(result)
            let ocrResult = document.getElementById("ocrResult");
            ocrResult.innerHTML = $replaceResult;
        });
}

const elm = document.getElementById('uploader');
elm.addEventListener('change', recognize);

function highlight(result) {
    const ngWords = ['そらまめ', 'ひよこまめ', 'えだまめ', 'なっとう'];
    let resultHtml = result.text.replace('会', '金'); //「金」を「会」と誤認してしまうため置き換える

    //NGワードにハイライト用のクラスをつける
    for (let i = 0; i < ngWords.length; i++) {
        resultHtml = resultHtml.replace(new RegExp(ngWords[i], "g"), '<span class="highlight">' + ngWords[i] + '</span>');
    }

    return resultHtml;
}
```

CSSは省略

今回のコードの大半はこちらのサイトのコードを使用しました。
参考：[Tesseract.js を使った最小 OCR サンプル](https://puarts.com/?pid=1481)

# 解説
### recognize

```JavaScript

recognize(files[0], { lang: 'jpn', tessedit_pageseg_mode: "RAW_LINE" })
```
recognize関数は、OCR解析を実行する関数。
第一引数には対象の画像を、第二引数にはオプションを指定する。
tessedit_pageseg_modeは、ページ区切りモードを指定するオプション。RAW_LINEでページ固定している。

### progress
```JavaScript
progress(function (p) {
    // 進歩状況の表示
    let progressArea = document.getElementById("progress");
    progressArea.innerText =  p.status + " " + Math.round(p.progress * 100);
})
```

progress関数は、ジョブ（解析）が進行したときに呼ばれるcallback関数をセットすることが出来る。
getElementByIdでprogressの要素を取得し、progressArea変数にいれる。
innerTextでprogressAreaに解析の進行状況を反映させている。
Math.round関数で、四捨五入している。

参考
・[Tesseract.jsを使ってブラウザだけでOCRする方法](https://www.mussyu1204.com/wordpress/it/?p=1151)
・[JS向けOCR Tesseract.jsのドキュメント和訳](https://qiita.com/Nao-Taka/items/ea8c449e2a7730ea8c2c)


### ハイライト用の処理
```JavaScript
function highlight(result) {
    const ngWords = ['そらまめ', 'ひよこまめ', 'えだまめ', 'なっとう'];
    let resultHtml = result.text.replace(new RegExp('会', 'g'), '金'); //「金」を「会」と誤認してしまうため置き換える

    //NGワードにハイライト用のクラスをつける
    for (let i = 0; i < ngWords.length; i++) {
        resultHtml = resultHtml.replace(new RegExp(ngWords[i], 'g'), '<span class="highlight">' + ngWords[i] + '</span>');
    }

    return resultHtml;
}
```

こちらは、指定の文字（NGワード）にハイライトをいれるための処理です。
今回は、豆の中でも特に苦戦を強いられる四天王をチョイスしました。

あとで説明しますが、Tesseract.jsの精度がよいとは言い切れない（やり方次第で向上すると思います）です。とりあえず今回は金曜日が会曜日になってしまうためその箇所だけ修正。

ループ処理で、NGワードをハイライト用のクラスを付けた状態に置き換えます。
この時、少し躓いたのがreplace()を使う際、以下のようにPHPと同じように記載すると

```JavaScript
[例]
const colors = ['red','blue','green'];
const replaced = colors.replace(',', ' '); 
console.log(replaced); //red blue,green 最初にマッチしたものしか置換できていない
```
マッチしたもの一つしかハイライトされませんでした。
`正規表現を使うことで全置換を行うことが出来る`んだとか。

RegExpの第二引数で指定している"g"は、グローバルマッチングのフラグでこちらを指定することでNGワードがでてくるたびにハイライトするようにできます。


参考
・[replaceに変数を使ってグローバルマッチさせる2つの方法](https://qiita.com/naoyashiga/items/75bce8cabbbab29b0ccb)
・[RegExp](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp)
・[String.prototype.replace()](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/replace)

### then
```JavaScript

then(function (result) {
    // 結果の表示
    $replaceResult = highlight(result)
    let ocrResult = document.getElementById("ocrResult");
    ocrResult.innerHTML = $replaceResult;
});
```
thenでは、ジョブ（解析）が完了したときに呼ばれるcallback関数をセットします。
結果を、先ほど説明したhighlight関数の引数に渡す。

# 結果
先に言いますが、うまくいきませんでした！！！温かい目で見てください。

### 一般的な給食の献立表
使用した画像はこちら（そもそも今回指定したNGワードはない(笑)）
![給食献立.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/381376/c9020da3-d658-d32d-1b0a-917ecf6db482.png)

懐かしいですね。※私は、あげパンが好きでした。

結果がこちら
![給食献立　OCR結果.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/381376/225ad5b3-1ed1-aa4c-26cf-f1c254989895.png)



複雑すぎたか、全然読み取れていませんでした。

### かなーり簡略化した特製の献立表
あの頃の自分を思うと、***どうしても献立表にマーカーを引いてあげたい…。***
そのため、今回は妥協して特別製の献立表を作りました。
![特製献立表.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/381376/3cb98056-7f5f-fef1-fa01-060ee74c102c.png)



９日の献立は絶望的です。

結果がこちら
![献立　OCR成功.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/381376/872d02d5-506a-52b1-6057-8e7b7609f2ad.png)


なっとうだけうまく認識できませんでしたが、その他３つのまめは無事認識できすべてハイライトできています。（所々ミスはありますが）

何度かやってみて感じたこととしては、

- カタカナの認識は苦手そう
- 周りの文字しだいで認識できていたものが出来なくなったりする（なつとうと認識したこともあった）
- 細かい箇所で間違えている部分はあるがやり方次第で精度はあがりそう
- 英語の認識精度はよさそう

### おまけ（特製の献立表 改）
上記の献立表の文字を太字にしてみてやってみたら結果が変わるのか試しにやってみました。文字はくっきりしているので精度があがると予想。
![特製献立表　改.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/381376/6d765123-1e77-41b1-3e37-fad85bbb0df8.png)

結果がこちら
![献立改　OCR成功？.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/381376/3df8413b-aebe-113e-ca79-1e93d8183746.png)

結果は、予想に反して悪化しました。
確認してみるとえだまめの「え」、ひよこまめの「よ」、さといもの「い」など以前より大文字と小文字の区別の精度が下がっていました。


# どうすれば精度はあがるのか？
***◯適切な文字サイズで読み取ること***
文字が小さいと認識率は下がります。画像を拡大してから読み取ることが重要。

***◯高解像度の画像を使用する***
人の目で確認できるレベルでも画像が粗いと認識率は下がる。できるだけ高解像度の画像を使用すること。

***◯ブラックリスト、ホワイトリストを活用する***
読み取る際に、絶対に使用しない文字なのに誤認識されてしまうという状況があったとき、オプションでブラックリストの設定をすることで、誤認識を防ぐことが出来ます。
（今回でいうと、「金」が「会」になってしまうケース）

特定の文字しか使用しない場合は、ホワイトリストを使って指定文字のみに絞ることが出来ます。


参考：[OCRの日本語読み取り精度を上げる３つの方法](https://valmore.work/3way-increase-ocr-accuracy/)


# まとめ
今回は、Tesseract.jsを用いて給食の献立表の指定ワード箇所をハイライトするものを作りました。
今後本格的に取り組んで、完璧なものを作り上げることがあったらまたQiitaでお伝えします。
やっぱり***自分で「これ作りたい！」ってものがあると勉強も楽しくできますね。***


よくよく思い出してみると、豆は本当に苦手ですがなんだかんだ給食の献立表にマーカーを引く作業は楽しんでいたような気もします(笑)。
たまには非効率な作業もありなんじゃないでしょうか！

***p.s.あの頃、まめを食べてくれた関係者の皆様（友達）ありがとう！本当に助かりました。***