> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Separator

> Separator 要素は、長さの制限、品質ペナルティ、分断された区切り線を結合するオプションを使用して、縦方向および横方向の区切り線を検出します。

**Separator** は、縦または横の区切り線を表す FlexiLayout の要素です。

**Separator** 要素は、FlexiLayout ツリーで <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/el_separator.gif?s=2f2c9b491958f4d13f93be3d9b85ece9" alt="Separator 要素のアイコン" style={{display:"inline-block",verticalAlign:"middle",margin:0}} width="17" height="17" data-path="images/flexi-capture/fls/el_separator.gif" /> で示されます。

プログラムは、区切り線を探すために **Separator** 要素を使用します。[事前認識](/ja/flexi-capture/fls/batch/prerecognition) で検出された 区切り線オブジェクトのうち、**Separator** 要素の検索領域内に完全に収まっているもの、または検索領域と重なっているものが候補として扱われます。

<div id="separator-element-properties">
  ## Separator 要素のプロパティ
</div>

**Properties** ダイアログを開くには、**FlexiLayout** ツリーで要素を右クリックし、ショートカット メニューから **Properties...** を選択します。

対応するオブジェクトを記述するには、**Separator** タブをクリックします。

<Frame>
  <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/Separator_tab.gif?fit=max&auto=format&n=lqYknuOmCa79141v&q=85&s=b975e5fca604c4733b1558ac0f6d7395" alt="ABBYY FlexiLayout Studio のSeparator 要素の [Properties] ダイアログにある [Separator] タブのスクリーンショット。" width="431" height="455" data-path="images/flexi-capture/fls/Separator_tab.gif" />
</Frame>

**Separator** タブには、次のプロパティがあります。

| プロパティ          | 説明                                                                                                              |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| **方向**         | 区切り線の方向 (垂直または水平) を設定します。                                                                                       |
| **最小長**        | 区切り線の最小長を、ユーザー定義の[単位](/ja/flexi-capture/fls/template/units)で設定します。これより短いオブジェクトは無視されます。                          |
| **Max length** | 区切り線の最大長を、ユーザー定義の[単位](/ja/flexi-capture/fls/template/units)で設定します。これより長いオブジェクトは無視されます。                          |
| **最小相対長 (%)**  | 区切り線の最小相対長を設定します。指定できる値は 0 ～ 100 です。区切り線の相対長は、\[区切り線の長さ]/\[区切り線に沿った検索領域の長さ] として計算されます。相対長がこれより小さいオブジェクトは無視されます。 |

<Note>
  **Min length** と **Min relative length (%)** の両方を指定した場合、プログラムはより厳しい条件を使用し、もう一方は無視します。
</Note>

区切り線の長さを見積もるには、画像内の対応するオブジェクトをクリックし、**Properties** ウィンドウでそのプロパティを確認します。

たとえば、**Min length** = 300 (1 in または 2.54 cm) かつ **Min relative length** = 30% とします。検索領域の幅が 21.0 cm (A4 用紙の幅) であれば、プログラムは 6.3 cm より長い区切り線を探します。

<div id="penalty-limit-for-length">
  ### Penalty limit for length
</div>

**Penalty limit for length** は、長さに対するペナルティとして仮説の品質に乗算できる最小係数です。

プログラムが仮説の品質を評価する際、区切り線の長さに応じて仮説にペナルティを課すことがあります。区切り線オブジェクトが長いほど、仮説の品質は高くなります。

検索領域と同じ長さの区切り線には、最大の品質である 1 が割り当てられます。区切り線の相対長が 1 から 0 に減少すると、仮説の品質は 1 から **Penalty limit for length** の値まで比例して直線的に低下します。

| Diagram                                                                                                                                                                                                                                                                                                                                       | Formula                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/Separator_1.gif?s=9cf8fa749d094be3e1c2a66abe772cb0" alt="L を L0 で割って計算される区切り線の相対長の図。" width="304" height="302" data-path="images/flexi-capture/fls/Separator_1.gif" />               | Relative length = L/L0                                                                                                                                                            |
| <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/Separator_2.gif?s=fe5d90f22f30ca34ddd1ebd84eecde0f" alt="区切り線の相対長が 1 から 0 に下がるにつれて仮説の品質が直線的に低下する図。" width="349" height="275" data-path="images/flexi-capture/fls/Separator_2.gif" /> | \[Quality] = ( 1 – \[Min penalty for length] ) \* \[Relative length] + \[Penalty limit for length].<br /><br />(相対長が 1 のとき品質は 1、相対長が 0 のとき \[Min penalty for length] へ直線的に変化します。) |

<div id="fits-entirely-within-search-area">
  ### 検索領域内に完全に収まる
</div>

**Fits entirely within search area** は、区切り線が検索領域内に完全に収まる必要があることを指定します。次の図のように検索領域と重なる区切り線を見つけるには、このオプションをオフにします。

<Frame>
  <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/Sep_Search_Reg.gif?s=216128f9b6949039dfca3902ea3f6b8b" alt="ABBYY FlexiLayout Studio で、検索領域内に完全には収まらず、検索領域と重なっている区切り線のスクリーンショット。" width="143" height="76" data-path="images/flexi-capture/fls/Sep_Search_Reg.gif" />
</Frame>

<div id="space-group-for-disjointed-separators">
  ### 分断された区切り線の Space グループ
</div>

文書画像上の区切り線は、印刷やスキャンの品質が低いと、ゆがんだり、途切れたり、傾いたりすることがあります。事前認識では、そのためにプログラムが 1 本ではなく複数の区切り線を検出してしまうことがあります。

<Frame>
  <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/Split_Separators.gif?s=cda77d1415fa4432d9eaa0af7d857b48" alt="事前認識中に、ゆがんだ 1 本の区切り線が、分断された複数の区切り線フラグメントとして検出されている画面のスクリーンショット。" width="233" height="70" data-path="images/flexi-capture/fls/Split_Separators.gif" />
</Frame>

**Space** グループには、複数の区切り線を 1 つの仮説に含める条件をプログラムに指定するためのオプションがあります。

| プロパティ                       | 説明                                                                                                  |
| --------------------------- | --------------------------------------------------------------------------------------------------- |
| **Max length**              | 1 つの仮説に含めて 1 本の区切り線と見なすことができる、2 つの区切り線オブジェクト間の最大距離。                                                 |
| **Max relative length (%)** | 1 つの仮説に含めて 1 本の区切り線と見なすことができる、2 つの区切り線オブジェクト間の最大相対距離。相対距離は次のように計算されます：\[区切り線フラグメント間の距離]/\[区切り線の全長]。 |
| **Orthogonal shift**        | 1 つの仮説に含めて 1 本の区切り線と見なすことができる、2 つの平行な区切り線オブジェクト間の最大相対距離 (直交方向) 。                                    |

<Note>
  **Max length** と **Max relative length (%)** の両方を指定した場合、プログラムは 2 つの距離のうち短い方を使用します。
</Note>

<div id="tips-for-separator-elements">
  ## Separator 要素のヒント
</div>

区切り線は、通常、非構造化文書では位置が固定されていません。また、任意のデザイン要素であるため、まったく使われないこともあります。このため、区切り線が FlexiLayouts で参照要素として使用されることはほとんどありません。

文書内の区切り線の最も一般的な役割は、隣接する field からテキストを区切ることなので、**Separator** 要素の検索領域は小さくなる傾向があります。

区切り線を参照要素として使用する場合は、事前認識でそれらが検出されたかどうかを確認する必要があります。

事前認識の完了後、プログラムがすべてのテスト画像で区切り線を検出できることを確認します。

<Steps>
  <Step title="区切り線を強調表示する">
    ツールバーの<img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/Separators.gif?fit=max&auto=format&n=lqYknuOmCa79141v&q=85&s=71983808892c60f65eb84d19d22ae380" alt="区切り線を表示ボタン" style={{display:"inline-block",verticalAlign:"middle",margin:0}} width="22" height="22" data-path="images/flexi-capture/fls/Separators.gif" />ボタンをクリックします。
  </Step>

  <Step title="すべてのテスト画像を確認する">
    すべてのテスト画像を見て、区切り線の位置を確認します。
  </Step>
</Steps>

特に区切り線が細い場合は、この確認が重要です。細い区切り線の検出は、画質とスキャン設定に左右されるためです。

<Warning>
  **Separator** 要素を作成する際は、区切り線の検索領域内で最終的に得られる仮説の数に注意してください。同じ検索領域内に複数の区切り線オブジェクトがあり、さらに FlexiLayout に複数の **Separator** 要素を含むグループがあるような状況は避けてください。

  このような場合、FlexiLayout の適用時にプログラムが異常に多くの仮説を生成することがあります。

  各オブジェクトごとに仮説を生成でき、プログラムが可能な仮説の組み合わせをすべて試そうとするためです。

  可能であれば、検索領域を制限して **Separator** 要素の仮説数を最小限に抑えてください。
</Warning>

<div id="related-topics">
  ## 関連トピック
</div>

* [要素を作成、コピー、削除する](/ja/flexi-capture/fls/template/elements-simple)
* [要素のプロパティの概要](/ja/flexi-capture/fls/template/elements-properties)
* [検索領域](/ja/flexi-capture/fls/template/search-constraints)
* [追加の検索条件](/ja/flexi-capture/fls/template/advanced-constraints)