This module contains classes and functions that perform intersectional genetics-related operations to find VEnCodes using databases provided by the FANTOM5 consortium, namely the CAGE enhancer and transcription start site (TSS) databases.

For more information on the VEnCode technology, please refer to Macedo and Gontijo, bioRxiv 2019. DOI:10.1101/552984

These instructions are designed to:

• Get you a copy of the project up and running on your local machine for development and testing purposes;
• Install the VEnCode package in your python library environment for use in your projects.

To effectively use this module you will need Python3 with some external libraries installed in your machine. Check the requirements file. If you install the package with pip, it should resolve the library requirements for you.

Additionally, you will have to download the unannotated TSS files from FANTOM5 consortium website. More specifically, for human, this file for promoter analysis, and this one and the ID-sample name map for enhancers. Finally, download the curated sample category file.

Those 4 files are enough to find CAGE-based VEnCodes for human.

1. Make sure you have the prerequisites;

If you want to edit the project:

2. Fork this project;
3. Put the missing FANTOM5 prerequisite files (only the large TSS files are missing) in the directory called "Files".

If you are a user:

2. Install VEnCode with pip;
3. Put all the FANTOM5 prerequisite files in a directory of your choice and when creating DataTpm objects remember to pass the argument: files_path=your_dir_path.

To develop your own projects, import objects directly from VEnCode using, for example:

import VEnCode
object1 = VEnCode.DataTpm(...)

You can see examples of some functions and objects being used at the VEnCode Capsule hosted in CodeOcean.

Alternatively, you can look at more advanced usage by going to the "Scripts" folder inside the package.

Tests for this module can be run in several ways; some examples:

1. In the command-line:

1.1. Run python's standard module "unittest" in the tests directory. Basic example in command line:

python -m unittest test_internals

1.2. Install nosetests python package and run nosetests in the "tests" directory. Basic example in command line:

nosetests test_internals.py

2. By importing the VEnCode module in python:

from VEnCode import tests
tests.test_internals_()

Please read CONTRIBUTING.rst for details on our code of conduct, and the process for submitting pull requests to us.

We use SemVer for versioning. For the versions available, see:

• The tags on github, or
• In PyPi.

• Andre Macedo
• Alisson M. Gontijo

See also the list of contributors who participated in this project.

Refer to file LICENSE.

• Integrative Biomedicine Laboratory @ CEDOC, NMS, Lisbon (supported by FCT: UID/Multi/04462/2019; PTDC/MED-NEU/30753/2017; and PTDC/BIA-BID/31071/2017 and FAPESP: 2016/09659-3)
• CEDOC: Chronic Diseases Research Center, Nova Medical School, Lisbon
• The MIT Portugal Program (MITEXPL/BIO/0097/2017)
• LIGA PORTUGUESA CONTRA O CANCRO (LPCC) 2017.
• FCT (IF/00022/2012, SFRH/BD/94931/2013, PTDC/BEXBCM/1370/2014)
• Prof. Dr. Ney Lemke and Ms. Benilde Pondeca for important discussions.