orfipy is a tool written in python/cython to extract ORFs in an extremely and fast and flexible manner

Overview

Build Status PyPI - Python Version install with bioconda install with bioconda PyPI Downloads publication

Introduction

orfipy is a tool written in python/cython to extract ORFs in an extremely and fast and flexible manner. Other popular ORF searching tools are OrfM and getorf. Compared to OrfM and getorf, orfipy provides the most options to fine tune ORF searches. orfipy uses multiple CPU cores and is particularly faster for data containing multiple smaller fasta sequences such as de-novo transcriptome assemblies. Please read the paper here.

Please cite as: Urminder Singh, Eve Syrkin Wurtele, orfipy: a fast and flexible tool for extracting ORFs, Bioinformatics, 2021;, btab090, https://doi.org/10.1093/bioinformatics/btab090

Installation

Install latest stable version

pip install orfipy

Or install via conda

conda config --add channels defaults
conda config --add channels bioconda
conda config --add channels conda-forge

conda create -n orfipy -c bioconda orfipy

Install the development version from source

git clone https://github.com/urmi-21/orfipy.git
cd orfipy
pip install .

or use pip

pip install git+git://github.com/urmi-21/orfipy.git

Examples

Details of orfipy algorithm are in the paper. Please go through the SI if you are interested to know differences between orfipy and other ORF finder tools and how to set orfipy parameters to match the output of other tools.

Below are some usage examples for orfipy

To see full list of options use the command:

orfipy -h

Input

orfipy version 0.0.3 and above, supports sequences in Fasta/Fastq format (orfipy uses pyfastx). Input files can be in .gz format.

Extract ORF sequences and write ORF sequences in orfs.fa file

orfipy input.fasta --dna orfs.fa --min 10 --max 10000 --procs 4 --table 1 --outdir orfs_out

Use standard codon table but use only ATG as start codon

orfipy input.fa.gz --dna orfs.fa --start ATG

Note: Users can also provide their own translation table, as a .json file, to orfipy using --table option. Example of json file containing a valid translation table is here

See available codon tables

orfipy --show-table

Extract ORFs BED file

orfipy input.fasta --bed orfs.bed --min 50 --procs 4
or
orfipy input.fasta --min 50 --procs 4 > orfs.bed 

Extract ORFs BED12 file

Note: Add --include-stop for orfipy output to be consistent with Transdecoder.Predict output .bed file.

orfipy testseq.fa --min 100 --bed12 of.bed --partial-5 --partial-3 --include-stop

Extract ORFs peptide sequences using default translation table

orfipy input.fasta --pep orfs_peptides.fa --min 50 --procs 4

API

Users can directly import the ORF search algorithm, written in cython, in their python ecosystem.

>>> import orfipy_core 
>>> seq='ATGCATGACTAGCATCAGCATCAGCAT'
>>> for start,stop,strand,description in orfipy_core.orfs(seq,minlen=3,maxlen=1000):
...     print(start,stop,strand,description)
... 
0 9 + ID=Seq_ORF.1;ORF_type=complete;ORF_len=9;ORF_frame=1;Start:ATG;Stop:TAG

orfipy_core.orfs function can take following arguments

  • seq: Required input sequence (str)
  • name ['Seq'] Name (str)
  • minlen [0] min length (int)
  • maxlen [1000000] max length (int)
  • strand ['b'] Strand to use, (b)oth, (f)wd or (r)ev (char)
  • starts [['TTG','CTG','ATG']] Start codons to use (list)
  • stops=['TAA','TAG','TGA'] Stop codons to use (list)
  • include_stop [False] Include stop codon in ORF (bool)
  • partial3 [False] Report ORFs without a stop (bool)
  • partial5 [False] Report ORFs without a start (bool)
  • between_stops [False] Report ORFs defined as between stops (bool)

Comparison with getorf and OrfM

Comparison of orfipy features and performance with getorf and OrfM. Tools were run on different data and ORFs were output to both nucleotide and peptide Fasta files (fasta), only peptide Fasta (peptide) and BED (bed). For details see the publication and SI

  • orfipy is most flexible, particularly faster for data containing multiple smaller fasta sequences such as de-novo transcriptome assemblies or collection of microbial genomes.
  • OrfM is fast (faster for Fastq), uses less memory, but ORF search options are limited
  • getorf is memory efficient but slower, no Fastq support. Provides some flexibility in ORF searches.

Funding

This work is funded in part by the National Science Foundation award IOS 1546858, "Orphan Genes: An Untapped Genetic Reservoir of Novel Traits". This work used the Extreme Science and Engineering Discovery Environment (XSEDE), which is supported by National Science Foundation grant number ACI-1548562 (Bridges HPC environment through allocations TG-MCB190098 and TG-MCB200123 awarded from XSEDE and HPC Consortium).

Comments
  • Compatibility with lower-case fasta sequences (A weird bug)

    Compatibility with lower-case fasta sequences (A weird bug)

    Hello Urminder!

    Something strange happens to me when I try to run orfipy with a particular genome.

    At the end of the program, it does not return the predicted ORFs.

    $ orfipy cdiff.fasta orfipy version 0.0.3 Using translation table: Standard (transl_table=1) start: ['TTG', 'CTG', 'ATG'] stop: ['TAA', 'TAG', 'TGA'] Setting chunk size 714 MB. Procs 45 Logs will be saved to: orfipy_cdiff.fasta_out/orfipy_2021_03_04_13_16_06.031643.log Processing 8597268 bytes Processed 1 sequences in 0.39 seconds

    I tested using prodigal and it works without problems. Is the only genome that I have this problem and I can't understand why.

    Can you reproduce the error? Best regards! Enzo.

    cdiff.fasta.gz

    opened by EnzoAndree 7
  • cannot install from bioconda

    cannot install from bioconda

    I created a new environment to install orfipy, but still have conflicts error.

    Collecting package metadata (current_repodata.json): done
    Solving environment: failed with initial frozen solve. Retrying with flexible solve.
    Solving environment: failed with repodata from current_repodata.json, will retry with next repodata source.
    Collecting package metadata (repodata.json): done
    Solving environment: failed with initial frozen solve. Retrying with flexible solve.
    Solving environment: |
    Found conflicts! Looking for incompatible packages.
    This can take several minutes.  Press CTRL-C to abort.
    failed
    
    UnsatisfiableError:
    
    opened by lijing28101 5
  • conda installation issue

    conda installation issue

    Hi,

    Small thing, when running orfipy on a gzip fastq file I ran into this:

    Traceback (most recent call last):
      File "/home/ben/e/orfipy-0.0.2/bin/orfipy", line 11, in <module>
        sys.exit(main())
      File "/home/ben/e/orfipy-0.0.2/lib/python3.8/site-packages/orfipy/__main__.py", line 338, in main
        orfipy.findorfs.main(infile,
      File "/home/ben/e/orfipy-0.0.2/lib/python3.8/site-packages/orfipy/findorfs.py", line 479, in main
        seqs = Fasta(infasta)
      File "/home/ben/e/orfipy-0.0.2/lib/python3.8/site-packages/pyfaidx/__init__.py", line 996, in __init__
        self.faidx = Faidx(
      File "/home/ben/e/orfipy-0.0.2/lib/python3.8/site-packages/pyfaidx/__init__.py", line 354, in __init__
        raise ImportError(
    ImportError: BioPython >= 1.73 must be installed to read block gzip files.
    

    I suppose this can be fixed by specifying a biopython version constraint in the conda definition? Thanks.

    opened by wwood 4
  • Overlap ORFs density threshold

    Overlap ORFs density threshold

    Hello, have you developed a way to allow a certain size of overlaps between ORFs in order to maximize the density of longest ORFs along scaffolds?

    Tanks you very much for this soft by the way, very efficient and easy to use.

    All the best

    Ben

    opened by BenjaminGuinet 3
  • Not all ORFs found?

    Not all ORFs found?

    I'm trying to understand how this tool works.

    Here is a sequence of ~1 kb length:

    region_of_interest GACTCGGTGCTATGTTCTGAATATTTCTGACTTGCATTTTTAATGGAGATAAAATGAAGCATTTAATACATGACGTAGATGAAGACATGAATGAAACTACAGACAAACTTAACTCTTCTCTCATTCTTCCTTTCAGTAAGGACTATGAGTTCTGTTCAAATGGCGTTTATTTCTATTGTGGAAAGATGGGTTCAGGTAAGACATTTAATTTAATTCGTCATATACTCATAACAGAACGTTTAGGAAATGACTCATATTATGACCAAATCATTATATCAGCAACTTCAGACTCTATGGACTCAACAGCGAAAACATTTATGTCAAAAGTTCAAGCCTCTGTCGTTAAAGTTCCAGACAGTGAACTCATTGAATTTCTTCAACGTTACATTCGACGTAAGAGGAAATATTATGCCATCGTTGAATTTATACAGTCAGGAATGCAAAAGACTTCTGAGGAGATGGAAAGAATTATTGACAAACACCACTTACGTCAGTACTCAGGAGTTTACGATATGAAACGACTGACAAACTACATTCTATCAAAACTTTCAAAATACCCCTTCAAAAAATATCCTTCAAACACTCTGCTCGTTTGCGACGACTTCGCTGGTAAAGGTTTAGTGTCAAAACCAGACTCACCATTAGCTAATATCATTACTAAAGTCAGACATTACCACTTAACTGTAGCAATACTTATGCAAACATGGAGGTTTTTAGCTTTAAACATAAAACGTCTCATAACTGACTTCGTTATCTTTCAAGGTTTCTCACGTTATGATATTGAACTCATTTGGAAACAGTCAGGTATAACATTACCTTTTGAAGAAATTTGGGAAGCATATAAGTCTCTCATCTCTCCTCGTTCATACCTTGAGATTCATATCATGACTAATACCATTAAAGTCAAAAATATTCCATGGGAACGACCAACATTGTTTTAAAGTTTAACCTTCAATTGACTGA

    In the IGV genome viewer, where ATG = green bar and stop codon = red, the forward sequence appears thus with 3-frame translation:

    igv_snapshot

    I note 10 start sites in frame 3, following the first STOP. Each of these, I thought, would constitute an alternate ORF, all ending in the same downstream STOP

    But the output of orfipy is : // $ orfipy new_seq.fa --min 100 --max 100000 --procs 4 | sort -k2,2n orfipy version 0.0.4 Using translation table: Standard (transl_table=1) start: ['TTG', 'CTG', 'ATG'] stop: ['TAA', 'TAG', 'TGA'] Setting chunk size 12053 MB. Procs 4 Logs will be saved to: orfipy_new_seq.fa_out/orfipy_2021_09_01_15_35_34.526156.log Processed 1 sequences in 0.02 seconds

    region_of_interest 26 938 ID=region_of_interest_ORF.3;ORF_type=complete;ORF_len=912;ORF_frame=3;Start:CTG;Stop:TAA 0 + region_of_interest 90 210 ID=region_of_interest_ORF.1;ORF_type=complete;ORF_len=120;ORF_frame=1;Start:ATG;Stop:TAA 0 + region_of_interest 246 513 ID=region_of_interest_ORF.2;ORF_type=complete;ORF_len=267;ORF_frame=1;Start:ATG;Stop:TGA 0 + region_of_interest 323 431 ID=region_of_interest_ORF.4;ORF_type=complete;ORF_len=108;ORF_frame=-2;Start:CTG;Stop:TGA 0 - region_of_interest 532 667 ID=region_of_interest_ORF.5;ORF_type=complete;ORF_len=135;ORF_frame=-3;Start:CTG;Stop:TAG 0 - // Can you explain why orfipy excluded so many potential ORFs here? And is there an option to force it to report them?

    opened by krabapple 3
  • Python 3.9 support using conda

    Python 3.9 support using conda

    Hello Urminder!

    Amazing work! I didn't think that Cython could reach such speed. I will keep it in mind for my next projects.

    I wanted to report that conda fails to install orfipy when you have Python 3.9 installed. I strongly believe that orfipy should not have problems in Python 3.9.

    Do you plan to enable Python 3.9 support in the conda recipe?

    Best regards! Enzo.

    opened by EnzoAndree 3
  • ImportError: undefined symbol: PySlice_Adjustindices

    ImportError: undefined symbol: PySlice_Adjustindices

    Hello @urmi-21 Thanks for the tool. I installed it successfully. However, it does not work. I get the following output for the command:- orfipy -h

    image

    Can you please suggest a solution?

    opened by VJ-Ulaganathan 1
  • Is there a tool to update gtf/gff file according to orfipy results?

    Is there a tool to update gtf/gff file according to orfipy results?

    Hi,

    Is there a tool to update gtf/gff(generated by stringtie2 or scallop2) file according to orfipy results? Add splice sites, UTRs, CDSs to existing gtf/gff file.

    Best, Kun

    opened by xiekunwhy 1
  • Full length ORF

    Full length ORF

    Hi, I am using the orfipy. It sounds great tool for my recent work. I wonder could it be possible only to get full length orf not the partial orfs? Please let me know if there is any possibility?

    opened by apoosakkannu 1
  • Raises IndexError if no match along the specified strand is found

    Raises IndexError if no match along the specified strand is found

    You can reproduce the problem by running the following code

    import orfipy_core
    seq = '''GTATCGCTGGAGTCGGGTGATCTCCACGGAGACTCGAGTGGTCTCTTCTTGCCGGGAGCCGTCTTCGCCGGGGTTTCCTCTACCAGACCAAAGGGCTCTAGGACCCTCTTTTTGGCCTGGAAAACCGCCTTACCGAGGTTTCCGCCCCAAGACTTATCGTCCTGGAGCTTTTCCTGAAACTCGGAATCGGCGTGGTTGTACTTGAGGTAAGGATTATCCCCCGCCTCAAGTAGCTTGTTGTATTCGAGATCGTGCTCTCGCGCGACCTCGTCCGCCTTATTGACGGGCTGGCCTTTATCAAGGCCGTTGAAGGGTCCGAGGTATTTGTACCCCGGAACTACTAGACCGCGTTGGTCCTGTTTTTGCTGGTTAGCCTTAGGCCGAGGCGCACCTATGGGCGATGCACAACAGGGTTCCGACGGAGTGGGCAATGCCTCGGGAGATTGGCATTGCGATTCCCAGTGGATGGGCGACCGAGTCATCACCAAGTCCACCCGAACCTGGGTGCTGCCCAGCTACAACAACCACATCTACAAGGAAATCAACTCCACCGGCAACGGACTCAACGGCAGCGCCTACTTTGGATACAGTACTCCCTGGGGATATTTCGACTTTAACCGCTTCCACAGCCACTGGAGCCCCCGAGATTGGCAGCGACTCATCAACAACCACTGGGGCTTCAGACCCAAGGCCATGCACGTCAAAATCTTCAACATCCAAGTCAAAGAAGTCACCACCCAGGACCAGACCACCACCGTCGCCTACTTTGGATACAGTACTCCCTGGGGATATTTCGACTTTAACCGCTTCCAC'''
    orfipy_core.orfs(seq, starts=['ATG'])
    orfipy_core.orfs(seq, starts=['ATG'], strand='f')
    

    The following statement orfipy_core.orfs(seq, starts=['ATG']) runs without any errors. However, orfipy_core.orfs(seq, starts=['ATG'], strand='f') throws IndexError. Posting the stacktrace also

    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
      File "orfipy/orfipy_core.pyx", line 28, in orfipy_core.orfs
      File "orfipy/orfipy_core.pyx", line 46, in orfipy_core.orfs
    IndexError: list index out of range
    

    Kindly look into this. Thanks in advance :)

    opened by Prakash2403 1
  • Run Multiple Codon Table Numbers

    Run Multiple Codon Table Numbers

    Hello, I'm using orfipy for viral detection. I have a range of codon table numbers I'd like to run. Looks like --table only takes a single integer, and the json file only accepts a single . Please correct me if I'm wrong about this! Would be convenient to add an option to search multiple codon tables at the same time. In its current state, I have to run orfipy multiple times and combine the results. Brett

    opened by brettyout 0
  • Suggestion: deterministic ORF IDs

    Suggestion: deterministic ORF IDs

    Right now ORFs are numbered, which causes problems on subsequent runs with slightly changed parameters such as a different minimum length. Maybe encoding the start and stop position would be a better approach so that the order doesn't affect anything. Thanks!

    enhancement 
    opened by Benjamin-Lee 0
  • Description dictionary

    Description dictionary

    Hello,

    I believe that the description of each ORF would be more accessible as a dictionary, instead of a string that is delimited with ;, :, and =. I am able to convert the string into a desirable dictionary

    {'ID': '1', 'ORF_type': 'complete', 'ORF_len': '912', 'ORF_frame': '1', 'Start': 'TTG', 'Stop': 'TAA'}
    

    through the following code

    import orfipy_core
    
    for start, stop, strand, description in orfipy_core.orfs(mers_sequence.upper()):
        descriptions = {}
        for info in description.split(';'):
            if '=' in info:
                info = info.split('=')
                name, content = info[0], info[1]
                if name == 'ID':
                    content = content.split('.')[1]
            else:
                info = info.split(':')
                name, content = info[0], info[1]
            descriptions[name] = content
    

    however, this functionality would be more conveniently integrated into the basic code of ORFIpy.

    Thank you, Andrew

    enhancement 
    opened by freiburgermsu 0
Releases(v0.0.4)
  • v0.0.4(Jul 20, 2021)

  • v0.0.3(Dec 31, 2020)

    Major changes

    • Switch to pyfastx from pyfaidx
    • Index free strategy to iterate over the inputs
    • Added support for Fastq and gzipped files
    • Better handle large sequences such as whole chromosomes
    • Added basic API for python users
    • Multiple refactors
    • Overall, improved performance
    Source code(tar.gz)
    Source code(zip)
  • v0.0.2(Nov 7, 2020)

  • v0.0.1(Oct 15, 2020)

Owner
Urminder Singh
PhD candidate at Iowa State University
Urminder Singh
宝塔面板Windows版提权方法

宝塔面板Windows提权方法 本项目整理一些宝塔特性,可以在无漏洞的情况下利用这些特性来增加提权的机会。

298 Dec 14, 2022
Bug Alert: a service for alerting security and IT professionals of high-impact and 0day vulnerabilities

Bug Alert Bug Alert is a service for alerting security and IT professionals of h

BugAlert.org 208 Dec 15, 2022
Polkit - Local Privilege Escalation (CVE-2021-3560)

CVE-2021-3560 Polkit - Local Privilege Escalation Original discovery by kevin_backhouse from GitHub Security Lab References https://github.blog/2021-0

Salman Asad 1 Nov 12, 2021
All in One CRACKER911181's Tool. This Tool For Hacking and Pentesting.🎭

This is A Python & Bash Programming Based Termux-Tool Created By CRACKER911181. This Tool Created For Hacking and Pentesting. If You Use This Tool To Evil Purpose,The Owner Will Never be Responsible

CRACKER911181 1 Jan 10, 2022
S2-062 (CVE-2021-31805) / S2-061 / S2-059 RCE

CVE-2021-31805 Remote code execution S2-062 (CVE-2021-31805) Due to Apache Struts2's incomplete fix for S2-061 (CVE-2020-17530), some tag attributes c

warin9 31 Nov 22, 2022
Find existing email addresses by nickname using API/SMTP checking methods without user notification. Please, don't hesitate to improve cat's job! 🐱🔎 📬

mailcat The only cat who can find existing email addresses by nickname. Usage First install requirements: pip3 install -r requirements.txt Then just

282 Dec 30, 2022
Hacktricks - Welcome to the page where you will find each trick/technique/whatever I have learnt in CTFs, real life apps, and reading researches and news.

Hacktricks - Welcome to the page where you will find each trick/technique/whatever I have learnt in CTFs, real life apps, and reading researches and news.

Carlos Polop 5.8k Jan 07, 2023
A small POC plugin for launching dumpulator emulation within IDA, passing it addresses from your IDA view using the context menu.

Dumpulator-IDA Currently proof-of-concept This project is a small POC plugin for launching dumpulator emulation within IDA, passing it addresses from

Michael 9 Sep 21, 2022
Moodle community-based vulnerability scanner

badmoodle Moodle community-based vulnerability scanner Description badmoodle is an unofficial community-based vulnerability scanner for moodle that sc

Michele Di Bonaventura 11 Dec 22, 2022
exchange-ssrf-rce

Usage python3 .\exchange-exp.py -------------------------------------------------------------------------------- |

Jen 76 Nov 09, 2022
Python implementation for PrintNightmare using standard Impacket.

PrintNightmare Python implementation for PrintNightmare (CVE-2021-1675 / CVE-2021-34527) using standard Impacket. Installtion $ pip3 install impacket

ollypwn 141 Dec 31, 2022
Auerswald COMpact 8.0B Backdoors exploit

CVE-2021-40859 Auerswald COMpact 8.0B Backdoors exploit About Backdoors were discovered in Auerswald COMpact 5500R 7.8A and 8.0B devices, that allow a

6 Sep 22, 2022
Web Scraping com Python - Raspando Vagas para Programadores

Web Scraping com Python - Raspando Vagas para Programadores Sobre o Projeto Web

Kayo Libarino 3 Dec 30, 2021
Python3 script for scanning CVE-2021-44228 (Log4shell) vulnerable machines.

Log4j_checker.py (CVE-2021-44228) Description This Python3 script tries to look for servers vulnerable to CVE-2021-44228, also known as Log4Shell, a v

lfama 8 Feb 27, 2022
pwncat module that automatically exploits CVE-2021-4034 (pwnkit)

pwncat_pwnkit Introduction The purpose of this module is to attempt to exploit CVE-2021-4034 (pwnkit) on a target when using pwncat. There is no need

Dana Epp 33 Jul 01, 2022
A proof-of-concept exploit for Log4j RCE Unauthenticated (CVE-2021-44228)

CVE-2021-44228 – Log4j RCE Unauthenticated About This is a proof-of-concept exploit for Log4j RCE Unauthenticated (CVE-2021-44228). This vulnerability

Pedro Havay 20 Nov 11, 2022
Time Discretization-Invariant Safe Action Repetition for Policy Gradient Methods

Time Discretization-Invariant Safe Action Repetition for Policy Gradient Methods This repository is the official implementation of Seohong Park, Jaeky

Seohong Park 6 Aug 02, 2022
A Modified version of TCC's Osprey poc framework......

fierce-fish fierce-fish是由TCC(斗象能力中心)出品并维护的开源漏洞检测框架osprey的改写,去掉臃肿功能的精简版本poc框架 PS:真的用不惯其它臃肿的功能,不过作为一个收集漏洞poc && exp的框架还是非常不错的!!! osprey For beginners fr

lUc1f3r11 10 Dec 30, 2022
Separation of Mainlobes and Sidelobes in the Ultrasound Image Based on the Spatial Covariance (MIST) and Aperture-Domain Spectrum of Received Signals

Separation of Mainlobes and Sidelobes in the Ultrasound Image Based on the Spatial Covariance (MIST) and Aperture-Domain Spectrum of Received Signals

Rehman Ali 3 Jan 03, 2023
This python script will automate the testing for the Log4J vulnerability for HTTP and HTTPS connections.

Log4J-Huntress-Automate-Script This python script will automate the testing for the Log4J vulnerability for HTTP and HTTPS connections. Pre-Requisits

1 Dec 16, 2021