注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Vulcan では、特定のオントロジーのオブジェクトタイプ、アクション、リンクタイプ、およびプロパティのタイプクラスがエンロールメント内に存在する必要があります。このページでは、Vulcan が読み書きするすべてのタイプクラスを一覧で示します。
Ontology Manager でオブジェクトタイプ、アクション、リンクタイプを作成し、このページに記載されているタイプクラスを、それぞれのプロパティ、アクションパラメーター、リンクタイプに付与します。
スキーマの詳細は、Vulcan の開発に伴って変わる場合があります。Vulcan のリリースごとに、このページと照らし合わせてスキーマを確認してください。
タイプクラスは、プロパティの用途を Vulcan に伝えるために、そのプロパティに付与するラベルです。Vulcan はプロパティを名前ではなく、常にタイプクラスで検索するため、独自のオントロジーの規約に合わせてプロパティに名前を付けられます。また、1個のプロパティに複数のタイプクラスを付与することで、Vulcan とほかのアプリケーションの両方で使用できます。
以下に記載するすべてのタイプクラスは vulcan 名前空間に属します。つまり、kind フィールドは常に "vulcan" で、name フィールドのみが異なります。
以下のテーブルでは、必須は、対応するタイプクラスが設定済みのスキーマに存在しなければならないことを示します。テーブルの種類ごとに、さらに次の要件が適用されます。
Vulcan は、次のオブジェクトタイプを読み書きします。各テーブルには、そのオブジェクトタイプのプロパティで Vulcan が検索するタイプクラスを記載しています。
Vulcan がレンダリングできる3D モデルを表します。モデルのジオメトリは Media Reference として保存されます。
Media Reference プロパティには、vulcan:cad_media_reference タイプクラスを付与する必要があります。vulcan は名前空間(kind)、cad_media_reference は名前(name)です。設定手順については、はじめるを参照してください。
タイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
cad_media_reference | はい | Media Reference | CAD モデルファイルです。このプロパティは、サポートされているモデル形式に記載されているすべての形式を受け付けます。Vulcan は拡張子から形式を検出します。 |
up_axis | いいえ | 文字列 | モデルの上方向の軸の規約です。指定できる値は X、Y、Z です。省略した場合、Vulcan は形式ごとのデフォルト値を適用します。GLB と GLTF には Y、STL、OBJ、PLY、3MF、DXF、LAS、LAZ には Z を適用します。 |
model_unit | いいえ | 文字列 | ファイル自体に単位が宣言されていない場合に、Vulcan がモデルの座標をどのように解釈するかを指定します。単位を宣言しない OBJ、STL、PLY、DXF、LAS、LAZ では、このプロパティを設定してください。GLB、GLTF、3MF では、Vulcan がこれらの形式で宣言されている単位を常に読み取るため、このプロパティは効果がありません。指定できる値は m(または meter / metre)と mm(または millimeter / millimetre)です。Vulcan はそれ以外の値を無視します。 |
CAD モデルの一部に付けられた注釈を表します。注釈は、テキストラベル、3D 空間内の取り付け点、作成者と意図に関するメタデータを組み合わせたものです。
タイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
annotation_id | はい | 文字列 | 注釈の一意の識別子です。 |
annotation_title | はい | 文字列 | 注釈とともに表示される短いラベルです。 |
annotation_content | はい | 文字列 | より長い本文テキストです。 |
part_instance_id | はい | 文字列 | 注釈がアタッチされているパーツインスタンスの識別子です。 |
annotation_attachment_x | はい | Double | モデルの単位で表したアタッチ点の X 座標です。 |
annotation_attachment_y | はい | Double | モデルの単位で表したアタッチ点の Y 座標です。 |
annotation_attachment_z | はい | Double | モデルの単位で表したアタッチ点の Z 座標です。 |
annotation_sphere_size | はい | Double | モデルの単位で表したマーカーの半径です。点マーカーを表示するには、0 を使用します。 |
annotation_created_by | はい | 文字列 | 注釈を作成したユーザーの識別子です。 |
annotation_intent | はい | 文字列 | 注釈マーカーの視覚的な Intent です。下記の Intent の値を参照してください。 |
annotation_timestamp | はい | タイムスタンプ | 注釈が作成された日時です。 |
annotation_intent プロパティには、次の文字列値のいずれかを指定できます。Vulcan は各値を異なるマーカーの色で表示するため、重要度やカテゴリーを、ユーザーがひと目で認識できるように表現できます。Vulcan はこれらの値の意味を規定しないため、ワークフローに合わせて設定できます。
| 値 | マーカーの色 |
|---|---|
none | グレー |
primary | 青(新しい注釈が作成されたときのデフォルト) |
success | 緑 |
warning | 黄 |
danger | 赤 |
モデル上の2点以上の間で取得した距離の測定結果を表します。
タイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
measurement_id | はい | 文字列 | 測定の一意の識別子です。 |
measurement_points | はい | Double の配列 | 測定を定義する順序付きの3D 点座標で、フラットな数値配列としてシリアライズされます。下記の点の形式を参照してください。 |
measurement_created_by | はい | 文字列 | 測定を作成したユーザーの識別子です。 |
measurement_timestamp | はい | タイムスタンプ | 測定が作成された日時です。 |
測定点は、モデルの座標空間で表された数値のフラットな配列として、[x1, y1, z1, x2, y2, z2, ...] の順序でシリアライズされます。したがって、2点の測定には6個の数値が含まれ、3点の測定には9個の数値が含まれます。点は順序付きの折れ線として解釈されます。Vulcan が測定結果として報告する合計距離は、連続する点の間の距離の合計です。
モデルを横切る断面平面を表します。
タイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
section_plane_id | はい | 文字列 | 断面平面の一意の識別子です。 |
section_plane_position | はい | Double の配列 | [x, y, z] の順序で並んだ、ちょうど3個の位置の値です。 |
section_plane_quaternion | はい | Double の配列 | [x, y, z, w] の順序で並んだ、ちょうど4個のクォータニオンの値です。 |
section_plane_created_by | はい | 文字列 | 断面平面を作成したユーザーの識別子です。 |
section_plane_timestamp | はい | タイムスタンプ | 断面平面が作成された日時です。 |
Vulcan は、アクションを通じて注釈、測定結果、断面平面をオントロジーに書き戻します。各アクションタイプは、付与されたパラメーターのタイプクラスの組み合わせによって識別されます。
以下のテーブルには、Vulcan が値を指定するパラメーターのみを記載しています。作成されるオブジェクトのそれ以外の必須プロパティは、すべてアクション定義で値を設定する必要があります。
annotation_created_by、measurement_created_by、または section_plane_created_by)には、アクションを実行したユーザーを設定します。annotation_timestamp を指定するのは、注釈を作成するの場合のみです。追加のアクションパラメーターに Vulcan のタイプクラスは必要ありません。Workshop ウィジェットでアクションを設定する際、これらのパラメーターにデフォルト値を指定するか、ユーザー入力項目として公開できます。
パラメーターのタイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
annotation_title | はい | 文字列 | 短いラベルです。 |
annotation_content | はい | 文字列 | 本文テキストです。 |
part_instance_id | はい | 文字列 | 注釈がアタッチされるパーツインスタンスです。 |
annotation_attachment_x | はい | Double | アタッチ点の X 座標です。 |
annotation_attachment_y | はい | Double | アタッチ点の Y 座標です。 |
annotation_attachment_z | はい | Double | アタッチ点の Z 座標です。 |
annotation_sphere_size | はい | Double | モデルの単位で表したマーカーの半径です。点マーカーには 0 を使用します。 |
annotation_intent | はい | 文字列 | カテゴリーまたは重大度です。 |
annotation_timestamp | はい | タイムスタンプ | 作成時のタイムスタンプです。 |
cad_object | はい | オブジェクト参照 | 注釈が属する CAD オブジェクトへの参照です。 |
パラメーターのタイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
measurement_points | はい | Double の配列 | [x1, y1, z1, x2, y2, z2, ...] 形式の順序付き点座標です。 |
パラメーターのタイプクラス (name) | 必須 | データ型 | 説明 |
|---|---|---|---|
section_plane_position | はい | Double の配列 | [x, y, z] の順序で並んだ、ちょうど3個の位置の値です。 |
section_plane_quaternion | はい | Double の配列 | [x, y, z, w] の順序で並んだ、ちょうど4個のクォータニオンの値です。 |
タイプクラス (name) | 必須 | 説明 |
|---|---|---|
cad_object | はい | 注釈をその親 CAD オブジェクトに関連付けます。 |