shape-it
Find candidates with shapes similar to a reference molecule by overlaying 3D shapes represented with Gaussian functions.
API/CLI tool ID: shape-it
Understanding inputs and outputs
shape-it overlaps the three-dimensional shapes of reference and candidate molecules to measure similarity. Unlike docking, which searches for poses against a protein, its inputs are one reference molecule and a candidate collection. USRCAT compares shape summaries, whereas shape-it calculates overlap of the shapes themselves.
Supply V2000 SDF files with three-dimensional coordinates in refLigandSdf and libraryFiles. maxHits limits the top candidates returned from the entire collection, not from each file. Different input 3D conformations of the same molecule can produce different similarity results.
shape_tanimoto measures overlap between the two molecular shapes; tversky_ref gives greater weight to the reference molecule. A high tversky_ref can occur even when the candidate is much larger, so it does not imply the same overall size and shape. Neither score measures actual binding or biological activity.
Input settings
| Setting | Format | Required | Default | Description and constraints |
|---|---|---|---|---|
refLigandSdf | sdf | Required | — | One reference (query) molecule: a V2000 SDF with 3D coordinates — Extensions sdf |
libraryFiles | file | Required | — | 1-8 library SDF files to search (V2000 with 3D coordinates, at most 10,000 molecules in total). All files are searched together for the top hits — Extensions sdf, JSON array |
maxHits | number | Optional | 100 | Number of top similar molecules to return (across all files) — Minimum 1, Maximum 10000 |
Output metrics
| Column | Display name | Range | Description |
|---|---|---|---|
shape_tanimoto | shape Tanimoto | 0~1 | Gaussian shape (volume) overlap score: higher means more similar shapes. Not binding affinity or activity. |
tversky_ref | Tversky (ref) | 0~1 | Tversky overlap score calculated relative to the reference molecule. |
See Reading results for metric definitions and interpretation. A range shows possible values; whether higher or lower is better depends on the metric.
Execution availability
Open an execution plan in your project to see available tool versions and costs. Review and approve the inputs, settings, and terms before running.
License
Code, model weights, and accompanying data have their own terms. The table summarizes terms from official sources; check your execution plan for the configuration you will use. License texts are available in Third-party notices.
| Component | License | Commercial use | Source | Notes |
|---|---|---|---|---|
| Code | MIT | Allowed, subject to notice requirements | License text | — |
| Code | GPL-2.0-only | Conditional; see notes | License text | The executable links to OpenBabel (GPL-2.0). Distributing it or its container to customers is subject to GPL notice and source-code requirements. |
The main source code uses MIT, but the executable built with OpenBabel is subject to GPL terms.
Checked on 2026-10-26.