RietRunの使い方.md

Rietrunの使い方

Rietanのインストール

RietrunはRietanのバージョンについて後方互換を一応兼ね備えています。 ただ、最新版のRietanでテストを行っているため、Rietanは最新のものを使った方がいいです。
既存のRietanシステムはアンインストール(Uninstall_RIETAN_VENUS.batの実行)をしてから、泉先生_ハンズオン...フォルダの中のhands_on_document.pdfを見ながらインストールしなおすのがいいです。

Rietanの実行環境

RietRunを使ってバッチ処理を行うにしても、まずはちゃんとしたinsファイルの作成が必要不可欠です。
insファイルを編集し、テスト実行する環境には泉先生が偏愛する秀丸エディタが極めて適しています。
学生であれば申請後無料で使用可能なのでぜひゲットするといいでしょう。
実行環境の構築方法についても前述のhands_on_document.pdfに記載されているはずです。

難しければNotepad++を使えば大体秀丸エディタと同じことが出来るのでそちらを使うのも一つの手です。
Notepad++にしたくて使い方が分からなければ聞いてください。

解析フローの流れ

1. .int, .insを用意する（実行フローをカスタマイズしたい場合はbatファイルも用意）
2. .insファイルを修正してまずは計算が収束するパラメータを設定する
3. Rietrunで解析のフローを組む
4. 実行してみる

実際にやりながら説明

結構大変なので自分もリハビリがてらやりながら解説したいと思います。
今回のチュートリアルにはフッ化アパタイトの試料の構造解析したいと思います

データは

泉先生_ハンズオン資料と最新RIETANシステム/Windows_versions/RIETAN_VENUS_examples/Fapatite

のフォルダにあるので、そこからFapatite.insとFapatite.intをコピーしてデスクトップのどこかのフォルダに入れておくといいです。

このコピーしたファイルを使って解析をします。

解析の準備

まずは秀丸エディタでFapatite.insを開きます。
同時にRietrunも開いてファイルを開くボタンを押してFapatite.insを開くといいです。

Rietrunの起動時に上の方にマクロを有効かするか聞かれると思うので、必ず有効化してください。
有効化しないままダイアログが消えた場合は一度Rietrunを閉じて再起動してください。
マクロの有効化に成功するとRietrunのWelcome画面が開くと思います。

RietrunでFapatite.insを開いたら解析シート作成ボタンを押すといいでしょう。
すると、新しく解析用のシートが生成されinsファイル内の可変なパラメータに0, 1, 2, 3のどのIDが割り当てられているか一目でわかると思います。
解析シート内の一番上の行が初期のパラメータIDです。Step1の行は初期IDが同じく書かれていますがSCALE以外はまずは0にしましょう。SCALE因子以外は精密化しないという意味です。

解析シート名はRietrunのSettingシート内の解析シート名と一致している必要があります。
逆に解析シート名が一致していれば好きな名前に変更することも可能です。
解析シートを複数作成しSettingで解析シート名のところを変更することで様々なパターンで計算することが可能です。

そしたらSettingのステップ解析ボタン下の解析Stepの欄に1を入力しステップ解析ボタンを押します。
するとLogフォルダを作成するか聞かれるのではいを選択。好きなフォルダ名を入力してください。

Logフォルダは解析のバッチを回すたびに新しく作ることが出来ます。
これにより、解析のパターンによって変化する結果をすべて保存でき、いつでも振り返ることが可能です。
また、既存のフォルダを使用することも可能です。その場合はLogフォルダの作成を聞かれたらいいえを選択します。

実行が終了すると速やかに実行結果が出力されると思います。
エラーが生じたらエラー内容が出力され、解析結果が記述される.lstファイルが開かれるかと思います。

いずれにせよ、.insファイル内の可変パラメータのIDがすべてStep1の通りに置き換わるのでこれを基に初期のinsファイルを作成するといいでしょう。

Step解析を行うと解析シート内のStepが実行されます。
また計算結果のプロファイル(理論計算と測定値のグラフやその差)を出力したい場合はsettingシートの右側にある計算結果のプロファイルをプロットするにチェックを入れます。
これにより解析毎でのプロファイルをPDFに出力して保存しておくことがかのうです。
この機能を使うにはNPATを1にしておく必要があります。

一方で最初のころはinsファイル内のNPATを2にしておくことをお勧めします。
解析の初期はRietRunで連続的に実行するより秀丸エディタでパラメータの初期値をよくするために実行と修正を繰り返す方がいいからです。
この時NPATが2だとIgorの形式でグラフデータが出力されます。
秀丸エディタのPlotPlotボタンを押すとマウスで拡大や縮小が可能なグラフ描画ソフトが起動しインタラクティブなグラフによるチェックが可能です。
しかしこの機能を使うためには少しだけ設定を変更する必要があります。
まず、秀丸エディタのメニューにある

マクロ　> マクロの登録 > マクロ2のPlotを選択 > 編集ボタン

とクリックしていきます。するとグラフを表示するためのコードPlot.macが表示されるので25行目付近の

#gtool = 1; // 右辺の整数を1～3に変える

を#gtool = 3;
に変更します。保存して閉じればOKです。これでグラフの閲覧がめっちゃ便利になります。

解析の開始

前節ではに秀丸エディタとRietRunを使って初期パラメータを最初に決定しました。
これがいい感じになったらRietRunを使ってシーケンス処理を開始するといいでしょう。

そのまま連続解析に移ってもいいですが、いったんRietRunの方はリセットしておくといいかもしれません。

解析のやり方は単純でまずは解析シートに各ステップごとに変化させるパラメータを設定していきます。
パラメータのIDを入力する行は解析シートの左上にあるボタンで増減することが可能です。コピペやオートフィルを使って行を増やしてもいいです。

ただし、Stepが記述されている部分はstep 1からちゃんと番号順にしてください。

解析シートが出来たら連続解析ボタンをチェックして解析をスタートさせます。

トラブルシューティング

解析が発散してエラーが生じた際、パラメーターを修正してそのまま次のステップを実行しようとすると以下のエラーが生じる可能性があります。

~は正しく置換されませんでした  
前ステップのinsファイルのIDとセルで指定した前ステップのIDが一致していない可能性があります。  

これはNステップを実行するのにinsファイルのIDがN-1ステップのIDと一致していないためです。

RietRunは解析のためにinsファイルのIDを指定したステップのIDに置換する処理でエラーが生じています。
新しいIDに置換するinsファイルは前回のIDと同じであるはずです。
しかしエラーによって或るNステップの処理が途中で中止された場合はファイルはNステップのIDに置換された状態> になっています。
しかしエラーが起きた場合は問題を修正後再びNステップを実行すると思います。
この時このエラーは生じます。

エラーが生じた場合は前ステップのinsファイルをlogフォルダからコピーして使うといいでしょう。
このとき役に立つのがファイル置換ボタンです。このボタンをクリックするとダイアログが表示されます。
入力画面に置換したいステップの番号を入力しOKをクリックすると自動でLogフォルダからファイルを取得して置換してくれます。

この時参照するLogフォルダはsettingシートのファイル設定にあるLogフォルダパスで指定します。

また、ファイルを参照ボタンをクリックすれば置換したいinsファイルを自由に選択することが可能です。