リファレンスツールリファレンス

AbLang2 paired

抗体の重鎖と軽鎖の1組を、比較や後続の解析に使う数値ベクトルに変換します。

API/CLI tool ID: ablang2-paired-embedding

入力と結果の見方

抗体の重鎖(heavy chain)と軽鎖(light chain)は異なるタンパク質鎖です。AbLang2 pairedは両方のアミノ酸配列をまとめて読み、480個の数値からなる埋め込み表現に変換します。同じモデルで得た他の組の表現と比較したり、別途学習する分類モデルの入力に使ったりできます。

入力設定

設定は inputFile のみです。以下のオブジェクトを含むUTF-8のJSONファイルを選択します。実行時には単一の入力ファイル input.json として渡されます。1回の実行で受け付けるのは1組です。

以下は形式を示すための合成配列です。実在する抗体や、検証済みの鎖の組ではありません。

{"heavy":"ACDEFGHIKLMNPQRSTVWY","light":"YWVTSRQPNMLKIHGFEDCA"}

heavy と light は両方必須で、それぞれ1~160文字です。使用できる文字は大文字の ACDEFGHIKLMNPQRSTVWY のみです。JSONファイル全体は最大4096バイトです。この長さ制限はサービスの入力方針であり、モデルの最大処理能力や抗体であることを保証するものではありません。

追加のJSONキーや重複キーは受け付けません。

FASTAヘッダー、配列内の空白や改行、小文字、X、*、-、空の鎖、単鎖入力は受け付けません。大文字への変換、空白除去、マスキング、配列アラインメントは自動では行いません。モデル選択やバッチ配列も入力に含めないでください。

元のバイト列と再現性

inputSha256 はJSONを再直列化した値ではなく、アップロードした元のバイト列のSHA-256です。オブジェクトの周囲にあるJSON構文上有効な空白や改行が変わると、配列が同じでもこのハッシュは変わります。後で比較できるよう、元のファイルと結果のモデル・コード・重み情報を一緒に保存してください。

出力ファイル

結果は embedding.json です。

embedding は480個の有限数の配列で、dimension は480です。modelId は ablang2-paired、mode は seqcoding、pooling は upstream-mean-including-special-tokens です。schemaVersion、modelRecord、codeCommit、inputSha256、heavyLength、lightLength、weightsSha256 も記録します。入力配列そのものは結果ファイルに複製しません。

公式実装は配列の組を <heavy>|<light> の形式にし、境界トークン <、> と鎖の区切り | を含めて平均を計算します。これらのトークンを除いた平均、鎖ごとのベクトルを連結した値、別モデルのベクトルと同じ表現として扱わないでください。

結果の解釈と次の解析

個々の値に「高いほど良い」「低いほど良い」という意味はありません。このツールは類似度スコアや分類結果を直接返さないため、比較指標や後続モデルは別途選び、対象の研究データで検証してください。鎖の組み合わせが正しいかどうかも別途確認が必要です。

埋め込み表現は、結合親和性(2つの分子がどれほど強く結合するか)、薬効、成功確率、3次元構造座標ではありません。数値の再計算が一致しても、実際の結合、生物学的機能、臨床効果を証明するものではありません。

実行可否

この案内は実行可能な状態を意味しません。プロジェクトの実行計画で利用できるバージョン・リソース・費用を確認し、入力・設定・利用条件を確認してから承認してください。

ライセンスと提供範囲

Nadoo Bioは管理サーバー上で推論し、結果を提供します。この構成では、コンテナーイメージ・モデルの重み・実行バイナリーを顧客に配布しません。コードのルートライセンスは BSD-3-Clause、pairedの重みの記録では BSD-3-Clause-Clear とされています。それぞれの通知・条件・免責事項を保持します。

BSD-3-Clause-Clear は特許権を付与しません。それ自体が商用利用の禁止を意味するわけではなく、特許上の問題が解消されているという保証でもありません。コード・重み・依存ライブラリーの条件は区別され、上流の著作者による製品の保証や推奨を主張するものではありません。

公式資料

このページの内容