ALT-IN is the instrument for predicting disruptions in protein-protein interactions induced by alternative splicing. We recommend usage of Docker version of our tool which is available on DockerHub repository (https://hub.docker.com/r/narykov/alt-in) and has a convenient interface (altin_docker.py)

The ONLY script file you would need to run Docker image is altin_docker.py. The prerequisite is existing Docker installation (the image would be downloaded automatically), and example data files. You would be able to run example just by executing the following commands:

python3 altin_docker.py -i test/interactors.tsv -o res.txt -f test/diabetes_ensembl_protein.fa test/string_protein.fa

Download would take approximately 10 min on stable internet connection. This is an interface script for Docker container. The ONLY dependency for it is preinstalled Docker with corresponding permissions.

• -h, --help

  Prints brief usage information.

• -i, --interactors

  A tsv file containing triplets in format "reference_isoform", "interactor", "alternative_isoform". You can use test/interactors.tsv file for the reference.

• -d, --output-dir

  Output directory where output would be stored. Permissions should allow for Docker to bind to this location. Default value is current directory

• -o, --output-file

  Name of the output file. Would be stored in directory specified by "--output-dir" option.

• -f, --fastafiles

  A list of fasta files, which should contain sequences for all IDs occuring in interactors file. Number of files you may specify is not limited.

Read the following information if you wish to install ALT-IN Tool without Docker as a standalone package. Standalone version of ALT-IN Tool depends on 2 software packages - EMBOSS and INTERPRO. Installation was tested on Ubuntu 16.04 with Python 2.7 version of Anaconda.

Direct download - ftp://emboss.open-bio.org/pub/EMBOSS/EMBOSS-6.6.0.tar.gz

Could be downloaded from the EMBOSS website. In our package version 6.6.0 was used.

Direct download - ftp://ftp.ebi.ac.uk/pub/software/unix/iprscan/5/5.27-66.0/interproscan-5.27-66.0-64-bit.tar.gz

Could be downloaded from the InterPro website. In our package version 5.27-66.0 was used.

You would need this step only if you want to change sequence alignment (currently EMBOSS implementation is used) or domain detection (currently performed by SUPERFAMILY).

We require two files to be accessible - pepstat from EMBOSS and ass3.pl from SUPERFAMILY. If they are in the system path (i.e., accessible from the command line), no further actions required.

For each package that you cannot access from command line fill in corresponding line in 'config' file. E.g., to provide path for INTERPRO fill in empty space on the second line of the file: INTERPRO_PATH='~/Downloads/interproscan-5.27-66.0'

To run our tool please use command in format

python altintool.py [interactors_file.tsv] [fasta_file_1, fasta_file_2, ...] [output_file]

E.g., to run our test data you can use command

python altintool.py test/interactors.tsv test/diabetes_ensembl_protein.fa test/string_protein.fa test/results.txt

To make predictions you would need at least 2 files:

• Triplets consisting of the IDs of (Main isoform, Interacting partner, Alternatively spliced isoform) in tab separated format (.tsv)
• Fasta file(s) with protein sequences for the aforementioned protein IDs

For questions, please email to the [email protected]