Compare Proteins Topologically (TDA Fingerprint Distance)
compare_proteins_topologicallyCompares 2–10 proteins via a TDA fingerprint distance metric and returns a pairwise distance matrix showing how divergent their fingerprints are.
Instructions
Compare multiple proteins using a TDA-fingerprint distance.
Computes a pairwise distance matrix between the TDA fingerprints of
the provided proteins. Distance metric: L2 distance between
length-normalised 64-slot fingerprint vectors (see
_fingerprint_distance). Distance = 0 means identical
fingerprints; larger values mean more divergent fingerprints. This
is not a Wasserstein distance between persistence diagrams.
The vectors hold at most 16 statistics (see
compute_topology_fingerprint). With GUDHI (the optional [tda]
extra), a model longer than 500 residues is compared on
500 evenly spaced Cα atoms. Without GUDHI the fallback uses every
residue of every model, with no subsampling, and builds each model's
full pairwise distance matrix, so its cost grows with the square of
the model length. protein_metadata reports n_residues_used and
subsampled for each model. In an internal audit of 23 AlphaFold
models run with GUDHI, nearly all of each normalised vector lay in
its two total-persistence components, so the distance mostly tracks
one ratio: total H1 over total H0 persistence. It has no validated
threshold for fold similarity and is not a functional,
sequence-similarity or binding-site measure (LIMITATIONS.md L12).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"params": "<params>"
},
"name": "compare_proteins_topologically"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||