Metadata-Version: 2.4
Name: dockposegen-adtgpu
Version: 1.0.0
Summary: An Automated extraction tool for ligand poses (models) from AutoDock-GPU docking results.
Author: alpha-horizon
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENCE
Dynamic: license-file

# dockposegen

```text
####################################################################
#                                                                  #
#   _____             _                                            #
#  |  __ \           | |                                           #
#  | |  | | ___   ___| | ___ __   ___  ___  ___  __ _  ___ _ __    #
#  | |  | |/ _ \ / __| |/ / '_ \ / _ \/ __|/ _ \/ _` |/ _ \ '_ \   # 
#  | |__| | (_) | (__|   <| |_) | (_) \__ \  __/ (_| |  __/ | | |  #
#  |_____/ \___/ \___|_|\_\ .__/ \___/|___/\___|\__, |\___|_| |_|  #
#                         | |                    __/ |             #
#                         |_|                   |___/              #
#                                                                  #
# [version: 1.0.0]                        |AUTODOCK GPU EDITION|   #
#                                                                  #
#                                                                  #
####################################################################
```
<h1 style="font-weight:800; font-size:1.7em;">
  Automated Ligand Pose Extraction for AutoDock-GPU Results.
</h1>

  For more tools visit: https://github.com/alpha-horizon

---
**dockposegen-adtgpu** is the tool specifically re-designed to handle AutoDock-GPU outputs. This version automates the screening of high-throughput docking results, ranking ligands by binding affinity, and extracting optimized coordinates from .dlg and .xml files.


# Input Requirements
"Place all .xml and .dlg files into their respective /xml and /dlg directories. If these files are already located in the correctly named folders, no further action is required."

- **.xml files**
- **.dlg files**

  *Note: These are the standard output files generated by AutoDock GPU.*
  
---
## pip Installation

To install dockposegen, you can use the command mentioned below.

        pip install dockposegen-adtgpu
---

## Command Line Usage

This edition supports full argument-based execution for automation and pipelines:

        dockposegen-ag --select ALL

Options:

        --select [IDs] : Specific Ligand IDs to extract (space-separated) or ALL.

        -x, --xml : Directory containing .xml files (default: xml).

        -d, --dlg : Directory containing .dlg files (default: dlg).

        -o, --out : Output directory for PDBs (default: ligands).

        -l, --log : Change the default ranking log filename.

        --version : Show current version info.

        --help : Show all available commands.
---
  
## Overview

##Step 1: Affinity Screening & Ranking

    Input: XML results from the xml/ directory.

    Description: The tool parses XML files to find the "Best Run" (lowest binding energy) for every ligand.

    Output: A ranked summary file (highest_affinities.log) sorted by kcal/mol.

##Step 2: Selection

    Interactive: If run without arguments, the tool displays the Top 10 Candidates and prompts for selection.

    Automated: Use the --select flag to process specific hits or the entire library automatically.

##Step 3: Coordinate Extraction 

    Input: DLG files from the dlg/ directory.

    Description: The script extracts the specific coordinates.

    Output: Ready-to-use .pdb files in the ligands/ folder.
---
#File Structure

    xml/: Contains input AutoDock-GPU XML files.

    dlg/: Contains input AutoDock-GPU DLG files.

    ligands/: Directory where extracted PDB poses are saved.

    highest_affinities.log: Ranked list of all processed ligands.

---
## Contribution

For more tools or to report issues, visit the official GitHub repository:

GitHub: https://github.com/alpha-horizon

---
