Formula Editor

概要と開発の背景

ブレーキ、センサー、制御ループの要件には、制動距離、公差、フィルターなどの数式がよく必要になります。DOORS Next には数式エディターがありません。チームは Word のスクリーンショットを貼り付けますが、元のファイルがなければ後から誰も変更できません。あるいは数式をプレーンテキストで入力しますが、読みにくくなります。

Formula Editor を使うと、DOORS Next の中で LaTeX で数式を書けます。入力に合わせて数式を描画し、選択した成果物の後の新しい成果物、または選択した成果物に、画像としてモジュールに配置します。LaTeX は成果物と一緒に保存されるため、後でその数式を選択するとエディターで再び開きます。

解決する課題

• スクリーンショットとして貼り付けた数式は、元の Word ファイルがなければ誰も変更できない。
• s = v^2/(2*mu*g) のようにプレーンテキストで入力した数式は、レビューやエクスポートで読みにくい。
• どちらかを手作業で変更した後、数式の画像とテキストが一致しなくなる。
• 数式を追加・変更するたびに別のツールに切り替え、画像をコピーして戻す必要がある。

メリット

• 入力しながら確認： 書いている間にプレビューが数式を描画し、画像のサイズを表示します。
• 後から変更可能： LaTeX が成果物に保存されるため、数式を選択すると再び開き、Update で新しい画像を描画します。
• テキストはそのまま： テキストのある成果物で Update を実行すると、数式はテキストの後に追加され、文言は残ります。
• 外部の Web サイト不要： 数式は MathJax によりブラウザー内で描画され、オンラインエディターには送信されません。
• エラーの位置を表示： 閉じ括弧の不足や不明なコマンドは、フィールドの下に該当する文字の位置とともに表示されます。

使い方

1. モジュールを開き、成果物を 1 つ選択します。
2. LaTeX で数式を入力するか、フィールドの下のキー（分数、根号、べき乗、添字、総和、積分、ギリシャ文字、プラスマイナス、行列）をクリックします。More symbols でさらに 21 個の記号が表示されます。プレビューに画像とそのサイズが表示されます。
3. Insert をクリックすると選択した成果物の後の新しい成果物に数式を追加し、Update をクリックすると選択した成果物に書き込みます。確認の内容を読んで Insert formula または Update formula をクリックします。
4. 結果ブロックに実行内容が表示され、Log で変更レポートをダウンロードできます。
5. 数式を変更するには、モジュールでその数式を選択します。ウィジェットで開くので（Editing 1531 …）、LaTeX を変更して Update をクリックします。

知っておきたいこと

• 変更セットの中で作業してください。結果が意図どおりでなければ、変更セットを破棄できます。新しい成果物はすぐに保存されます。
• 画像は DOORS Next サーバーに保存される PNG で、2 倍のサイズで描画されるため、画面上でもエクスポートでも鮮明です。Settings には S、M、L の 3 つのサイズがあります。
• プロジェクトに Formula という名前の属性がある場合、LaTeX はその属性に入り、さらに常に画像の説明にも入ります。そのため、この属性のないプロジェクトでも数式を再び開けます。
• 新しい成果物には、選択した成果物のタイプが使われます。Settings で Insert 用にプロジェクトの別の成果物タイプを選べ、ウィジェットはプロジェクトごとにそれを記憶します。Update ではタイプは変わりません。
• 数式の画像が手作業で差し替えられている場合、ウィジェットがそのことを示し、Update の確認で変更が失われることを警告します。常に LaTeX が優先されます。