SPSS Modelerでコメントをつけるなどをしてストリームを読みやすくする

SPSS Modelerのストリームを他の人に見せたり、自分の備忘録としてコメントをつけることができます。

#1.コメント機能

付箋のようにコメントを貼ることができます。
一つ目の方法としてはノードを選択している状態で右クリックで、新規コメントを選びます。


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/2b5be831-b0e9-c9cb-4e59-fc1e1690eebf.png)

以下のようにノードに対するコメントが書けます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/98c4b5d7-b1a5-3287-1b33-cbee989ee66c.png)

特定ノードに紐づけないコメントも書けます。
ノードを特に選択しないでキャンバスの空白のところで右クリックし、新規コメントを選びます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/badb5133-1c32-5cf6-9887-65a0bae5364a.png)

以下のように特定のノードに紐づかずにキャンバスに貼ることができます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/12729ede-9b19-7ab8-5afa-6bf62f27fa5a.png)

特定のノードに紐づかないコメントは以下のようにノード群をまとめた説明にもよく使います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/6ea92606-794d-adf7-7eb0-8cbb58640f18.png)

コメントの色を変えたい場合やコメントの重なりを変えたいことがあります。それはツールメニューのストリームのプロパティのコメントで行います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/ba879796-51aa-0c02-a84c-3abb359393f7.png)

色を変えたいコメントを選び、カスタムカラーで色を指定します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/8cda33bf-4137-0c3c-02fe-c72e8c6cb6f7.png)

また、重なりの順序を変更する場合は変更したいコメントを選んで上下に移動のボタンで変更します。上に行くほど背面になります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/9624d724-70cc-1825-6d46-6f846931bc8e.png)

今回「モデリング・ブランチ」のコメントを水色にして、最背面に移動したので以下のようになります。背景が水色になり、後ろに隠れていた「IOTセンサーデータ」のコメントが見えるようになりました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/e9c934f9-5585-086d-3078-b718c3633cea.png)

#2 ノードの名前とツール・チップ

コメントではないのですが、ノードの名前を変更して、ストリームを読みやすくすることができます。

例えば以下のようなテーブルノードから作った条件抽出ノードは、「（生成）」という名前になりますが、何をやっていたのかわからなくなりがちです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/63778657-d1ed-204d-4cb7-a01b2a0bcb89.png)

条件がシンプルなら、ノードの注釈タブで名前をユーザー設定にして条件をそのままコピペしておくとわかりやすくなります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/88d20160-953c-2333-5827-10aecfc81a00.png)

以下のようにわかりやすくなりました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/3a7704f9-5102-78f0-e1ca-8dc2473bc9fd.png)


また、モデルの精度などをメモしておきたい場合、
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/c710032d-5e76-1171-8249-5a78bb4ba9af.png)

やはり、ノードの注釈タブでツールヒントテキストにメモしておくと、
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/20178627-f667-6742-2ba1-ebd1044f4cfd.png)

マウスカーソルを合わせると表示されます。（もちろんノードの名前を変更しても構いません）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/d144b29a-3dde-36e9-afb7-69abac062e84.png)

#3. 集計ノードに件数をメモ

レコード件数をメモしておきたいことがあります。もちろん、コメントをつかってメモしておいてもよいのですが、レコード集計ノードのプレビュー結果をコピペして、

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/38cca4f9-b444-8d93-6c33-d365f9d2a6c1.png)

ノードの名前を変更しておくという手もあります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/cf22483f-b891-bdf6-2ee2-1c7033545ad5.png)

こうすると、件数が変わった場合にもプレビューしなおしてコピペすればいいので簡単です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/f3d94cbe-d52e-5446-adc8-3efdce7ccee0.png)

#4. スコアリング枝の設定
たくさんブランチのあるストリームで最終的にスコアリングで実行するブランチがわからなくなってしまうことがあります。
そういう場合、スコアリングに使いたいノードを選択して、右クリックで「スコアリング枝として使用」を選びます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/05c7c49e-a799-126d-7dc3-f5d82541ec16.png)

そうすると、スコアリングで使うブランチが太線になります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/f0c03986-9407-142a-41d7-ef93ea5f6c34.png)

なお、指定を解除する場合はツールメニューのストリームのプロパティの展開で行います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/45361eb2-5c37-9029-8360-4890d4545aa6.png)

スコアリングノードを（なし）にすれば解除できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/18512330-4f87-493a-7a8f-5e35d15b87fd.png)


#5. まとめ

コメントを入れる前と後を比較してもらうと読みやすさが変わったことがお分かりいただけるかと思います。

コメントを入れる前
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/d0491502-c181-21cd-13c3-b7280d873712.png)

コメントを入れた後
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/39c79a30-4d35-4804-2110-03b95b1b64de.png)


#6. サンプルストリーム
サンプルは以下に置きました。

・ストリーム
コメントなし
https://github.com/hkwd/spsssample/raw/master/210826%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88/comment%E5%89%8D.str
コメントあり
https://github.com/hkwd/spsssample/raw/master/210826%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88/comment%E5%BE%8C.str

・データ
https://github.com/hkwd/spsssample/blob/master/210826%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88/Cond3n_e.csv
https://github.com/hkwd/spsssample/blob/master/210826%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88/Cond3n_e111.csv

■テスト環境
Modeler 18.3
Windows 10 64bit