セマンティックエディタは産総研社会知能技術研究ラボで開発中のJavaアプリケーションです。 JRE5以降のJRE (Java Runtime Environment; J2SEに含まれます) が必要です。JRE6以降を推奨します。 下記のJWS版を使うと、 適当な版のJREがなければ自動的にダウンロード・インストールされます。 Mac OS X用のJavaはここにあります。

セマンティックエディタを使うにはユーザアカウント(SACMと共通)が必要です。 これらを取得するには橋田までご連絡下さい。

ダウンロードページ (上記とは別のユーザ名とパスワードによる認証が必要です) のSATool Distributions → Semantic Editor → Stable versionから、 下記のいずれかをダウンロードして下さい (JWS版をお薦めします)。

• JWS版 (Start stable version)

  Java Web Start用のスクリプトeditor_stable.jnlpです。 クリックでエディタ本体がダウンロードされ起動されます。

  または、 ブラウザの右クリックで「名前を付けて保存」等を選んでダウンロードして下さい。 起動の際にセマンティックエディタ本体の最新版のインストールが自動的に行なわれます。

• スタンドアロン版 (Stand alone version)

  アプリケーションのアーカイブsaEditor.tar.gzです。 ダウンロード後、適当なディレクトリに展開すればインストール完了です。 起動の際に最新版の自動的インストールは行なわれません。

• JWS版の場合

  上記でダウンロードしたeditor_stable.jnlpを実行して下さい。 インターネットに接続されている場合、 JREの適当な版がインストールされていなければ、 自動的にダウンロード・インストールが行なわれます。 また、 セマンティックエディタの最新版がインストールされていなければ 自動的に最新版のダウンロードとインストールが行われます。 最初の起動の際は必ずセマンティックエディタの本体をダウンロードするため、 インターネットに接続している必要があります。 JRE6ではなくJRE5を使う場合は、 Javaコンソールを表示しない設定にして下さい。 Javaコンソール等を表示しない設定は、 Windowsの場合、コントロールパネル → Java → 詳細 → Javaコンソール → コンソールを表示しないで行ないます。

• スタンドアロン版の場合

  上記でインストールしたディレクトリの、saEditor.bat (Windowsの場合) またはsaEditor (UNIX系OSの場合) を実行して下さい。

• 共通

  起動すると、下のような「設定」ダイアログが表示されます。 ユーザ名とパスワードを入力して了解をクリックして下さい。

  

  「設定」ダイアログ (起動時)

  HTTPトンネリング設定やプロキシの設定は、 大学や会社のファイアウォールを越えて サーバにアクセスするためのものものですが、 通常は不要です。 なお、このダイアログは、 起動後にメインメニュー → 編集 → 設定で呼び出すことができます。

  ユーザ名とパスワードは管理者から発行されます。 これらがないと作成したコンテンツを共有することができません。

  認証が完了した後、 サーバとの通信が可能な状態であれば、 「サーバからのメッセージ」 (アップデート情報など) が表示されます。 重要な情報が含まれる可能性があるので、 必ず内容を確認して下さい。 確認したら了解をクリックして下さい。

  

  「サーバからのメッセージ」

  セマンティックエディタを初めて起動したときは、システムオントロジーを含む初期ローカルキャッシュが自動的にダウンロードされます。

  サーバとの通信が行なわれている間は、 下図のように「通信停止」ボタン (ブックマークとオントロジの間の下) が赤くなって押下可能になります。

  

  起動されたセマンティックエディタの画面 (通信中)

  下にセマンティックエディタの画面の全体を示します。

  

  セマンティックエディタの全体像

  会社や大学によってはファイアウォールのせいで通信ができないことがあります。 その場合は、メインメニュー → 編集 → 設定で「設定」ダイアログを表示し、 下のように「サーバ」タブでHTTPトンネリングを使うを選び、メインメニュー → オントロジ → システムオントロジでシステムオントロジーを開いて、メインメニュー → 通信 → 取得/送信 → 再帰的取得を実行して下さい。

  

  「設定」ダイアログ (「サーバ」タブ)

最初にエディタが立ち上がったときに自動的にダウンロードされるコンテンツは最新でない可能性があります。 明示的にサーバとの同期をして下さい。 単なる同期はフォーカスされているハイパーノードの範囲の同期なのですぐに終わりますが、再帰的同期はそのハイパーノード以下の全コンテンツの同期なのでかなり時間がかかる場合があります。

メインメニュー → ファイル → 閉じる、Alt-F4、 またはCtrl-Qで終了して下さい。

• JWS版

  Windowsの場合は、コントロールパネル → アプリケーションの追加と削除からアンインストールを行って下さい。

• スタンドアロン版

  展開したディレクトリを削除して下さい。

• 共通

  ユーザディレクトリ (Windowsの場合は C:\Documents and Settings\ユーザ名\ など) に残るキャッシュ (.sa ディレクトリ) を削除して下さい。

サンプルプラグイン (Serialize「シリアライズ」、 Duplicate「複製」、 Graph Search「グラフ検索」など) がシステムオントロジーに組み込まれています。 プラグインはメインメニュー → プラグインから実行できます。

追加のプラグインは、プラグイン(sa:plugin)型のメディアノードをプロジェクトオントロジーの中に置き、メインメニュー → プラグイン → 再読込を実行すると、 以後メインメニュー → プラグインから使用可能になります。

不要になったら、プロジェクトオントロジーの中から移動 (カット&ペースト) や削除でプラグインノードを取り除き、 メインメニュー → プラグイン → 再読込を実行すると、以後メニューからも消されます。

メインメニュー → プラグイン → 開放を実行すると、 すべてのプラグインがいったんメニューからは消えますが、メインメニュー → プラグイン → 再読込を実行するか次にプロジェクトファイルを開くとふたたび使用可能になります。

セマンティックエディタはRDF (Resource Description Format) のグラフを共同作成するためのソフトウェアツールです。 グラフはノードとリンクからなり、 ノードはハイパーノード(グラフを中に含むノード) でも構いません。 画面のトップレベルもハイパーノードです。 その他のハイパーノードの内容であるグラフは各々サブウィンドウの中に表示されます。

セマンティックエディタの画面には「グラフモード」と「ツリーモード」という２通りの表示のモードがあります。 トップレベルのウィンドウは通常はグラフモードになっていますが、 サブウィンドウは通常はツリーモードになっています。 ウィンドウの背景を右クリックすると現われるコンテキストメニューからツリーモードに変更またはグラフモードに変更を選択するとツリーモードまたはグラフモードに変更することができます。

グラフモードでは、 グラフに含まれる各ノード、 各リンクがちょうど１回ずつ出現するようにグラフを単純に表示します。 ツリーモードではグラフを木のように表示しますが、 各ノード、 各リンクは複数回出現しても良いので、 木の形で任意のグラフを表示できます。 ツリーモードではウィンドウの左端に縦長の長方形が現われます。 この長方形は当該のハイパーノード自体を表わします。

ツリーモードでは、 カーソルの位置に応じて黄色い破線 (上の図ではノード`F'の右側の破線) が表示されますが、 これは、ドラッグ&ドロップによる< SPAN>実体(ノードまたはリンク) の移動や新たな実体の作成によって実体が挿入される位置を示しています。

上の図の状態でCtrl-Tを実行すると、 現在フォーカスされたウィンドウの中にノードの一種であるテキストノードがノード`F'の右側に新たに作られます。 テキストノードができると、 その内容としてテキストを入力できる状態になっています。

ここで背景をクリックするなどしてテキストを入力せず空にすると、 空ノード(空のテキストノード) が表示されます。 ノードのタイプであるクラスはrdfs:Resourceです。

実体(ノードまたはリンク) の左肩の赤い星印は、 その実体 の最新の情報がサーバに送信されていないことを示します。 「同期」を実行するとその情報がサーバに送信され、 星印が消えます。

実体のタイプ(ノードの場合はクラス、 リンクの場合は属性) を変更するには、 その実体を右クリックして現われるコンテキストメニュー(タイプメニュー) から適当なタイプを選択します。

ノードをダブルクリックすると、 そのノードに対応するサブウィンドウが開きます。 たとえば上図の例で空ノードをダブルクリックすると、 下図のようになります。

このサブウィンドウの中にノードを作ると、 空ノードの枠線が２重になりますが、 これはこのノードが非空のハイパーノードになったことを表わします。

さらにノード`B'をこのハイパーノードの中にドラッグ&ドロップすると、 サブウィンドウの背景が緑色になりますが、 これはノード`C'を根とする部分木が空ノード自身も含めて空ノードの要素となり、 空ノードがトップレベルのハイパーノードの要素でなくなくなったため、 このサブウィンドウの内容が現在のプロジェクトの外にあることを示します。

ツリーモードでは各実体をCtrl+ドラッグ&ドロップすることによってその実体の新しい出現を作ることができます。 また、 リンクの端 (３角か丸の部分) を背景にドラッグ&ドロップすると、 ドロップ先にその端につながったノードの新しい出現ができます。 たとえば、 下のように「例」リンクの右端をノード`A'の右側にドラッグ&ドロップすると、

ノード`G'の新しい出現がノード`A'の右側にできます。

ひとつの実体のある出現を別の出現にドラッグ&ドロップすると、 ２つの出現を後者に統合できます。

終点がrdfs:Literalタイプまたはxsd:Datatypeタイプである属性 (データ型属性) のインスタンスと終点は、 始点であるノードの内部に埋め込まれます。 それらを閲覧・編集するには、 ノードに関して「データ型属性の編集」 (Ctrl-G) を実行します。

ツリーモードでは、 ノードの下へ複雑な部分木を畳み込んで、 ツリーの全体像を見やすくできます。 部分木の根となるノードの右脇にカーソルを合わせると、 背景の色が変わり`－'が表示されます。

ここで`－'をクリックすると、 表示が`－'から`＋'に変わり部分木は畳み込まれます。

ノードの右の`＋'をクリックすると、 ふたたび部分木が展開されます。

グラフモードでは、 リンク自体をリンクの終点にすることができます。

同じ関係が、 ツリーモードでは下図のような表現になります。

上図の`A'を始点とするふたつの「要素」リンクのうち、 `D'へのリンクの方が「言及」リンク終点である「要素」の選択と同時に青くなっているので、 「言及」リンクの終点と同じ実体をもつリンクだとわかります。

メニュー

• 実体

  ノードとリンクの総称。

  • ノード

    テキストノード、メディアノード、またはオントロジーノード。 これらはハイパーノードとなって要素を持つことができる。 要素を持つノードの縁は２重線で表示される。

    • テキストノード

      テキストを内容として持つノード。 テキストが空ならクラスのラベルが表示される。 ただし、 テキストが空でクラスがrdfs:Resourceなら、 空ノードとして表示は空白になる。

    • メディアノード

      メディア (任意のファイル) を内容として持つノード。

    • オントロジーノード

      クラス (ノードのタイプ) または属性 (リンクのタイプ) を表わすノード。

  • リンク

    実体の間の関係を表す実体。

• プロジェクトファイル

  ハイパーノードを指し、 それを表示するウィンドウのサイズや、 それに含まれるサブウィンドウ等の情報を含むファイル。

• プロジェクト

  プロジェクトファイルによって指されたハイパーノードと、 その子孫の実体からなるコンテンツ。

セマンティックエディタには下記の２つの表示モードがあります。

• ツリー表示 　

  グラフを木の形にレイアウトするモード。 ノードに対応するウィンドウを最初に開いたときはこのツリー表示モードになっている。

• グラフ表示 　

  グラフを普通にレイアウトするモード。 各ノード、 各リンクがちょうど１回ずつ出現するように表示される。 新しいプロジェクトを最初に開いたときはこのグラフ表示モードになっている。

• 単一選択
  • クリック
• 複数選択
  • Shift-クリック(選択のトグル)
  • Shift-ドラッグ(範囲の選択)
• フォーカスされているノードの要素の全選択
  • ショートカットキーCtrl-A
  • メインメニュー → 編集 → 全てを選択

ハイパーノードの内容であるグラフを表示するサブウィンドウを開きます。

• ノードをダブルクリック
• ノードを選択してEnter
• ノードを選択してメインメニュー → 操作 → ウィンドウを開く
• ノードを選択してメインメニュー → 操作 → コンテナの代わりにウィンドウを開く

(サブ) ウィンドウをスクロールします。

• ウィンドウの背景をドラッグ
• ウィンドウの中の任意の個所 (実体でも可) をAlt-ドラッグ

• ショートカットキー
  • テキストノード：Ctrl-T
  • オントロジーノード：Ctrl-N
  • メディアノード：Ctrl-B(外部ファイルを含む任意の実体をインポートすることによって作る)
• メインメニュー → 操作 → 新規作成 → 各種ノード作成
• ツールバー → 各種ノード作成
• 背景を右クリック→コンテキストメニュー → 新規作成 → 各種ノード作成

実体のURIを以下のいずれかの操作で入力すると、 その実体をインポートできます。

• ショートカットキーCtrl-B
• メインメニュー → 操作 → 新規作成 → インポート
• ツールバー → インポート
• 背景を右クリック→コンテキストメニュー → 操作 → 新規作成 → インポート

ここで入力できるURIは、 セマンティックエディタで作られた実体のURI (ee8a55ce-d517-4d3f-9b61-33b325bb4274のようなもの) または外部の実体のURI (http://i-content.org/index.htmlのようなもの) です。

実体同士 (通常はノード同士) を結び付けます。

• 既存の実体を1つ以上選択した状態で、 それらの1つを他の実体にShift-ドラッグすると、 選択されていた実体を始点 (主語) とし後者の実体を終点 (目的語) とするリンクができる。
• 既存の実体を2つ選択した状態で、 最初に選択した実体を始点 (主語) 、 次に選択した実体を終点 (目的語) とするリンクを作る。
  • ショートカットキーCtrl-M
  • メインメニュー → 操作 → 新規作成 → リンク作成
  • ツールバー → リンク作成
  • 背景を右クリック→コンテキストメニュー → 新規作成 → リンク作成
  • いずれかの実体 (ノードでなければならない) を右クリック→リンク作成
• 既存の実体を始点 (主語) とするリンクとその終点 (目的語) を作る。
  • 実体を1つだけ選択した状態でショートカットキーCtrl-M
  • 実体を1つだけ選択した状態でメインメニュー → 操作 → 新規作成 → リンク&ノード作成
  • 実体を1つだけ選択した状態でツールバー → リンク&ノード作成
  • 実体を1つだけ選択した状態で背景を右クリック→コンテキストメニュー → 新規作成 → リンク&ノード作成
  • 始点となる実体を右クリック→リンク&ノード作成
• 既存のノードを1つだけ選択した状態で、 そのノードに必須のリンクとその終点を作る。
  • ショートカットキーCtrl-L
  • メインメニュー → 操作 → 必須リンク作成

ノードの内容のテキストを編集します。 オントロジーノードの内容 (URI) も編集できます。

• ノードを1つだけ選択した状態で、 ショートカットキーCtrl-E
• ノードの内部を長く左クリック
• ノードを右クリック、コンテキストメニュー → 編集
• ノードをCtrl-ダブルクリック
• ノードを1つだけ選択した状態で、メインメニュー → 操作 → 編集
• ノードを1つだけ選択した状態で、ツールバー → 編集

実体の位置を変更します。

• 実体をドラッグ&ドロップ(またはカット&ペースト) で移動できす。 別のハイパーノードの中に移動することもできます。
  • グラフ表示モードでは、↑↓←→キーを押下すると、 選択状態にある全ノードが10ピクセルずつ移動します。
    • Altと同時に押下すると1ピクセルずつ移動します。
  • ツリー表示モードでは、↑↓←→キーを押下すると、 選択状態にある各ノードを根とする部分木すべてが木構造の中を移動します。
• 実体をコピー&ペーストで他の所にコピーすることができます。 コピーは Ctrl-C、 ペーストはCtrl-V です。
• グラフ表示モードのハイパーノードとツリー表示モードのハイパーノードとの間での実体のドラッグ&ドロップやコピー&ペーストはできません。

リンクの先端 (3角形の部分) または末尾 (丸い部分) を他の実体にドラッグ&ドロップするとリンクの端点が付け換わります。

ツリー表示モードでリンクのいずれかの端を実体がないところにドラッグ&ドロップすると、 その端が付いていた実体の新たな出現がそこにできて、 ドラッグした端がその出現に付きます。

ノードがどのクラスのインスタンスか、 リンクがどの属性のインスタンスかを設定します。 クラスと属性は、システムオントロジーまたはプロジェクトオントロジーで定義されたものから選べます。

• 選択されているすべてのノードのクラスの設定

  いずれかのノードを右クリック、 コンテキストメニュー → クラス → 各クラス選択

• 選択されているすべてのリンクの属性の設定

  いずれかのリンクを右クリック、 コンテキストメニュー → 各属性選択

ノードには、 単文 (テキスト) /メディア/オントロジーという3つの種別があります。

• ノードを右クリック、コンテキストメニュー → ノード種別変更 → 各種別選択

サーバと通信することによって他の利用者とコンテンツを共有することができます。サーバとの通信には主に(再帰的) 同期を使って下さい。

• 同期

  フォーカスされたノードとその要素の実体について、 前回の通信より後の変更をサーバに送信し、 またサーバでの変化を取得します。

  • メインメニュー → 通信 → サーバと同期

• 再帰的同期

  フォーカスされたノードとその子孫の実体について、前回の通信より後の変更をサーバに送信し、またサーバでの変化を取得します。

  • メインメニュー → 通信 → 再帰的同期

通信によって実体の枠線の色が変化することがあります。 各色の意味は下記の通りです。

• 深緑

  最近の通信によって新たに出現した。

• 緑

  サーバでの変更 (子孫に関する変更を含む) が取得された。

• ピンク

  ノードの子孫に関するサーバでの変更に未取得のものがある。

セマンティックエディタが初期状態で使用できるオントロジーは、 システムオントロジーに含まれる下記のものです。

• RDF/RDFS/OWL
• sa (semantic authoring) core

他のオントロジーは必要に応じてプロジェクトオントロジーに入れて下さい。オントロジーに違反している実体のラベルは赤くなります。

従来システムオントロジーに含まれていた下記のオントロジーは、 他のオントロジーと共に`some ontologies you may include in your projectOntology'の中にあり、 メインメニュー → ブックマーク → 共有ブックマークから開くことができます。

• xsd (Datatypes in XML Schema Definition)
• rel (middle-grain linguistic relations)

言語的関係のオントロジー`rel (middle-grain linguistic relations)'は文間の関係 (談話関係) 等の意味的な関係を定義しています。 通常の文章に相当するコンテンツはこれらの関係を使って作ります。 上の図のツリーやグラフの例もこのオントロジーを使用しています。