pocketmapper 0.0.2rc0__py3-none-any.whl

pocketmapper-0.0.2rc0.dist-info/METADATA

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: pocketmapper
+Version: 0.0.2rc0
+Summary: A tool for mapping surface pockets in PDB structures
+Author: Lachlan Ellingboe
+Author-email: Lachlan.Ellingboe@icr.ac.uk
+License: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bio
+Requires-Dist: fire
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: tqdm
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: bump2version; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Dynamic: license-file
+
+PocketMapper
+    ============
+
+    PocketMapper is a command-line tool to fetch protein structures, compute PISA-derived pockets,
+    extract atomic coordinates from mmCIF files, perform local or Foldseek alignments, compare
+    pockets across structures and write results to disk. It is intended for comparative analysis
+    of binding pockets between query and target protein chains.
+
+    Features
+    - Download and cache mmCIF files
+    - Preprocess/mmCIF splitting using gemmi
+    - Retrieve PISA interface/pocket information and store pocket data
+    - Extract CA coordinates from divided structures
+    - Perform local alignments or Foldseek-based alignments
+    - Compare pockets using alignment and substitution scoring (BLOSUM62)
+    - Save tabular results and auxiliary JSON files to a results directory
+
+    Requirements
+    - Python 3.8+
+    - pandas
+    - gemmi
+    - pisa (project-specific downloader wrapper used by this package)
+    - foldseek (optional, required only when using Foldseek alignment)
+    - Additional dependencies: lib (project helper module), LocalAligner class (local_aligner.py)
+    - Command-line wrapper: fire
+
+    Installation
+    1. Clone the repository (or copy the project into your workspace).
+    2. Create a virtualenv and install dependencies:
+        python -m venv .venv
+        source .venv/bin/activate
+        pip install -r requirements.txt
+
+    3. Ensure external tools are available:
+        - foldseek (if using Foldseek): install and available on PATH
+
+    Quick start / Usage
+    - Basic local alignment run for a single pair:
+      pocketmapper search --query 1ABC_A_B --target 2XYZ_C_D --results_dir ./out
+
+    - Batch mode using files with one PDB_CHAIN_CHAIN per line:
+      pocketmapper search --query queries.txt --target targets.txt --settings config.json
+
+    - Use bundled Foldseek DB:
+      pocketmapper search --query 1ABC_A_B --target ted --foldseek True --results_dir ./out_fs
+
+    Options
+    - --query: Query identifier or path. Accepts a single PDB_CHAIN_CHAIN (e.g. 1ABC_A_B) or a file with one per line.
+    - --target: Target identifier or path. Accepts single PDB_CHAIN_CHAIN, file, or 'ted' for bundled Foldseek DB.
+    - --settings: Path to JSON settings file. CLI args override settings file.
+    - --cache_dir: Directory for caching downloaded or intermediate files.
+    - --results_dir: Directory to write results and temporary divided structures.
+    - --verbose / --debug: Increase log verbosity.
+    - --foldseek: If true, run Foldseek alignments (requires foldseek binary and appropriate DB).
+    - --pisa_pockets: Whether to retrieve PISA pockets (default: true).
+
+    Configuration (settings JSON)
+    The settings JSON may include keys such as:
+    - cache_dir, structure_dir, pocket_dir, pisa_dir, divided_struct_dir
+    - results_dir, query_dir, target_dir, alignment_path, pocket_comparison_path
+    - foldseek (bool), pisa_pockets (bool), structure (bool)
+
+    Outputs
+    - alignment.tsv: Alignment report (Foldseek or local aligner)
+    - pocket_comparison.tsv: Final pocket comparison table
+    - pisa_pockets and intermediate JSON snapshots under pisa_dir
+    - unknown_ids.json (if unknown Foldseek aliases are encountered)
+    - Divided mmCIF files and temporary directories under results_dir
+
+    Design / Workflow
+    1. Parse CLI args and settings
+    2. Determine types of query/target (single PDB_CHAIN_CHAIN, file, or foldseek DB)
+    3. Fetch mmCIF structures to cache (structure_dir)
+    4. Preprocess and divide structures (gemmi) into per-domain files (divided_struct_dir)
+    5. Retrieve PISA interface data and compute pockets (pisa)
+    6. Extract CA coordinates from divided mmCIFs
+    7. Perform alignment (local or foldseek)
+    8. Compare pockets using alignments and BLOSUM scoring
+    9. Save results and clean up temporary directories
+
+    Extending or Debugging
+    - Increase verbosity with --verbose or --debug to get more details in logs.
+    - The library 'lib' contains helper functions for fetching mmCIFs, preprocessing and comparing pockets.
+    - Local alignment logic is in local_aligner.py (LocalAligner).
+    - The default logging writes to test.log in the current working directory.
+
+    License
+    - Add your preferred license information here.
+
+    Contributing
+    - Report issues or open pull requests against the repository.
+    - Add tests for new functionality and keep changes small and focused.
+
+    Contact / Authors
+    - See project repository for maintainer and contributor information.

pocketmapper-0.0.2rc0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pocketmapper-0.0.2rc0.dist-info/licenses/LICENSE,sha256=t-zc4Zc6RloNIReZtTJj2pJ4J5JsO12mjEoB3-U6NJo,1064
+pocketmapper-0.0.2rc0.dist-info/METADATA,sha256=EURnc3HyFOBjrcgKaQLv-3LZj7YBf2MAhCMayh9Q3Fo,5416
+pocketmapper-0.0.2rc0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pocketmapper-0.0.2rc0.dist-info/entry_points.txt,sha256=R4oSutBm1WdbgDig7Dm_ODSu_KkrbQ3qVGh9kUf2WDc,51
+pocketmapper-0.0.2rc0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pocketmapper-0.0.2rc0.dist-info/RECORD,,

pocketmapper-0.0.2rc0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pocketmapper-0.0.2rc0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pocketmapper = pocketmapper:main

pocketmapper-0.0.2rc0.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Lachlan Ellingboe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pocketmapper-0.0.2rc0.dist-info/top_level.txt

@@ -0,0 +1 @@
+