design_codon_tiling_primers
Codon-tiling mutagenesis primers for a whole CDS: one primer per codon, each carrying a degenerate codon (NNN/NNK/NNS/NNC/NNG) at its centre, with the flanks grown or shrunk so every primer lands inside a Tm window (jbloomlab CodonTilingPrimers).
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": "design_codon_tiling_primers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cds | No | the CDS to tile, in frame. Left empty the record's `cds_feature`, or the selection, is tiled and the flanking bases come from the record around it. | |
| _files | No | The project: record references shaped like _subject. Their records become library documents a tool names in sequences/parts/document; a trace or alignment is found by file name. | |
| flanks | No | with a literal `cds`: the bases either side of it, as `5'flank,3'flank`. Upstream anneals every primer in these, so without them a tiled primer has nothing to grow into — give at least `(primer_length - 3) / 2` bases per side. Advanced. | |
| prefix | No | prefix for the generated primer names. Advanced. | tile |
| _subject | No | The record to act on: exactly one of sequence, accession (+source), sample (an id from list_samples) or file ({name, text} or {name, base64}); record_index picks one record of several. | |
| tm_model | No | Tm scale the window is judged on. Upstream tiles against Biopython's nearest-neighbour Tm, which is `santalucia` here. Values: santalucia (SantaLucia nearest-neighbor (Biopython Tm_NN defaults)), wallace (Wallace rule (4 °C per G·C, 2 °C per A·T)), gc:Chester_1993 (GC formula: Marmur-Doty (Chester & Marshak 1993)), gc:QuickChange (GC formula: QuikChange (the kit manufacturer’s own formula)), gc:Schildkraut_1965 (GC formula: Schildkraut & Lifson 1965 (Marmur-Doty + log[Na⁺])), gc:Wetmur_Melting_1991 (GC formula: Wetmur 1991, DNA (MELTING 4.3 approximate mode)), gc:Wetmur_RNA_1991 (GC formula: Wetmur 1991, RNA), gc:Wetmur_DNA_RNA_1991 (GC formula: Wetmur 1991, RNA/DNA hybrid), gc:Primer3 (GC formula: Primer3Plus product Tm (Biopython’s default set)), gc:Ahsen_2001 (GC formula: von Ahsen 2001 (accuracy against ease of use)). | santalucia |
| max_length | No | longest primer it may grow to. In nt. Advanced. | |
| min_length | No | shortest primer the flank search may shrink to. In nt. Advanced. | |
| cds_feature | No | tile this annotated CDS of the open record by NAME, on its own strand, exactly as `codon_usage_analysis` takes one. The flanks come from the record either side of it. | |
| first_codon | No | the number given to the first codon in primer NAMES. Set it when the CDS you are tiling starts part-way through a protein. Advanced. | |
| max_primer_tm | No | highest acceptable primer Tm; must be above `min_primer_tm`. In °C. | |
| min_primer_tm | No | lowest acceptable primer Tm. In °C. | |
| primer_length | No | starting primer length, in bases. Must be ODD: the flanks are (n-3)/2 per side. Upstream's own default. In nt. | |
| ambiguous_codon | No | the degenerate codon installed at every position. NNK and NNS halve the stop codons NNN introduces; NNC and NNG are narrower still. | NNN |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | primers designed, which is the number of codons tiled | |
| codons | Yes | codons in the tiled CDS | |
| primers | Yes | one row per codon: name, seq (with the degenerate codon at its centre), length, tm, codonIndex, and `start`, the 0-based offset in the tiled string | |
| tmRange | Yes | the lowest and highest Tm actually achieved, against the window asked for: `{ min, max, wanted: { min, max } }` | |
| outsideWindow | Yes | primers whose Tm the flank search could not bring inside the window within the length limits. Reported rather than dropped |