hmm_search
Score sequences against ONE profile HMM on this machine, as hmmsearch scores a family against a set: per sequence a Forward and a Viterbi bit score, an E-value when the model is calibrated, every domain with its model and sequence span and its three-line alignment, and the family's own gathering-cutoff verdict when the model publishes one (Pfam does).
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": "hmm_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Z | No | the database size each E-value is scaled by. 0 takes the number of sequences screened, which is what hmmsearch does with the database it searched; set it to compare against a larger search. | |
| mode | No | `local` finds the model anywhere in a sequence, as hmmsearch does: right for a domain inside a longer protein. `glocal` makes the whole model align, which a full-length member of the family can and a fragment cannot. Values: local (Local (hmmsearch)), glocal (Glocal (whole model)). | local |
| pfam | No | a Pfam accession (PF and five digits): the family’s current HMM is fetched from InterPro for this run. Its gathering cutoff comes with 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. | |
| profile | No | the `.hmm` file to score against, by name, from the project or the `_files` sent with the call. Left empty with no `profile_text` or `pfam`, the one `.hmm` present is used, and several are refused by 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. | |
| alphabet | No | what the sequences are. `auto` reads them the way HMMER does (Easel’s composition rule). Set it when a short or unusual set is read wrongly: every DNA base is also an amino-acid letter, so a nucleotide set against a protein model scores without complaint and means nothing. Values: auto (Auto (Easel’s rule)), protein (Protein), nucleotide (Nucleotide). Advanced. | auto |
| multihit | No | allow several separate domains in one sequence (the J state). Off allows one: right when a family occurs once per protein. | |
| sequences | No | the sequences to screen: wire upstream records or sequences, or list library documents. A multi-record file named whole contributes every record. Gaps are removed before scoring. | |
| profile_text | No | the model itself as HMMER3 text; wire `hmm_build`’s `hmm` here to screen with a model you just built. Advanced. | |
| include_subject | No | also screen the open or wired record (a protein record by its residues). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes | one row per sequence, best Forward score first: name, length, forwardBits, viterbiBits, forwardEvalue (absent for an uncalibrated model), membership against the gathering cutoff, and each domain’s seqFrom/seqTo (1-based) and hmmFrom/hmmTo with its alignment | |
| count | Yes | sequences screened | |
| members | Yes | sequences at or above the family’s gathering cutoff (0 when the model publishes none) | |
| profile | Yes | the model screened against: name, accession, match states, alphabet, cutoffs, whether it carries E-value statistics |