Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Automatic detection and subtyping of CRISPR-Cas operons

Project description


Detect CRISPR-Cas genes and arrays, and predict the subtype based on both Cas genes and CRISPR repeat sequence.

CasPredict and RepeatType are also available through a webserver

This software finds Cas genes with a large suite of HMMs, then groups these HMMs into operons, and predicts the subtype of the operons based on a scoring scheme. Furthermore, it finds CRISPR arrays with minced, and using a kmer-based machine learning approach (extreme gradient boosting trees) it predicts the subtype of the CRISPR arrays based on the consensus repeat. It then connects the Cas operons and CRISPR arrays, producing as output:

  • CRISPR-Cas loci, with consensus subtype prediction based on both Cas genes (mostly) and CRISPR consensus repeats
  • Orphan Cas operons, and their predicted subtype
  • Orphan CRISPR arrays, and their predicted associated subtype

It includes the following subtypes:

It can automatically draw gene maps of CRISPR-Cas systems and orphan Cas operons and CRISPR arrays


Coming soon...

Table of contents

  1. Quick start
  2. Installation
  3. CasPredict - How to
  4. RepeatType - How to
  5. RepeatType - Train

Quick start

conda create -n caspredict -c conda-forge -c bioconda -c russel88 caspredict
conda activate caspredict
caspredict my.fasta my_output


CasPredict can be installed either through conda or pip.

It is advised to use conda, since this installs CasPredict and all dependencies, and downloads with database in one go.


Use miniconda or anaconda to install.

Create the environment with caspredict and all dependencies and database

conda create -n caspredict -c conda-forge -c bioconda -c russel88 caspredict


If you have the dependencies (Python >= 3.8, HMMER >= 3.2, Prodigal >= 2.6, grep, sed) in your PATH you can install with pip

python -m pip install caspredict

When installing with pip, you need to download the database manually:

# Download and unpack
svn checkout
tar -xvzf data/Profiles.tar.gz
mv Profiles/ data/
rm data/Profiles.tar.gz

# Tell CasPredict where the data is:
# either by setting an environment variable (has to done for each terminal session, or added to .bashrc):
export CASPREDICT_DB="/path/to/data/"
# or by using the --db argument each time you run CasPredict:
caspredict input.fa output --db /path/to/data/

CasPredict - How to

CasPredict takes as input a nucleotide fasta, and produces outputs with CRISPR-Cas predictions

Activate environment

conda activate caspredict

Run with a nucleotide fasta as input

caspredict genome.fa my_output

Use multiple threads

caspredict genome.fa my_output -t 20

Check the different options

caspredict -h


  • CRISPR_Cas loci, with consensus subtype prediction

    • Contains a consensus prediction (Prediction), and the separate predictions for the Cas operon (Prediction_Cas) and CRISPR arrays (Prediction_CRISPRs)
  • All certain Cas operons

    • Contains a prediction of subtype (Prediction) and the subtype with the highest score (Best_type). If the score is high then Prediction = Best_type
  • All CRISPR arrays

    • Contains a prediction of the associated subtype based on the repeat sequence (Prediction).
    • The 'Subtype' column is the subtype with highest probability. Prediction = Subtype if Subtype_probability is high
  • Orphan CRISPRs (those not in

    • Same columns as
  • Orphan Cas operons (those not in

    • Same columns as
  • Putative CRISPR_Cas loci, often lonely Cas genes next to a CRISPR array

    • Same columns as
  • Putative Cas operons, mostly false positives, but also some ambiguous and partial systems

    • Same columns as
  • spacers/*.fa: Fasta files with all spacer sequences

  • All HMM vs. ORF matches, unfiltered results

  • All genes and their positions

  • File with arguments given to CasPredict

  • hmmer.log Error messages from HMMER (only produced if any errors were encountered)

If run with --keep_tmp the following is also produced
  • prodigal.log Log from prodigal
  • proteins.faa Protein sequences
  • hmmer/*.tab Alignment output from HMMER for each Cas HMM
  • minced.out: CRISPR array output from minced

Notes on output

Files are only created if there is any data. For example, the file is only created if there are any CRISPR-Cas loci.


CasPredict will automatically plot a map of the CRISPR-Cas loci, orphan Cas operons, and orphan CRISPR arrays.

These maps can be expanded (--expand N) by adding unknown genes and genes with alignment scores below the thresholds. This can help in identify potentially un-annotated genes in operons. You can generate new plots without having to re-run the entire pipeline by adding --redo_typing to the command. This will re-use the mappings and re-type the operons and re-make the plot, based on new thresholds and plot parameters.

The plot below is run with --expand 5

  • Cas genes are in red.
  • Cas genes, with alignment scores below the thresholds, are in dark green
  • Unknown genes are in gray (the number matches the file)
  • Arrays are in blue, with their predicted subtype association based on the consensus repeat sequence.

RepeatType - How to

With an input of CRISPR repeats (one per line, in a simple textfile) RepeatType will predict the subtype, based on the kmer composition of the repeat

Activate environment

conda activate caspredict

Run with a simple textfile, containing only CRISPR repeats (in capital letters), one repeat per line.

repeatType repeats.txt


The script prints:

  • Repeat sequence
  • Predicted subtype
  • Probability of prediction

Notes on output

  • Predictions with probabilities below 0.75 are uncertain, and should be taken with a grain of salt.
  • The classifier was only trained on the subtypes for which there were enough (>20) repeats. It can therefore only predict subtypes of repeats associated with the following subtypes:
    • I-A, I-B, I-C, I-D, I-E, I-F, I-G
    • II-A, II-B, II-C
    • III-A, III-B, III-C, III-D
    • IV-A1, IV-A2, IV-A3
    • V-A
    • VI-B
  • This is the accuracy per subtype (on an unseen test dataset):
    • I-A 0.60
    • I-B 0.90
    • I-C 0.98
    • I-D 0.47
    • I-E 1.00
    • I-F 0.99
    • I-G 0.83
    • II-A 0.94
    • II-B 1.00
    • II-C 0.89
    • III-A 0.89
    • III-B 0.49
    • III-C 0.60
    • III-D 0.28
    • IV-A1 0.79
    • IV-A2 0.78
    • IV-A3 0.98
    • V-A 0.77
    • VI-B 1.00

RepeatType - Train

You can train the repeat classifier with your own set of subtyped repeats. With a tab-delimeted input where 1. column contains the subtypes and 2. column contains the CRISPR repeat sequences, RepeatTrain will train a CRISPR repeat classifier that is directly usable for both RepeatType and CasPredict.


repeatTrain my_classifier

Use new model in RepeatType

repeatType repeats.txt --db my_classifier

Use new model in CasPredict

Save the original database files:

mv ${CASPREDICT_DB}/xgb_repeats.model ${CASPREDICT_DB}/xgb_repeats_orig.model

Move the new model into the database folder

mv my_classifier/* ${CASPREDICT_DB}/
CasPredict and RepeatType will now use the new model for repeat prediction!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for caspredict, version 0.5.4
Filename, size File type Python version Upload date Hashes
Filename, size caspredict-0.5.4-py3.8.egg (53.5 kB) File type Egg Python version 3.8 Upload date Hashes View
Filename, size caspredict-0.5.4.tar.gz (25.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page