リファレンス自動化リファレンス

入力検証結果の読み方

エラー位置、配列の正規化、実行可否を区別して説明します。

validate_input は選択したツールの入力条件を検査します。valid: false は条件を満たさなかったという結果で、検証 API の障害ではありません。valid: true でも実行の許可や科学的な正確さが確認されたわけではありません。実行可否は list_execution_options で別途確認します。

原入力と正規化

成功応答の normalized は既定値とモデルごとの正規化を反映した入力で、notes に関連する案内があります。失敗応答には実行に使える normalized はありません。検証を通すために原入力を勝手に変えないでください。

sequenceDiagnostics は実際に検査した配列フィールドの文字診断です。最初のフィールドエラーで検査が終わる場合があるため、一覧にないフィールドが正常とは限りません。複合体の分子配列全体を検査した一覧でもありません。

  • field — 検査した入力フィールド名。

  • positionBasis — 空白を除いた原文の Unicode 文字位置。1から数え、鎖区切りの : も1文字に数えます。

  • caseConversion — none は大文字・小文字を自動変換しないことを示します。

  • whitespaceRemoved — 検査前に空白を除去したかどうか。

  • unknownResiduePolicy — ツールの X の処理規則。alphabet なら許容文字の一覧で判定します。

  • allowedAlphabet — この配列フィールドで使える文字。

  • removedUnknownResidues — 正規化候補から除去される X の総数と原文の位置。

  • invalidResidues — 未対応文字の総数・文字・原文の位置。

各位置一覧は最大100件です。count は総数で、truncated が true ならすべての位置は一覧に含まれていません。この位置番号は構造ファイルの残基番号とは異なります。

X が除去される場合

X はアミノ酸の種類が不明な位置を表します。X-stripped はその位置を除去し、X-allowed は X を残します。除去後は配列長と位置の対応が変わります。X-reject は X を含む入力を拒否します。

説明用の例として、X を除去するツールで AX C を検証すると正規化結果は AC となり、除去位置は空白を除いた原文の2番目です。AXBO は X の除去候補を示しても、他の未対応文字で全体の検証が失敗する場合があります。その部分的な正規化候補を実行に使わないでください。

エラーの文字は原資料で確認します。確認していない文字を置き換えたり削除したりしないでください。未対応文字がある場合は、その文字に対応した別のツールを確認します。確認できなければ実行を保留します。

このページの内容