hmm_build
Build a profile HMM from aligned sequences on this machine, as HMMER 3.4's hmmbuild builds one: columns whose weighted residue fraction clears symfrac become match states, rows are Henikoff position-based weighted so near-duplicates do not outvote a divergent member, the counts are entropy-weighted down to a target information per position, and the model is calibrated for E-values by hmmbuild's own simulation.
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_build"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| EfL | No | hmmbuild --EfL: their length, in residues. Only applies when calibrate is true. Advanced. | |
| EfN | No | hmmbuild --EfN: random sequences the Forward fit is made over. Only applies when calibrate is true. Advanced. | |
| Eft | No | hmmbuild --Eft: the tail mass the Forward exponential is fitted to. Only applies when calibrate is true. Advanced. | |
| EmL | No | hmmbuild --EmL: their length, in residues. Only applies when calibrate is true. Advanced. | |
| EmN | No | hmmbuild --EmN: random sequences the MSV fit is made over. Only applies when calibrate is true. Advanced. | |
| EvL | No | hmmbuild --EvL: their length, in residues. Only applies when calibrate is true. Advanced. | |
| EvN | No | hmmbuild --EvN: random sequences the Viterbi fit is made over. Only applies when calibrate is true. Advanced. | |
| ere | No | hmmbuild --ere: the target mean relative entropy in bits per position. 0 takes hmmbuild’s alphabet default (0.59 protein, 0.62 nucleic). Only applies when effn is entropy. | |
| effn | No | `entropy` scales the counts until the model carries `ere` bits per position, which makes it a family model rather than a memory of this alignment; `none` uses the rows as counted; `set` uses `eset`. Values: entropy (Entropy-weighted), none (Actual count), set (Fixed (eset)). | entropy |
| eset | No | hmmbuild --eset: the effective sequence count to use. Only applies when effn is set. | |
| name | No | the model’s name, written on its NAME line. | profile |
| seed | No | hmmbuild --seed: the simulation is reproducible, and the same seed gives the same statistics. Only applies when calibrate is true. | |
| _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. | |
| esigma | No | hmmbuild --esigma: the entropy target’s small-model correction. 0 takes hmmbuild’s default. Only applies when effn is entropy. Advanced. | |
| symfrac | No | hmmbuild --symfrac: a column becomes a match state when this weighted fraction of rows carry a residue there rather than a gap. | |
| _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 | `auto` reads the rows the way Easel does. Set it when a short alignment is read wrongly. Values: auto (Auto (Easel’s rule)), amino (Protein), DNA (DNA), RNA (RNA). Advanced. | auto |
| alignment | No | the aligned rows as `{ name, aligned }`, gaps included: wire align_sequences’ `alignedSequences` here. Rows of different lengths are refused as unaligned. | |
| calibrate | No | fit E-value statistics by simulation, as hmmbuild does. Off, the model has bit scores and no E-values, and hmmscan refuses it. | |
| weighting | No | `pb` is Henikoff position-based weighting (hmmbuild’s default), so twenty near-identical rows do not outvote one divergent member; `none` counts every row once. Values: pb (Position-based (Henikoff)), none (Equal). | pb |
| fragthresh | No | hmmbuild --fragthresh: a row spanning less than this fraction of the alignment is a fragment, and its leading and trailing gaps are read as missing data rather than deletions. | |
| alignment_file | No | or an alignment file, by name, from the project or the `_files` sent with the call: Stockholm, Clustal, PHYLIP, MSF or aligned FASTA, read by the same reader the alignment tab opens it with. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hmm | Yes | the model as HMMER3/f text: wire it into hmm_search’s `profile_text`, or keep it as a `.hmm` | |
| stats | Yes | the fitted MSV, Viterbi and Forward mu and lambda; absent when calibration was off | |
| profile | Yes | the model built: name, match states, alphabet, effective sequence count, whether it carries E-value statistics | |
| weights | Yes | each row’s relative weight, in input order | |
| fragments | Yes | rows the fragment rule treated as partial sequences | |
| matchColumns | Yes | the alignment columns that became match states, 1-based | |
| meanRelativeEntropy | Yes | mean relative entropy per match state, in bits (hmmbuild’s re/pos) |