Pocket Similarity Search finds binding sites similar to a query pocket, in all public and in-house structures and AlphaFold models. The query can be a whole pocket or a few residues (a subpocket). Use it to:
This page describes 3decision 2.5. In 2.4, the search opens in a dialog instead of the left-hand panel, and these options are not available: custom residues from a Workspace structure, Maximum number of results, the Protein family filter and See query details. The search algorithm also differs: candidate ranking, which finds the closest matches first, was added in 2.5. See the 2.5 release notes.
To learn how pockets are compared and scored, see How pocket similarity search works.
| From | How |
|---|---|
| A structure in the Workspace | Structure Action menu (⋮ on the structure row) → Find similar pocket. |
| A pocket in the pocket table | Open the pocket table (Show Pockets), then the row's ⋯ menu → Find similar pocket. |
| A structure file | Home page → Pocket Similarity From File. Use this for structures that are not registered in 3decision. |
Find similar pocket replaces the Collections panel with the Pocket Similarity Search panel, so the structure stays visible in the 3D viewer. Back to Collections closes it.
| Mode | Description |
|---|---|
| Detected pocket | Pick one of the pockets that 3decision detected. Each card shows the pocket number, its ligand code (or APO if it has no ligand), druggability, number of residues and volume. Its residues are listed under Pocket residues and selected in the 3D viewer. |
| Custom residues | Define your own query, for example a subpocket. Paste residues (for example A:48) and press Enter or click Parse, or click residues in the 3D viewer. At least 3 residues. Clear empties the list. |
| Setting | Default | Description |
|---|---|---|
| Collection name | Structure, pocket and threshold, for example "4egk (Pocket 13) - Matching ratio: 0.2" | Name of the result collection. You can edit it. |
| Match score threshold | 0.2 | From 0.1 to 1. Only pockets with a score at or above it are returned. Lower values return more, looser matches. |
| Pockets with ligands only | On | Only searches pockets that contain a ligand. Turn it off to include apo pockets, for example to look for off-targets. |
| Best match per protein only | Off | Keeps one hit per protein. Use it to compare across targets rather than within one. |
| Maximum number of results | 500, or 20 with Best match per protein only | The search stops when it has found this many hits. The closest matches are found first. |
Each filter has Include (return only results in the list) and Exclude (leave them out).
| Filter | Values |
|---|---|
| Filter by species | Pick common species, or type a species and press Enter. You can paste several lines at once. |
| Filter by protein | UniProt accessions or names. Press Enter after each one. |
| Filter by structure | PDB or 3decision codes. Press Enter after each one. |
| Filter by protein family | MOE protein family names. Type at least 3 characters to search. |
Click Search to start, or Cancel to close the panel.
Pocket Similarity From File opens a 3-step page:
.pdb, .cif or .mmCIF file.The results appear as a new collection in the Workspace, tagged Pocket Search, with the number of results.
Closing the browser tab or removing the collection doesn't stop the search.
| Element | Description |
|---|---|
| Score | Similarity to the query, from 0 to 1. Hits are sorted by score. |
| Eye icon | Shows the hit in the 3D viewer, superposed on the query pocket. The lining residues of the matching pocket are shown as sticks. |
| Superposition icon | Shows that the hit is superposed with the search's own rule ("Matching reference superpose rule"). |
| i | Opens the Information Browser. |
The Ligands tab shows the ligands of the matching pockets only.
The ⋮ menu of the result collection has:
Download all hits with Download collection. To download only some hits, click Select at the top of the Collections panel, tick the hits, then use the Actions menu of the selection. Include the query structure if you want it in the files.
| Format | Content |
|---|---|
Structure table (.csv, .xlsx) |
The hits with their score and properties such as title and resolution. |
Superposed structures (.zip of .pdb or .mmcif) |
The hit structures in the coordinate frame of the query. You don't need to show them first. |
Superposed ligands (.sdf) |
The ligands of the hits, in the same superposed coordinates. |
Depending on your filters, the query structure may not be among the hits.
Results are not saved when you reload the page. To keep them, add the hits to a project or download them.
Call DELETE /queues/subpocketSearch/jobs/{job_id} with the job ID returned when the search started. To check whether a job is still active, call GET /queues/subpocketSearch/jobs/{job_id}/state. See also Pocket similarity search with the API.
See How pocket similarity search works.