> ## 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.

# サンプル 1. Step 12: PlanetName 要素を使用した YOUR PLANET NAME field の記述

> FlexiLayout Studio サンプル 1 の Step 12: アルファベット、文字数、リレーションを使用して、YOUR PLANET NAME field を Character String 要素で記述します。

YOUR PLANET NAME field には常に 1 行だけが含まれるものとします。field 名とは異なり、この field のデータは fixed ではないため、[Character String](/ja/flexi-capture/fls/template/character-chain) 要素として定義する必要があります。

PlanetName 要素を作成するには、次の操作を行います。

1. Character String 型の要素を作成し、**PlanetName** という名前を付けます。

   <Frame>
     <img src="https://mintcdn.com/abbyy/r-nfa7jujx5b9gKX/images/flexi-capture/fls/tutorial14.png?fit=max&auto=format&n=r-nfa7jujx5b9gKX&q=85&s=dab3187a03b869a2208b9314b1945e88" alt="ABBYY FlexiLayout Studio の Character String 要素のプロパティにある General タブのスクリーンショット。PlanetName という名前の新しい要素が表示されています。" width="431" height="455" data-path="images/flexi-capture/fls/tutorial14.png" />
   </Frame>

2. Character String タブをクリックします。

   <Frame>
     <img src="https://mintcdn.com/abbyy/r-nfa7jujx5b9gKX/images/flexi-capture/fls/tutorial15.png?fit=max&auto=format&n=r-nfa7jujx5b9gKX&q=85&s=1b95dae9aa3609296a332a9670913099" alt="ABBYY FlexiLayout Studio の PlanetName 要素のプロパティにある Character String タブのスクリーンショット。アルファベットと文字の設定を行う画面です。" width="431" height="455" data-path="images/flexi-capture/fls/tutorial15.png" />
   </Frame>

3. アルファベット、つまり惑星名とその衛星名に含まれる可能性があるすべての文字を設定します。テスト画像から判断すると、アルファベットは英字と丸かっこで構成されています。アルファベットを設定するには、Add... ボタンをクリックし、**Add New Alphabet** ダイアログで必要な文字を選択します。

   <Note>
     選択した文字は、Character Set 列 (Character String タブの Alphabets field) に表示されます。
   </Note>

4. Percentage of alphabet characters を 100 に設定します。これは、プログラムが **PlanetName** 要素に対応するオブジェクトを探す際に、現在の要素の文字だけを考慮することを意味します。

   <Frame>
     <img src="https://mintcdn.com/abbyy/r-nfa7jujx5b9gKX/images/flexi-capture/fls/tutorial16.png?fit=max&auto=format&n=r-nfa7jujx5b9gKX&q=85&s=cfdf7c051549358187f121ebdf9723ae" alt="ABBYY FlexiLayout Studio の PlanetName 要素のプロパティにある Character String タブのスクリーンショット。アルファベットが設定され、Percentage of alphabet characters が 100 に設定されています。" width="536" height="350" data-path="images/flexi-capture/fls/tutorial16.png" />
   </Frame>

   <Note>
     通常、1 つの要素に対して複数のアルファベットを指定できます。Percentage of alphabet characters フィールドでは、要素内に含まれる各アルファベットの文字の最大割合を指定します。
   </Note>

5. Allow embedded hypotheses ボックスをオフにします。これにより、プログラムは、長さが最大で、すべての検索条件を満たす仮説を生成できるようになります。そうしないと、プログラムは複数の埋め込み仮説を生成する場合があります。各仮説は、選択したアルファベットのいずれかの一部で構成されます (アルファベット以外の文字に許可された割合を考慮) 。

6. Percentage of non-alphabet characters フィールドで、アルファベット以外の文字の最大割合を 10% に設定します。

   <Note>
     この値は試行錯誤によってのみ決定でき、FlexiLayout の調整時に変更できます。
   </Note>

7. Character count フィールドで、次のあいまいな範囲を指定します: \{0, 3, 35, 100}。これは、惑星名が 3 文字から 35 文字までであることを前提にした文字列の長さの目安です。この範囲外の仮説にはペナルティが適用されます。

   <Note>
     この値は試行錯誤によってのみ決定でき、FlexiLayout の調整時に変更できます。
   </Note>

8. Relations タブをクリックします。

   <Frame>
     <img src="https://mintcdn.com/abbyy/r-nfa7jujx5b9gKX/images/flexi-capture/fls/tutorial17.png?fit=max&auto=format&n=r-nfa7jujx5b9gKX&q=85&s=3ed0369fcfcddcab52c19714ac065f2b" alt="ABBYY FlexiLayout Studio の PlanetName 要素のプロパティにある Relations タブのスクリーンショット。参照要素へのリレーションを定義する画面です。" width="431" height="455" data-path="images/flexi-capture/fls/tutorial17.png" />
   </Frame>

9. **PlanetName** 要素の参照要素として **PlanetNameHeader** 要素を使用します。惑星名は常に field 名の右側にあり、その名前と同じ高さに配置されます。したがって、名前に対する要素の位置と、その名前の上境界と下境界に対する位置を指定する必要があります。

   そうしないと、プログラムは、設定したアルファベットの文字で構成される任意のテキストフラグメントに対して有効な仮説を生成してしまい、その位置が名前より上でも下でも対象になってしまいます。

   つまり、プログラムは **PlanetNameHeader** 要素として指定された field 名の右側にあり、**PlanetNameHeader** 要素と同じ高さにある、**PlanetName** 要素で表される惑星名を探す必要があります。

10. **PlanetName** 要素が **PlanetNameHeader** 要素の右側にあることを指定します。
    これを行うには、Add ボタンをクリックし、開いたダイアログで 参照要素 field の **PlanetNameHeader** を選択します。Type ドロップダウンリストで Right of を選択し、Offset フィールドはデフォルト値の 0 のままにします。Add Relation ボタンをクリックします。

<Frame>
  <img src="https://mintcdn.com/abbyy/r-nfa7jujx5b9gKX/images/flexi-capture/fls/tutorial18.png?fit=max&auto=format&n=r-nfa7jujx5b9gKX&q=85&s=2feb59de665c0f020fb3590b585b1e19" alt="ABBYY FlexiLayout Studio の Add Relation ダイアログのスクリーンショット。参照要素として PlanetNameHeader が選択され、リレーションの型は Right of、Offset は 0 に設定されています。" width="416" height="282" data-path="images/flexi-capture/fls/tutorial18.png" />
</Frame>

11. **PlanetName** 要素が **PlanetNameHeader** 要素より下に配置されないよう指定します。これを行うには、Add ボタンをクリックし、表示されたダイアログの 参照要素 field で **PlanetNameHeader** を選択します。Type ドロップダウンリストで Above を選択し、Offset を -100 に設定します (この値は試行錯誤で決める必要があります) 。

    これにより、名前に対する要素の位置を検出する際に、プログラムにある程度の余裕が生まれます。Offset に負の値を指定すると、その要素は名前の下側の境界より上にあることを意味します。Add Relation ボタンをクリックします。
12. **PlanetName** 要素が **PlanetNameHeader** 要素より上に配置されないよう指定します。
    これを行うには、Add ボタンをクリックし、表示されたダイアログの 参照要素 field で **PlanetNameHeader** を選択します。Type ドロップダウンリストで Below を選択し、Offset を -100 に設定します (この値は試行錯誤で決める必要があります) 。

    これにより、名前に対する要素の位置を検出する際に、プログラムにある程度の余裕が生まれます。Offset に負の値を指定すると、その要素は名前の上側の境界より下にあることを意味します。Add Relation ボタンをクリックします。

    <Note>
      Reference boundary field で \<whole> を選択した場合、正の Offset 値で指定できる位置は、要素の右境界より右、左境界より左、上境界より上、または下境界より下だけです。

      Reference boundary field で Top と Bottom を選択した場合、正の Offset 値により search area は要素の上境界と下境界で制限され、field 名の上境界および下境界を超える仮説は除外されます。
    </Note>
