Skip to main content

Ink Model URIスキーム

Ink Model仕様は、RFC 3986.

URI Scheme​

のガイドラインに準拠したスキームを指定することにより、Uniform Resource Identifiers (URI)を使用してInkModel'sのプライマリインクツリーのノードやビューを参照する方法を定義しています。

仕様では、@@@で定義されている次の用語が使用されています。RFC 3986:

  • scheme
  • authority
  • path
  • segment
  • unreserved characters
  • pchar
  • pct-encoded characters
  • fragment

Ink Model仕様は、次の構文を使用してInkModelのノードや他の要素を特定するための固有のURIスキームを定めています。

  • URI = "uim:" [ //authority ] [path] [#fragment]

  • authority = skipped

  • path = 1 * ( "/" segment )

  • segment = 1 * ( pchar )

  • fragment = optional

    メモ：

    URI's authorityの部分は省略されます。 下の表内のすべてのパス定義は、@@@に従って path-rootless とみなされます。RFC 3986.

パスの部分は、@@@を一意に識別するパーセントエンコードされたURI_（RFC 3986、Section 2.1：https://tools.ietf.org/html/rfc3986#section-2.1_ に定義）を含むセグメントから開始する場合があります。Ink Model. InkModel'sの識別セグメントが省略される場合は、URIがInk Modelレベルでのローカルノード参照に使用され、URIはローカル@@@として扱われます。URI.

重要： 実装では、シリアル化されたモデルに属するエンティティのURIsをローカル形式のみで（ローカルURIsを使用して）エンコードする必要があります。

Ink Model​

Path: > <pct-encoded InkModel URI/>node/<node-id>

Fragment: n/a

Description: URI@@@に含まれるノードの@@@。Ink Model. > <pct-encoded InkModel URI>セグメントには、@@@のパーセントエンコードされたURI of an InkModel.が含まれます。このセグメントはオプションです。<node-id>セグメントには、GUID 文字列値としてエンコードされる > > InkNode 識別子が含まれます。

例： > _GUID 5454710e-608d-4eee-9552-680f3349ab3e_の InkNode があり、メインインクツリーまたは@@@のInkModelビューに含まれていると仮定します。URI https://example.com/inkmodel/9b67babb-a2a3-491b-96ce-71c820ce0c64, (プロバイダーによって提供されます https://example.com/).

URI InkModel'sの範囲の InkNode の@@@(local ID): uim:node/5454710e-608d-4eee-9552-680f3349ab3e

URIInkNode の@@@ （グローバルに一意）： uim:https%3A%2F%2Fexample.com%2Finkmodel%2F9b67babb-a2a3-491b-96ce-71c820ce0c64/node/5454710e-608d-4eee-9552-680f3349ab3e

Named entities​

Path: > <pct-encoded InkModel URI/>ne/<ne-id>

Fragment: n/a

Description: URI固有表現定義の@@@で、通常は特定の InkModel ノードに関する情報のグループ化に使用されます。

<pct-encoded InkModel URI>セグメントには、@@@のパーセントエンコードされたURI of an InkModel.が含まれます。このセグメントはオプションです。 <ne-id>セグメントには、固有表現定義の識別子が含まれます。

MD5-hashベースのユニーク ID 生成アルゴリズム​

このアルゴリズムでは、（文字列値としてエンコードされる）タグや一連の要素に基づいて一意の識別子を生成することができます。

サポートする要素タイプは次のとおりです。

  • 整数
  • 浮動小数点数
  • 文字列
  • キーと値のペアとして定義された属性のリスト。ペアのキーと値は文字列タイプとみなされます。

アルゴリズムは下の擬似コードで表現されます。 記載されているメソッドは引数としてタグ値と要素のリストを取得し、一意の MD5 ハッシュを 8 バイトの配列として生成します。

METHOD generateMD5Hash(tag, components): RETURNS byte[8]

    SET buffer = new StringBuffer()

    buffer.write(tag)
    buffer.write("\n")

    FOREACH component OF components
        IF (component is defined)
            buffer.write(component.convertToString())
        buffer.write("\n")

    RETURN MD5_HASH(buffer.toString())

convertToString()メソッド 上の擬似コードスニペットで使用されている@@@は、要素タイプごとに次のように実装する必要があります。

  • Integer number - convertToString()は、整数の文字列表現を返します。

  • Floating-point number - convertToString()は、浮動小数点数の文字列表現を返します。小数点以下の桁数は、10進法で4桁に固定されています。

  • String - convertToString() は文字列値を返します。

  • List of properties - convertToString() の疑似コード実装:

METHOD convertToString(properties): RETURNS string

    SET buffer = new StringBuffer()

    properties = SORT(properties) // sort the properties list by ascending alphabetical name order

    FOREACH pair OF properties
        buffer.write(pair.name)
        buffer.write("\n")
        buffer.write(pair.value)
        buffer.write("\n")

    RETURN buffer.toString()

語彙​

センサーチャネルの種類​

以下の表は、異なるセンサー特性を区別するために使用される、URIとして定義された一般的なセンサーチャネルの種類のリストを説明しています。

URI説明
will://input/3.0/channel/Xサーフェス上または3D空間内のX座標を格納するセンサーチャネル。
will://input/3.0/channel/Yサーフェス上または3D空間内のY座標を格納するセンサーチャネル。
will://input/3.0/channel/Z3D空間内のY座標を格納するセンサーチャネル。
will://input/3.0/channel/Timestamp直前のサンプルからの時間差を格納するセンサーチャネル。
will://input/3.0/channel/Pressureペン先に加えられた圧力を格納するセンサーチャネル。
will://input/3.0/channel/RadiusXタッチイベントのX半径を格納するセンサーチャネル。
will://input/3.0/channel/RadiusYタッチイベントのY半径を格納するセンサーチャネル。
will://input/3.0/channel/Azimuthペンデバイスの方位角を格納するセンサーチャネル。
will://input/3.0/channel/Altitudeペンデバイスの高度角を格納するセンサーチャネル。
will://input/3.0/channel/Rotationペンデバイスのバレル回転を格納するセンサーチャネル。

コア要素​

以下の表は、URIとして定義されたWILLコア要素タイプのリストを説明しています。

URI説明
will://core/3.0/core/Pathインクストローク
will://core/3.0/core/Sensordataセンサーデータ
will://core/3.0/core/Brushブラシ

一般的なInkModelビュー​

以下の表は、既知のInkModelビューのリストを説明しています。

URI説明
will://views/3.0/HWR現在はSemantic Ink Servicesによって提供されています。
will://views/3.0/NER現在はSemantic Ink Servicesによって提供されています。

備考 このセクションはまだ実験的な状態にあり、掲載されている定義は変更される可能性があります。

セマンティクス​

以下の表は、インクモデルの知識グラフにオントロジー知識定義を格納するために使用されるタイプとエンティティのリストを説明しています。

URI説明
will://semantic/3.0/hasNamedEntityDefinition固有表現抽出（NER）の結果を保存する専用エンティティを定義する述語。
will://semantic/3.0/hasSourceKnowledge Graph のソースを示す述語。
will://semantic/3.0/hasUriKnowledge Graph 内の URI を示す述語。
will://semantic/3.0/hasAbstractエンティティを記述する短い抜粋を示す述語。
will://semantic/3.0/hasImageセマンティックエンティティを記述する画像を示す述語。
will://semantic/3.0/hasThumb概念タイプに対するサムネイルを示す述語。
will://semantic/3.0/hasArticleセマンティックエンティティに関する記事を指す URL を示す述語。
will://semantic/3.0/hasType概念のタイプを記述する場合の述語。
will://semantic/3.0/hasCategoryセマンティックエンティティのカテゴリを示す述語。
will://semantic/3.0/hasLabelセマンティックエンティティのラベルを示す述語。
will://semantic/3.0/is手書き文字認識からの最良の計算を示す述語。
will://semantic/3.0/hasAlt代替認識結果を示す述語。
will://semantic/3.0/hasBBox認識された単語の境界ボックスを示す述語。
will://semantic/3.0/hasRelevantConceptNER が複数の概念タイプを発見した場合の関連する概念タイプを示す述語。

メモ 本セクションはまだ実験段階であり、記載された定義は変更される可能性があります。

Content Segmentation​

下の表には、コンテンツ分割に関してインクモデルの構造を記述する場合に使用されるタイプとエンティティのリストを記載します。

URI説明
will://segmentation/3.0/TextRegionテキストを含む大きな領域を定義します。
will://segmentation/3.0/Paragraph段落内のテキスト行をグループ化します。
will://segmentation/3.0/TextLineテキスト行内の単語をグループ化します。
will://segmentation/3.0/Word単語内のインクストロークをグループ化します。
will://segmentation/3.0/Phrase論理的な単位内の単語をグループ化します。
will://segmentation/3.0/LineBreak改行を定義します。
will://segmentation/3.0/MathBlock数式のインクストロークをグループ化します。
will://segmentation/3.0/Shape図形のインクストロークをグループ化します。

メモ 本セクションはまだ実験段階であり、記載された定義は変更される可能性があります。

形状​

以下の表は、形状認識と定義に関するタイプとエンティティのリストを説明しています。

URI説明
will://shapes/3.0/Rectangle四角形としてインクストロークをグループ化します。
will://shapes/3.0/Circle円としてインクストロークをグループ化します。
will://shapes/3.0/Ellipse楕円としてインクストロークをグループ化します。
will://shapes/3.0/Triangle三角形としてインクストロークをグループ化します。
will://shapes/3.0/Doodleドゥードルとしてインクストロークをグループ化します。
will://shapes/3.0/Arc円弧としてインクストロークをグループ化します。
will://shapes/3.0/Line直線としてインクストロークをグループ化します。
will://shapes/3.0/Polygon多角形としてインクストロークをグループ化します。
will://shapes/3.0/Parallelogram平行四辺形としてインクストロークをグループ化します。
will://shapes/3.0/Rhombusひし形としてインクストロークをグループ化します。
will://shapes/3.0/attr/points点のリストを記述する属性。
will://shapes/3.0/attr/pt単一の点を記述する属性。
will://shapes/3.0/attr/pt1第1の点を記述する属性。
will://shapes/3.0/attr/pt2第2の点を記述する属性。
will://shapes/3.0/attr/pt3第3の点を記述する属性。
will://shapes/3.0/attr/radius半径を記述する属性。
will://shapes/3.0/attr/radiusXx方向の半径を記述する属性。
will://shapes/3.0/attr/radiusYy方向の半径を記述する属性。
will://shapes/3.0/attr/rect四角形を記述する属性。
will://shapes/3.0/attr/centerPoint中心点を記述する属性。
will://shapes/3.0/attr/angle角度を記述する属性。
will://shapes/3.0/attr/phiAngleφ角度を記述する属性。
will://shapes/3.0/attr/startAngle開始角度を記述する属性。
will://shapes/3.0/attr/sweepAngleスウィープ角度を記述する属性。

メモ 本セクションはまだ実験段階であり、記載された定義は変更される可能性があります。