ReferenceAI skillsStructure comparison

Structure comparison

Use to compare two protein structures.

Skill version: 1.0.0. Resource: skill://nadoobio-structure-comparison/SKILL.md.

Checking sources and correspondence

  • For run results, use filenames and SHA-256 from get_result; for stored files, use artifactId, SHA-256, generation, and inspectionVersion from inspect_input. Place the two user-selected sources from the same project in first and second. second is the reference structure.
  • Pass projectId and both sources to preview_structure_comparison. Preview does not save. Do not calculate coordinates directly or supply URLs or arbitrary local paths.
  • For multiple models or chains, use returned lists to clarify the intended selection. Use exact modelKey/chainKey values in firstSelection/secondSelection. start/end are 1-based observed positions, inclusive, not author residue numbers.
  • Narrow regions only when requested. Do not automatically remove high-deviation parts to improve a poor overall comparison. Explain errors for mismatched observed sequences or missing Cα atoms. This version does not automatically align different sequences.

Calculating and saving

  • Read rmsd, pairs, coverage, and residues from ready=true results. Preview metrics are also calculated by the platform.
  • If the user wants to save, share, or reopen the comparison, send the same sources, confirmed selections, and requestId through create_structure_comparison. Retry lost responses with the same requestId and identical request. Do not reuse a key for another comparison.
  • Saving requires jobs:read and files:write. Saving a comparison is not GPU-model execution and needs no GPU-execution approval. For permission errors, check scopes and project access without bypassing them.
  • Then pass projectId and comparisonId to get_structure_comparison and provide the returned comparison-page link. If file access is revoked or source status changes, do not present historical results as currently available.

Interpretation

RMSD is the square root of the mean squared distances between corresponding Cα atoms after rotational/translational alignment. Its unit is Å; lower means closer coordinates. Per-position deviations use the same overall alignment. Report the number of compared positions, selected regions, and excluded positions.

Distinguish coordinate differences, model confidence, and experimental results. Low RMSD does not prove function, binding, or experimental success. Do not treat a structure file's B-factor column as pLDDT without evidence. Matching observed sequences does not imply unobserved residues are biologically absent.

Preserve source hashes, selections, and algorithm versions from the response. For a saved-comparison image, call render_result_view with kind=structure-comparison, projectId, and comparisonId. Provide the PNG image block, comparison values, and link together. The image is a fixed XY projection of aligned coordinates, not a full 3D view; A/B correspond to comparison.first/second. For render.status=unavailable, provide values and links only. sourceSha256, viewSpecSha256, and imageSha256 hash the comparison source, view specification, and PNG bytes respectively. Do not automatically save a new comparison or run a GPU job merely to provide an image.

If the project ID is unknown, discover accessible projects with list_projects, then search stored data with projectId and query q in list_artifacts. Use nextCursor with the same conditions for subsequent pages. Verify data through returned links; neither list membership nor downloadAllowed approves execution suitability.

On this page