{"id":26572741,"url":"https://github.com/giffordlabcvr/DIGS-tool","last_synced_at":"2025-03-23T00:35:37.399Z","repository":{"id":13258850,"uuid":"15943984","full_name":"giffordlabcvr/DIGS-tool","owner":"giffordlabcvr","description":"Database-Integrated Genome Screening (DIGS) tool. Explore the dark genome using BLAST and a relational database.","archived":false,"fork":false,"pushed_at":"2024-05-28T16:20:23.000Z","size":51449,"stargazers_count":8,"open_issues_count":2,"forks_count":6,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-05-29T07:29:57.220Z","etag":null,"topics":["blast-searches","comparative-genomics","data-mining","evolution","genome-annotation","molecular-genetics","paleovirology","sequence-similarity","similarity-search","transposable-elements"],"latest_commit_sha":null,"homepage":"http://giffordlabcvr.github.io/DIGS-tool/","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/giffordlabcvr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-01-15T18:28:58.000Z","updated_at":"2024-05-30T07:50:56.121Z","dependencies_parsed_at":"2023-10-10T18:13:37.745Z","dependency_job_id":"ed83d639-8814-483f-8d6d-2eac9d1d962d","html_url":"https://github.com/giffordlabcvr/DIGS-tool","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giffordlabcvr%2FDIGS-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giffordlabcvr%2FDIGS-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giffordlabcvr%2FDIGS-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giffordlabcvr%2FDIGS-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/giffordlabcvr","download_url":"https://codeload.github.com/giffordlabcvr/DIGS-tool/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245040215,"owners_count":20551297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blast-searches","comparative-genomics","data-mining","evolution","genome-annotation","molecular-genetics","paleovirology","sequence-similarity","similarity-search","transposable-elements"],"created_at":"2025-03-23T00:34:41.104Z","updated_at":"2025-03-23T00:35:37.383Z","avatar_url":"https://github.com/giffordlabcvr.png","language":"Perl","funding_links":[],"categories":["Other Tools"],"sub_categories":["Ancient Viral Sequence Analysis"],"readme":"# Database-Integrated Genome Screening (DIGS) Tool\n\n\u003cimg src=\"md/logo_digs.png\" align=\"right\" alt=\"\" width=\"220\" /\u003e\n\n\nWelcome to the GitHub repository for the **DIGS Tool**!\n\n**Systematic, sequence similarity search-based genome screening** is a powerful approach for identifying and characterising genome features in silico. This approach extends the basic [sequence similarity search](https://blast.ncbi.nlm.nih.gov/) by: \n\n 1. Performing multiple searches systematically, involving various **query sequences** and/or **target databases**.\n 2. Classifying “**hits**” (matching sequences) via comparison to a **reference sequence library** curated by the investigator.\n\n**Database-integrated genome screening (DIGS)** is a form of systematic genome screening in which a similarity search-based screening pipeline is linked to a **relational database management system** ([RDBMS](https://www.w3schools.com/mysql/mysql_rdbms.asp)). This provides a robust foundation for implementing large-scale, automated screens, and enables a 'database querying' approach to investigating screening output.\n\n**The DIGS Tool is a software framework for implementing DIGS on UNIX/LINUX and Macintosh OSX platforms**. The program is accessible through a text-based console interface. It uses the [BLAST+ ](https://ftp.ncbi.nlm.nih.gov/blast/executables/blast+/LATEST/) program suite to perform similarity search-based screening, and the [MySQL](https://dev.mysql.com/downloads/mysql/) RDBMS to capture screen output. \n\nPlease see the [User Guide](https://github.com/giffordlabcvr/DIGS-tool/wiki) for more details.\n\n## Installation and Setup \n\nTo run the DIGS tool requires [PERL](https://www.perl.org/), [BLAST](https://ftp.ncbi.nlm.nih.gov/blast/executables/blast+/LATEST/) and [MySQL](https://dev.mysql.com/downloads/mysql/) (or a supported fork of MySQL such as MariaDB).\n\nSteps involved in installing the DIGS tool and using it to perform DIGS are as follows:\n\n1. Install and configure DIGS\n    - [Download](https://github.com/giffordlabcvr/DIGS-tool/zipball/master) the DIGS tool\n    - Install [PERL](https://www.perl.org/), [BLAST](https://ftp.ncbi.nlm.nih.gov/blast/executables/blast+/LATEST/) and [MySQL](https://dev.mysql.com/downloads/mysql/)\n    - Install Perl `DBI` and `DBD::MySQL` packages (if they are not already installed)\n    - Set `$DIGS_HOME` and `$DIGS_GENOMES` environment variables\n        - `$DIGS_HOME` = path to DIGS tool directory\n        - `$DIGS_GENOMES` = path to the top level of the target database (tDB) directory (see below)\n    - Create a MySQL user for DIGS\n    - Set `$DIGS_MYSQL_USER` and `$DIGS_MYSQL_PASSWORD` environment variables\n\n3. Set up the target database (tDB), create a reference sequence library (RSL) and select query (probe) sequences\n\n4. Create a [control file](https://github.com/giffordlabcvr/DIGS-tool/wiki/Control-File) for a DIGS project\n\n5. Run the DIGS screen based on the control file\n\n6. Interrogate the output of DIGS \n\n7. Update reference libraries and repeat steps 4+5 using updated information \n\n**Step 1** and its sub-components are one-offs associated with initial set-up of the DIGS tool. \n\n**Steps 2-3** refer to the set-up of individual DIGS projects, and will need to be repeated for each distinct screen.\n\n**Steps 4-6** encapsulate the actual DIGS process. **Step 5** can entail analysis within the screening database (i.e. using [SQL](https://github.com/giffordlabcvr/DIGS-tool/wiki/Example-SQL), but may also entail the analysis of DIGS output in external programs (e.g. phylogeny packages, statistical analysis programs). Iterating on a DIGS project (**Step 6**) is optional. However, it is anticipated that many DIGS projects will be heuristic in nature, and these will commonly require iteration.\n\nPlease see the [User Guide](https://github.com/giffordlabcvr/DIGS-tool/wiki) for more details.\n\n## Quick Start\n\nTo see options for screening: \n\n`./digs_tool.pl -h` \n\nTo run DIGS, the following input data components are required:\n\n1. **Target Database ([TDb](https://github.com/giffordlabcvr/DIGS-tool/wiki/Target-Database-%28tDB%29)):** A collection of whole genome sequence or transcriptome assemblies serving as the target for similarity searches.\n2. **Reference Sequence Library ([RSL](https://github.com/giffordlabcvr/DIGS-tool/wiki/Reference-Sequence-Library-%28RSL%29)):** Represents the genetic diversity associated with the genome feature(s) under investigation.\n3. **Query Sequences ([Probes](https://github.com/giffordlabcvr/DIGS-tool/wiki/Query-Sequences-(Probes))):** Input sequences for similarity searches of the Target Database.\n4. **[Control File](https://github.com/giffordlabcvr/DIGS-tool/wiki/Control-File):** Defines parameters and paths for screening.\n\n\nBefore running a screen for the first time, you will need to index the TDb for BLAST searching:\n\n`./digs_tool.pl –m=1 –i=[path to control file]`\n\n### Running a sceen\n\nOnce the target database has been indexed, a screen can be executed as follows:\n\n`./digs_tool.pl –m=2 –i=[path to control file]`\n\nProgress is written to the terminal, and can also be monitored by issuing SQL queries against the relevant screening database. A screen can be stopped at any time. The next time the tool is restarted, it will initiate screening at the point it left off.\n\nPlease see the [User Guide](https://github.com/giffordlabcvr/DIGS-tool/wiki) for more details.\n\n## Citation\n\nA [paper describing the DIGS tool](https://doi.org/10.1186/s13059-024-03258-y) has been published in the journal Genome Biology:\n\nBlanco-Melo D, Campbell MA, Zhu H, Dennis TPW, Modha S, Lytras S, Hughes J, Gatseva A, and Gifford RJ (**2024**)\nA novel approach to exploring the dark genome and its application to mapping of the vertebrate virus fossil record.\n_Genome Biology_ May 13;25(1):120\n\n## Contributing\n\nThe DIGS tool team is very open to further development of this software by the open source bioinformatics community. It is probably worth raising any ideas you have with the team before embarking on development. \n\nIf contributing to the DIGS tool, please review our [Contribution Guidelines](./md/CONTRIBUTING.md).\n\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](./md/code_of_conduct.md) \n\n## Contact\n\nFor questions, issues, or feedback, please contact us at [digstool@gmail.com](mailto:digstool@gmail.com) or open an [issue](https://github.com/giffordlabcvr/DIGS-tool/issues).\n\n## Credits\n\nThe DIGS tool was written by Robert J. Gifford.\n\n## License\n\nThe project is licensed under the [GNU Affero General Public License v. 3.0](https://www.gnu.org/licenses/agpl-3.0.en.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiffordlabcvr%2FDIGS-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiffordlabcvr%2FDIGS-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiffordlabcvr%2FDIGS-tool/lists"}