Skip to main content

Multixem Refinement pipeline for multiple data sets in structure biology


PyPI version Test Status Downloads Code style: black


This is still a work in progress.

Installation

Install the latest code from this GitHub repository using:

pip install git+https://github.com/MartinMalyMM/multixem.git

Or install the released package from PyPI with pip:

pip install multixem

It is recommended to use a Python virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install multixem  # or pip install git+https://github.com/MartinMalyMM/multixem.git

Most of the dependencies (NumPy, pandas, GEMMI, MatPlotLib Python modules) will be installed automatically. You will also need Servalcat installed, typically from a recent CCP4 installation which also includes the Monomer Library.

Bootstrap

Subcommand bootstrap: Perform the bootstrap protocol - run multiple refinements in parallel against resampled sub data sets.

Example:

multixem bootstrap 10000 \
    --hklin 1PGJ_data.mtz \
    --model 1PGJ_model.pdb \
    --hklin_free 1PGJ_data.mtz \
    --prefix 1PGJ_bootstrap10000 \
    --servalcat_args "--ncycle 10" \
    --servalcat_confing "config.yaml" \
    --n_bins 30 \
    --n_proc 16 \
    --geometry_cids 1PGJ_geometry_obj.txt \

The merged diffraction data (i.e. reflection) will be resampled with replacement 10,000 times. The subsequently refined structures will be analysed including calculation of mean, standard deviation, etc.

The file given in 1PGJ_geometry_obj.txt defines parameters/features of the structure model under investigation. Each lines specifies an object using atomic CIDs divided by spaces. One CID in row denotes an occupancy, two an interactomic distance, three an angle between the atoms and four a torsion angle. For instance:

//A/505/O2
//A/505/O2 //A/262/CG
//A/505/O2 //A/262/CG //A/262/CD

Regarding the distances and angles, the procedure is suitable for investigation non-covalently linked atoms. The environment is locally unrestrained (Van der Waals anti-bumping restraints switched off) to provide unbiased results.

Unrestrained refinement of a small molecule can be performed using the following setting:

multixem bootstrap 10000 \
    --hklin 1513945.cif \
    --model 1513945.cif \
    --prefix 1513945_bootstrap10000 \
    --servalcat_args "--unre --hydrogen yes --refine_h --adp aniso --no_solvent --adpr_weight 0 --ncycle 20" \
    --n_bins 5 \
    --n_proc 16 \

All currently available options are listed using:

multixem bootstrap --help

The options for Servalcat which could be provided through the --servalcat_args parameter to this Multixem pipeline can be listed using:

servalcat refine_xtal_norefmac --help

Comparison of isomorphous data sets

Subcommand pipeline: Compare the given diffraction data sets, refine given structure model(s) against them and compare them including calculation of isomorphous difference density maps (|Fobs,n|e^iɸn – k|Fobs,1|e^iɸ1). The input data set should be cut at the same resolution.

Example: comparison of bovine, pork and human insulin:

multixem pipeline \
    --hklin insuling_cow.mtz insuling_pig.mtz insuling_people.mtz \
    --hklin_free insuling_people.mtz \
    -p insulin \
    --model insuling_cow.pdb insuling_pig.pdb insuling_people.pdb \
    --n_bins 30 \
    --n_proc 4 \
    --unify_cell

Example: Merging and comparison of batches of unmerged diffraction data:

multixem pipeline \
    --hklin_unmerged insuling_people_unmerged.mtz \
    --hklin_free insuling_people.mtz \
    -p insulin_people_600 \
    --model insuling_people.pdb \
    --n_bins 30 \
    --n_proc 4 \
    --n_batches 600

All currently available options are listed using:

multixem pipeline --help

Tests

Automatic tests are implemented using pytest. They can be run using the following command:

python -m pytest -s -v

The integration tests use data from 6-phosphogluconate dehydrogenase (PDB 1PGJ, manuscript) and human, porcine, and bovine insulin (manuscript, raw data (DOI 10.5281/zenodo.13890874)).

Metadata

Release files for multixem 0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for multixem 0.4
File Size Uploaded Provenance Actions
multixem-0.4.tar.gz 72.0 kB Without provenance Details for multixem-0.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for multixem 0.4
File Interpreter ABI Platform Actions
multixem-0.4-py3-none-any.whl Python 3 none any Details for multixem-0.4-py3-none-any.whl

Total release size: 144.5 kB

Release files / multixem-0.4.tar.gz

Download URL multixem-0.4.tar.gz
Size 72.0 kB
Tags Source
SHA-256 checksum
How to use checksums
af539152c1ed953f84a7c2cef254ecd391f0a8dda77c446ff01be068b0858451
BLAKE2b-256 checksum
How to use checksums
b40bb17719f8873d8847d7b31391c775ccd133bfa2dfdeba46883b77326bb96f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / multixem-0.4-py3-none-any.whl

Download URL multixem-0.4-py3-none-any.whl
Size 72.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d2e3159bb05e7f0f4a08a01ee1bed7c29c7fd6f1026ac174c23524e88ea63463
BLAKE2b-256 checksum
How to use checksums
ed3c7749d8580ad34bc1fcd7b154cda1909f0a982be68b3b10f36fac261e6569
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.16

Security for multixem 0.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page