search_off_targets
Search a sequence for sites a guide could also cut, allowing mismatches, and score each one (MIT and CFD) plus the aggregate specificity of the guide WITHIN that sequence. This is specificity against what you searched — it is not a genome-wide score, and it says so rather than inventing one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | cap the rows returned (hits come back worst-first: fewest mismatches). 0 = all. Advanced. | |
| _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. | |
| spacer | Yes | the protospacer to search for (20 nt for SpCas9). | |
| subject | No | the sequence to search — wire a record or name a library document; leave unset to search the open record. | |
| _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. | |
| circular | No | search across the origin as well. Advanced. | |
| nuclease | No | which nuclease's PAM and geometry to use. Values: SpCas9 (SpCas9: NGG (3')), SpCas9-NG (SpCas9-NG: NG (3')), SpG (SpG: NGN (3')), SpRY (SpRY: NRN (3')), xCas9 (xCas9: NG (3')), SaCas9 (SaCas9: NNGRRT (3')), SaCas9-KKH (SaCas9-KKH: NNNRRT (3')), AsCas12a (AsCas12a: TTTV (5')), LbCas12a (LbCas12a: TTTV (5')), enAsCas12a (enAsCas12a: TTTV (5')). | SpCas9 |
| dna_bulge | No | extra bases in the DNA a site may carry (a gap opened in the guide). 0 searches mismatches only. The ceiling is the width a golden oracle covers, and a bulged hit outside that envelope reports `validated: false` for itself. In nt. Advanced. | |
| rna_bulge | No | extra bases in the guide a site may carry (a gap opened in the DNA). Same envelope as `dna_bulge`. In nt. Advanced. | |
| max_mismatches | No | how many mismatches a site may carry and still be reported. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes | each candidate site: position, strand, mismatches, the PAM found, and its MIT/CFD scores | |
| total | Yes | sites found before `limit` was applied | |
| scored | Yes | false when this nuclease has no published MIT/CFD model — the hits are still real, the scores are absent | |
| byMismatch | Yes | how many sites carry 0, 1, 2 … mismatches — the census a specificity read needs | |
| cfdSpecificity | Yes | aggregate CFD specificity within the searched sequence, 0-100: the same Hsu-form aggregate over each site's CFD score (null when the nuclease geometry is unscored) | |
| mitSpecificity | Yes | aggregate MIT specificity within the searched sequence, 0-100 (null when the nuclease geometry is unscored) |