4
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

「なぜか読まれない文章」の正体をSudachiPyで解析したら「漢字率」のゴールデンルールが見えてきた話

4
Posted at

ブログ、Zenn/Qiitaの技術記事、あるいは社内ドキュメントにおいて、「内容は良いのになぜか離脱される」「文章が重く見える」という課題が発生することがあります。

この原因の多くは「文字種構成比(Kanji Ratio / Character Type Distribution)」の偏りに起因します。特に漢字の含有率が高すぎると、可読性(Readability)が著しく低下することが知られています。

本記事では、SudachiPyを用いてテキストを形態素解析し、各形態素の表記文字種(Kanji, Hiragana, Katakana, Latin, Digitなど)をトークンおよび文字単位で精密に計測・可視化する「文字種構成比アナライザー」の実装と活用例を解説します。


1. 文字種構成比(漢字率)の技術的定義

日本語テキストの可読性評価において、文字種は大きく以下のカテゴリに分類されます。

  1. 漢字(Kanji): 表意文字。情報密度が高く、過多になると脳の視覚的処理負荷(Cognitive Load)が上昇する。
  2. 平仮名(Hiragana): 表音文字。文章の文法構造や接続を担い、視覚的スペース(余白)を提供する。
  3. 片仮名(Katakana): 外来語や専門用語。適度なアクセントになるが、連続すると可読性が落ちる。
  4. 英数字・記号(Latin / Digit / Punctuation): 数値データやCode表記。

Webコンテンツにおける一般的な可読性の「ゴールデンルール」として、漢字率 20%〜30%ひらがな率 60%〜70%その他 10%前後の比率が最も認知負荷が低いとされています。


2. 実装:SudachiPyによる文字種構成比アナライザー

Unicodeのブロック判定とSudachiPyの形態素解析結果を組み合わせ、形態素および文字レベルで各種構成比と「視覚的可読性スコア」を算出するPythonクラスを構築します。

import re
from sudachipy import dictionary, tokenizer


class TextVisualReadabilityAnalyzer:

    def __init__(self):
        # Tokenizerの初期化
        self.tokenizer_obj = dictionary.Dictionary().create()

        # Unicodeブロックによる文字種判定用正規表現
        self.kanji_pattern = re.compile(r"[\u4E00-\u9FFF\u3400-\u4DBF]")
        self.hiragana_pattern = re.compile(r"[\u3040-\u309F]")
        self.katakana_pattern = re.compile(r"[\u30A0-\u30FF]")
        self.latin_pattern = re.compile(r"[a-zA-Z0-9]")

    def _classify_char(self, char: str) -> str:
        """1文字の種別を判定"""
        if self.kanji_pattern.match(char):
            return "kanji"
        elif self.hiragana_pattern.match(char):
            return "hiragana"
        elif self.katakana_pattern.match(char):
            return "katakana"
        elif self.latin_pattern.match(char):
            return "latin"
        else:
            return "other"

    def analyze(
        self, text: str, mode=tokenizer.Tokenizer.SplitMode.A
    ) -> dict:
        tokens = self.tokenizer_obj.tokenize(text, mode)

        char_counts = {
            "kanji": 0,
            "hiragana": 0,
            "katakana": 0,
            "latin": 0,
            "other": 0,
        }

        token_analysis = []

        for t in tokens:
            surface = t.surface()
            pos = t.part_of_speech()[0]

            # 記号や空白をカウントから除外する場合はここでスキップ処理可能
            token_char_types = [self._classify_char(c) for c in surface]

            for c_type in token_char_types:
                char_counts[c_type] += 1

            # 形態素ごとの漢字率算出
            kanji_in_token = token_char_types.count("kanji")
            token_kanji_ratio = (
                kanji_in_token / len(surface) if surface else 0.0
            )

            token_analysis.append(
                {
                    "surface": surface,
                    "pos": pos,
                    "kanji_ratio": round(token_kanji_ratio, 2),
                }
            )

        total_chars = sum(char_counts.values())

        if total_chars == 0:
            return {"error": "Empty text"}

        # 各文字種の比率算出
        ratios = {k: round(v / total_chars, 3) for k, v in char_counts.items()}

        # 漢字率スコア判定 (理想範囲: 0.20 〜 0.35)
        kanji_ratio = ratios["kanji"]
        if 0.20 <= kanji_ratio <= 0.35:
            readability_status = "Optimal (最適)"
        elif kanji_ratio > 0.40:
            readability_status = "Too Heavy (漢字過多・高認知負荷)"
        elif kanji_ratio < 0.15:
            readability_status = "Too Light (ひらがな過多)"
        else:
            readability_status = "Moderate (許容範囲)"

        return {
            "total_chars": total_chars,
            "char_counts": char_counts,
            "ratios": ratios,
            "kanji_ratio_percent": f"{ratios['kanji'] * 100:.1f}%",
            "readability_status": readability_status,
            "tokens": token_analysis,
        }


3. 検証例:難解な文章 vs 適切なWeb文章

「漢字率が高すぎる文章」と「ひらがなを適度にひらいた文章」を比較検証します。

analyzer = TextVisualReadabilityAnalyzer()

# パターンA:漢字率が高すぎる文章(論文・官公庁スタイル)
text_heavy = """
本技術仕様書は、形態素解析処理における形態素抽出精度の向上および処理速度の最適化を目的として記述されたものである。
"""

# パターンB:ひらがなを適切にひらいたWeb文章
text_balanced = """
この記事では、日本語のテキスト解析を使って、読みにくい文章を読みやすくするためのコツを分かりやすく解説します。
"""

res_heavy = analyzer.analyze(text_heavy)
res_balanced = analyzer.analyze(text_balanced)

print("=== パターンA (漢字過多) ===")
print(f"総文字数: {res_heavy['total_chars']}")
print(f"文字種比率: {res_heavy['ratios']}")
print(f"漢字率: {res_heavy['kanji_ratio_percent']}")
print(f"評価: {res_heavy['readability_status']}")

print("\n=== パターンB (バランス良好) ===")
print(f"総文字数: {res_balanced['total_chars']}")
print(f"文字種比率: {res_balanced['ratios']}")
print(f"漢字率: {res_balanced['kanji_ratio_percent']}")
print(f"評価: {res_balanced['readability_status']}")

実行結果出力

=== パターンA (漢字過多) ===
総文字数: 56
文字種比率: {'kanji': 0.607, 'hiragana': 0.321, 'katakana': 0.0, 'latin': 0.0, 'other': 0.071}
漢字率: 60.7%
評価: Too Heavy (漢字過多・高認知負荷)

=== パターンB (バランス良好) ===
総文字数: 58
文字種比率: {'kanji': 0.224, 'hiragana': 0.707, 'katakana': 0.017, 'latin': 0.0, 'other': 0.052}
漢字率: 22.4%
評価: Optimal (最適)

パターンAは漢字率が 60.7% に達し、視覚的な難易度が高いと判定されました。一方、パターンBは 22.4% とゴールデンルールの範囲(20%〜35%)に収まっています。


4. 応用:SudachiPyの形態素品詞情報を利用した「自動ひらき推敲」パイプライン

単に全体の漢字率を測るだけでなく、SudachiPyで「ひらがなに直すべき形式名詞・補助動詞」をピンポイントで検出・リファクタリングするルールベースのパイプラインに応用できます。

  • 検出対象例:
  • 名詞(非自立 / 形式名詞):「時」→「とき」, 「事」→「こと」, 「通り」→「とおり」
  • 動詞(非自立 / 補助動詞):「〜して頂く」→「〜していただく」, 「〜と言う」→「〜という」
# 形式名詞や補助動詞の漢字表記を自動アラート検出する例
def detect_open_candidates(tokens):
    candidates = []
    for t in tokens:
        pos = t.part_of_speech()
        # 品詞サブカテゴリが「非自立可能」や「副詞可能」で漢字が含まれる場合
        if len(pos) > 1 and "非自立" in pos[1] and analyzer.kanji_pattern.search(t.surface()):
            candidates.append((t.surface(), t.normalized_form(), pos))
    return candidates


5. まとめ

  • 文章の可読性は定性的な「好み」だけでなく、Unicodeの文字種判定とSudachiPyの形態素解析による「漢字率(文字種構成比)」で定量的に評価・制御できる。
  • Web記事やマニュアル制作において、漢字率を 20%〜35% に制御する自動CI/CDチェックツール(Linter)を組むことで、記事の推敲作業を大幅に効率化可能。
4
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?