リファレンスツールリファレンス
USRCAT (RDKit)
USR/USRCAT 形状フィンガープリントで分子の類似度を比較し、大きなライブラリーから詳しく調べる候補を絞ります。
API・CLI のツール ID: usrcat
入力と結果の見方
USRCAT は分子の形と原子の種類ごとの分布を、形状フィンガープリントと呼ばれる短い数値列に要約して比較します。原子を一つずつ重ね合わせる精密なアラインメントを行わず、大きな分子リストから似た候補を素早く絞り込みます。
querySdf には基準分子を 1 つ、libraryFiles には比較対象の分子リストを入れます。どちらも実際の三次元座標を持つ V2000 SDF が必要です。SDF は原子・結合・座標を記録する形式で、拡張子が sdf であるだけでは 3D 構造が準備できているとは限りません。
topN は、すべての入力ファイルを合わせて返す上位候補数です。usrcat_score が 1 に近いほどこのフィンガープリントでは似ていますが、薬効や結合能力が同じという意味ではありません。shape-it とは計算方法が異なるため、スコアの数値を直接比較しません。
入力設定
| 設定 | 形式 | 必須 | 既定値 | 説明と制約 |
|---|---|---|---|---|
querySdf | sdf | 必須 | — | 基準分子1つ — 3D座標を含むV2000 SDF — 拡張子 sdf |
libraryFiles | file | 必須 | — | 検索対象のSDF 1~8個(有限な3D座標のV2000、合計10,000分子以下)。3D表示は構造の物理的妥当性を保証しない — 拡張子 sdf, JSON 配列 |
topN | number | 任意 | 50 | 出力する上位類似分子の数(全ファイル基準) — 最小 1, 最大 10000 |
出力指標
| 列 | 表示名 | 範囲 | 説明 |
|---|---|---|---|
usrcat_score | USRCAT 類似度 | 0~1 | 1に近いほど形状と原子タイプの分布が似ていますが、精密な重ね合わせ、結合の強さ、生物活性を示すものではありません。形状を要約する基準点の選択で原子間に距離の同値があると、座標と結合が同じでもファイル内の原子の記録順によってスコアが変わることがあります。 |
指標の意味と解釈は結果を読み解くを参照してください。範囲は取り得る値を示します。高い方がよいか低い方がよいかは指標によって異なります。
実行可否
プロジェクトの実行計画で、利用できるツールのバージョンと費用を確認できます。入力・設定・利用条件を確認し、承認してから実行します。
ライセンス
コード・モデルの重み・付属データには、それぞれの利用条件が適用されます。以下は公式配布元の条件です。使用する構成の条件は実行計画で確認してください。ライセンス原文は第三者のライセンス告知で確認できます。
| 構成要素 | ライセンス | 商用利用 | 根拠 | 備考 |
|---|---|---|---|---|
| コード | BSD-3-Clause | 告知条件を守れば商用利用可 | ライセンス原文 | USR/USRCAT は RDKit に含まれる機能で、RDKit のライセンスが適用されます。 |
2026-10-26 確認。