covnmr_rank_candidates
Rank several candidate structures against one measured spectrum.
Candidates: `candidates` (list of SMILES), `candidates_csv`
("CCO,CC(=O)O") or `candidates_json`. Spectrum: `path`, else a peak list
(`peaks` / `peaks_json`, `experiments` / `experiments_json`).
GIVE `path` IF YOU HAVE THE FILE: only the file makes the second axis --
overlap of each candidate's full predicted curve with the measured one --
available. Measured on a real 13C APT of a triterpene, the correct
structure ranked first on both axes against n-hexadecane and glucose
(curve 0.37 vs 0.06/0.08). With `path` the order is the curve axis and each
row says whether the peak axis agrees (`agreement`); with a peak list only,
the order is the evidence log-likelihood ratio. The peak axis DECLINES --
`ranking_basis` "declined_unassessable_peak_list", every `rank` null --
when a candidate's evidence cannot be computed (19F/31P, fallback
predictor). Read `ranking_basis` before `ranked`: a null `rank` is the tool
declining to answer, not a tie.
Capped at `max_candidates` (50). With `path` the file decides nucleus,
solvent and field (`nucleus_source`). Multi-step: confirm the winner with
covnmr_verify, or covnmr_sudoku when you have 2D data.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "covnmr_rank_candidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | ||
| peaks | No | ||
| api_key | No | ||
| nucleus | No | ||
| solvent | No | CDCl3 | |
| field_mhz | No | ||
| candidates | No | ||
| peaks_json | No | ||
| experiments | No | ||
| tolerance_ppm | No | ||
| candidates_csv | No | ||
| max_candidates | No | ||
| candidates_json | No | ||
| experiments_json | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |