Skip to main content

Detect functional block of protein. If you have two different proteins that bind to the same target protein. Struct2Block is an easy tool designed for quickly evaluating the following situations:1) An antibody binds to a receptor. To what extent does it sterically hinder the ligand. 2)2 different ligands bind to the same receptor. To what degree does they compete.

Project description

Struct2Block

Detect functional blocking.

If you have two different proteins that bind to the same target protein. Struct2Block is an easy tool designed for quickly evaluating the following situations:

  • An antibody binds to a receptor. To what extent does it sterically hinder the ligand.
  • 2 different ligands bind to the same receptor. To what degree does they compete.

1 Install

1.1 pip

pip install struct2block

1.2 conda

conda install chou_uken::struct2block
mamba install chou_uken::struct2block

2 How to use

2.1 As a Command Line Application

To get usage instructions.

struct2block --help

For example, you can use this command line:

struct2block A.pdb B.pdb

It will use A.pdb as antigen-ligand complex and B.pdb as Antibody-antigen complex. Then some details and results will be printed in the console. If you don't need any output, use option -q or --quiet. You can also output superimposed structures with following command line.

struct2block A.pdb B.pdb prefix

Then your structures will be output as prefix_antibody.pdb and prefix_ligand.pdb.

2.2 As a Python API

def struct2block(complex: str, anti: str, prefix: str=None, quiet: bool=False) -> float:
    """Calculate the steric clash volume (block rate) of antibody.
    Block rate = Volume of ligand occupied by antibody / Total volume of ligand
    
    Args:
        complex (str): PDB file containing Antigen-Ligand model.
        anti (str): PDB file containing Antigen-Antibody model.
        prefix (str): The file prefix you want to store the superimposed complex structures.
        quiet (bool): If true, suppress the output.

    Returns:
        blockRate (float): block rate.
    """

For example:

from struct2block.struct2block import struct2block
br: float = struct2block(complex="antigen-ligand.pdb", anti="antigen-antibody.pdb", quiet=False)

3 How does it work

First, Struct2Block find the most similar shared chain in two PDB files as antigen. Then it calculates the space (V_ligand) occupied by the ligand in the antigen-ligand complex. Next, it calculates the volume of that same space that is now occupied by the antibody in the antigen-antibody complex (V_antibody ∩ ligand). Then the steric clash volume of ligand (called 'block rate')

block rate = V(antibody ∩ ligand) / V(ligand)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

struct2block-1.1.tar.gz (269.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

struct2block-1.1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file struct2block-1.1.tar.gz.

File metadata

  • Download URL: struct2block-1.1.tar.gz
  • Upload date:
  • Size: 269.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for struct2block-1.1.tar.gz
Algorithm Hash digest
SHA256 98aa43c6fa42e14b73b69c71a532b55660a1795d48d5829570e990207c99ccdc
MD5 8adc63817b33d4259e41aeb5342f7130
BLAKE2b-256 ee9c46e36309e0abad8c263f17e9acebf5ff11e7c3819b47bdf4cfa5068b858e

See more details on using hashes here.

File details

Details for the file struct2block-1.1-py3-none-any.whl.

File metadata

  • Download URL: struct2block-1.1-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for struct2block-1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2ec96d156ac8e544b310be20e4b4d2eeef01e2a2c123e0589258330b33d48c32
MD5 c16c34b1e9d07bca7020e340add02bf4
BLAKE2b-256 82fd762c3e9414396f65a331cae5167bdd2e194bcf04fed5ca69fc60198dde7a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page