build_codon_table_from_cds
Build a codon-usage table from a genome's CDS FASTA (an NCBI cds_from_genomic.fna): either from its highly-expressed genes — the ribosomal proteins, which is what a codon-optimisation reference table means — or from every CDS in the genome.
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": "build_codon_table_from_cds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | the CDS FASTA to read, by name, from the project or the `_files` sent with the call. Empty reads the only FASTA there. | |
| mode | No | `heg` builds the table from the ribosomal-protein genes, which is the reference set a codon-optimisation table means. `genome` uses every CDS, which is the honest choice for a plasmid or any corpus whose highly-expressed genes are not in it. Values: heg (Highly-expressed genes (ribosomal proteins)), genome (Every CDS in the corpus). | heg |
| fasta | No | or the CDS FASTA itself, in frame, one record per CDS. | |
| _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. | |
| _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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gc3 | Yes | GC at the third codon position of the reference set, the usual summary of a genome’s codon bias | |
| tsv | Yes | the usage table as a Kazusa-style TSV — wire it into optimize_sequence, codon_usage_analysis or design_expression_variants | |
| mode | Yes | which reference set this table was built from | |
| codons | Yes | codons counted | |
| cdsUsed | Yes | CDS records that went into the table | |
| cdsTotal | Yes | CDS records read from the corpus | |
| backfilled | Yes | amino acids absent from the highly-expressed set, taken from the whole genome instead. Empty in genome mode |