Motif Finder pipeline - searching for motifs through orthologous species.

Prepare a directory for Lverage. Then either download the ZIP file or clone the repository to this directory. Once downloaded, navigate inside.

git clone https://github.com/BradhamLab/Lverage.git
cd Lverage

Lverage requires Python3.8 at minimum to run. The tool was developed using Python3.10.12. To obtain python and the required libraries, we advise using Conda.

To install Conda, follow the instructions on their website user guide. We suggest downloading Miniconda.

The following command installs our configuration of Python.

conda env create -f conda_lverage.yml
conda activate lverage

The user can also download Python and the required libraries themselves. Follow the instructions at the Python website to download Python3.10.12 (or any other alternative with a minimum of 3.8).

Then the user must install the required libraries. Located in the repository is a requirements.txt file which contains the required libraries. Assuming that calling python3 calls the user-downloaded python, please call the following command.

python3 -m pip install -r requirements.txt

We warn against moving any file within the directory anywhere else as this will create errors. If you wish to access from other places, we suggest appending the directory to your PATH environment variable, creating an alias, or creating a shortcut.

To call Lverage, ensure that the requirements above are all met. Within the directory is a file called lverage.py. All calls should be made with this file.

The following table shows all arguments for Lverage.

python3 lverage.py -f Data/LvGenes/ -e [email protected] -o ../Output/lvedge_output.tsv -v

Here we provide a directory of fasta files with -f. The fasta files used in this example were gathered from LvEDGE and are provided in this repository. In -e, we provide an email for any EMBL tools. We provide a path for an output file we wish to be created with -o. Finally, we ask that it prints out each step with -v.

Lverage is an open-source tool made for the community. As such, we are welcoming of any contributions to the project!

If a bug/error is found, we suggest adding it as an issue in the GitHub Repository.

For directly contributing (fixing the error or adding new funcionality), we suggest that the contributor follows the (https://github.com/firstcontributions/first-contributions)[standard process]. Begin by forking the repository, making local changes, and then submit a pull request to the master branch. Be sure to name your branch a meaningful name that represents what changes you have added! We suggest that if a contributor wishes to add/fix multiple parts that they create a fork for each part.

Please note that this project uses the GNU AFFERO GENERAL PUBLIC LICENSE Version 3. Any contributions made will fall under this license.

The team members are available to be contacted for any queries relating to Lverage usage and issues. We suggest first and foremost that any issue be posted to the issue board.

To contact us, please use the following contact information.