LIMS 計算

Vault LIMS では、LAB 結果定義を計算結果として設定し、結果定義で定義した式に従って実行時に結果値を入力することができます。

これらの計算式は、同じLAB 方法内の他の結果、他のLAB 方法の結果、または計算定数の集中リストを参照することができます。静的データ管理者は、まず計算変数を結果定義に追加し、それに応じて他の結果や定数をターゲットにしてから、計算式で参照することでこれを実現します。

計算結果の設定

計算済みのLAB 結果定義を追加するには、次のようにします。

  1. LAB 方法で、数値結果タイプの新しいLAB 結果定義を作成します。
  2. 期待されるデータ入力方法フィールドで、計算を選択します。
  3. 他のフィールドは、計算結果に応じて適切に入力します。
  4. 保存をクリックします。

計算済みのLAB 結果定義に変数を追加するには、次のようにします。

  1. LAB 結果定義レコード詳細ページの計算変数セクションで作成をクリックします。
  2. ドロップダウンからタイプを選択します:
    • メソッドの変数: 変数の値は、同じメソッド内の別の結果から取得されます。
    • クロスメソッド変数: 変数の値は、別の LAB 方法から取得されます。
    • 定数: 変数の値は、Vault の設定済み定数のリポジトリから取得されます。
  3. 名前を入力します。変数の名前の値は、文字と数字のみで、スペースを含めることはできません。
  4. メソッドの変数を作成する場合、現在のLAB 方法で使用可能な他の結果からターゲット結果を選択します。
  5. クロスメソッド変数を作成する場合、結果タイプを選択します。この変数のターゲット結果は、LAB プロトコル内のサンプル定義にLAB 方法を追加する際に決定されます。
  6. 定数を作成する場合、ターゲット定数を選択します。
  7. 保存をクリックします。

変数の作成後、計算式を定義することができます。

LIMS 計算式の定義

LIMS の計算式は、標準的な Vault の計算式の構文に従いますが、以下が追加されます:

  • 変数の名前の前には、必ずドル記号 ($) が付きます。$と入力すると、数式ビルダーに使用可能なすべての変数が表示され、すばやく挿入することができます。
  • 変数タブをクリックすることでも、使用可能なすべての変数を表示することができます。

例えば、($A1 - $B2) / $C3 という式では、変数値 A1 と B2 の差を変数値 C3 で割ることになります。

計算定数

Vault LIMS では、計算変数で使用する定数のセントラルライブラリを管理することができます。計算定数レコードには、1 つ以上の定数値レコードが含まれており、計算式で計算定数を参照したり、Vault LIMS がバッチ上の定数 (グローバルまたは資材) と資材のタイプに応じて適切な定数値を選択することができます。

LAB 計算定数を作成するには、次のようにします:

  1. LAB 計算定数オブジェクトタブに移動します。
  2. 作成をクリックします。
  3. 名前を入力します。
  4. 定数タイプを選択します:
    • グローバル: 単一の定数値を許可します。
    • 材料: 材料ごとの定数値を定義できます。
  5. 保存をクリックします。

定数の作成後、適切な定数値 (1 つまたは複数) を追加します。

定数値

各LAB 計算定数には、計算定数で使用するために少なくとも 1 つの低数値が含まれている必要があります。定数値を作成するには、次のようにします:

  1. LAB 計算定数レコード詳細ページの定数値セクションで作成をクリックします。
  2. 名前を入力します。
  3. 値を入力します。
  4. 材料の定数値を作成する場合、関連する材料レコードを選択します。
  5. 保存をクリックします。

グローバル定数に含まれる定数値は 1 つのみです。材料定数には複数の値を含めることができますが、それぞれを特定の材料レコードに関連付ける必要があります。

定数値のバージョンについて

追跡可能性を確保するために、Vault LIMS は、定数値レコードが編集されるたびに、定数値のバージョンレコードを作成します。Vault LIMS がLAB 結果変数に定数を選択した場合、結果計算に値を渡す際に、定数値バージョンの最新のものが使用されます。LAB テスト作成時の LAB 結果変数は特定のLAB 計算定数値バージョンレコードを対象とするため、現在実行中の LAB テストに影響を与えることなく、定数値レコードの値フィールドを自由に更新することができます。

計算された LAB 結果における変数依存性について

Vault LIMS は、LAB 結果定義から LAB 結果を作成する際に、各LAB 結果定義に添付されている変数に基づいてLAB 結果変数も作成します。これらの LAB 結果変数は、計算に必要な値を含む特定の LAB 結果 (同一の LAB テストまたは別の LAB テストから) または LAB 計算定数をターゲットとしています。

LAB 結果は、LAB サンプルが受信状態タイプになったときにのみ、LAB 方法から LAB テストが、LAB 結果定義から LAB 結果が作成されるため、クロステストの LAB 結果変数は、ターゲットとなる LAB 結果が作成される前に作成される可能性があります。この場合、Vault LIMS は LAB 結果変数を作成し、必要な LAB 結果が最終的に作成された時に、Vault LIMS はそれに応じて LAB 結果変数をターゲットにします。

テスト実行時の計算について

計算された結果値は、LAB テストがレビュー中状態タイプになったときに生成されます。分析者がレビューボタンをクリックすると、Vault は以下を実行します:

  1. 計算式を検証します。
  2. 結果を算出します。
  3. 既存の仕様書条件に照らして結果を評価します。

Vault が計算を解決できない場合、または値を LAB 結果に入力できない場合、システムは LAB 結果のエラー保存フィールドにエラーを取得します。

計算された LAB 結果が必要な場合、その LAB 結果に値が入力されるまで、分析者は LAB テストを完了できません。このような状況が発生した場合、LAB 結果の各変数を確認し、不足がないか、または参照される LAB 結果がテスト完了状態タイプではないかどうかを確認します。

関連権限

計算式を表示および管理するには、ユーザは、LAB 結果定義オブジェクトの計算式オブジェクト管理権限に対するビューへのアクセス権を持つ権限セットが必要です。