ANSURR | Accuracy of NMR Structures Using RCI and Rigidity v2.0.43

ANSURR uses backbone chemical shifts to validate the accuracy of NMR protein structures as described here https://www.nature.com/articles/s41467-020-20177-1. This repository contains the code required to install and run ANSURR on a Linux or a Mac. ANSURR v1.2.1 is also available on NMRbox (https://nmrbox.org/software/ansurr). Please let me know if you have any issues.

Installation

ANSURR v2 is installed using pip (https://packaging.python.org/en/latest/tutorials/installing-packages/).

pip install ansurr

You will also need java in order to re-reference chemical shifts using PANAV (recommended) (https://java.com/en/download/help/download_options.html).

Running ANSURR

ANSURR requires two input files, a NMR protein structure in PDB format and a shifts file in NEF format or NMR Star v3 format. To re-reference chemical shifts using PANAV before running ANSURR (recommended):

ansurr -p xxxx.pdb -s xxxx.nef -r

To run without re-referencing chemical shifts:

ansurr -p xxxx.pdb -s xxxx.nef

Options:

-p input pdb file

-s input shifts file

-h print the help message

-l include free ligands when computing flexibility.

-m only output the ANSURR scores in a text file

-n include non-standard residues when computing flexibility. Note that RCI will not be calculated for non-standard residues and so they will not be used to compute validation scores. Regardless, including non-standard residues is a good idea to avoid breaks in the protein structure which would otherwise make those regions too floppy.

-o combine chains into a single structure when calculating flexibility. This is useful when the structure is an oligomer as oligomerisation will often result in changes in flexibility.

-r re-reference chemical shifts using PANAV before running ANSURR (recommended).

-q suppress output to the terminal

-v print version details

-w compute ANSURR scores for the well-defined residues identified by CYRANGE. These scores are computed using a separate benchmark for well-defined residues.

Output

A directory called <yourpdbfile>_<yourshiftfile> is made to save the output generated. This directory will be overwritten if you run ANSURR again with input files with the same names as before. This directory contains two directories called ANSURR_output and other_output. ANSURR_output contains:

  • scores.out - a text file with the validation scores for each model
  • <yourpdbfile>_<yourshiftfile>_ansurr.nef - a NEF file with most output generated by ANSURR
  • <yourpdbfile>_<yourshiftfile>_ansurr.json - a json file with most output generated by ANSURR
  • <yourpdbfile>_<yourshiftfile>.png - a graphical summary of the validation scores for each model
  • out/ - text files for each model which detail the following for each residue: flexibility predicted by RCI, flexibility predicted by FIRST, secondary structure according to DSSP, well-defined regions of the ensemble according to CYRANGE, backbone chemical shift completeness and which atom types have chemical shift data
  • figs/ - plots of protein flexibility predicted by RCI (blue) and FIRST (orange) for each model. Alpha helical and beta sheet secondary structure indicated by red and blue dots, respectively. Green dots indicate regions that are well-defined according to CYRANGE. Black crosses indicate residues with no chemical shift data (not used to compute validation scores).

other_output contains output from various programs run as part of ANSURR:

  • PANAV/ - re-referenced chemical shifts
  • RCI/ - flexibility predicted from chemical shifts using RCI
  • extracted_pdbs/ - PDB files for each model extracted from the NMR structure
  • DSSP/ - secondary structure for each model according to the program DSSP
  • FIRST/ - flexibility predicted for each model using FIRST

Help

Contact Nick Fowler (njfowler.com) for support, queries or suggestions.

Known Issues

  • The Mac version of ANSURR gives slightly different ANSURR scores (average difference of less than 1) due to using a different compiler to compile the underlying C++ code for computing rigidity. I'm working on a fix.

  • Secondary structure is currently not computed in the Mac version.

Acknowledgements

Random Coil Index (RCI) | Berjanskii, M.V. & Wishart, D.S. A simple method to predict protein flexibility using secondary chemical shifts. Journal of the American Chemical Society 127, 14970-14971 (2005).

Floppy Inclusions and Rigid Substructure Topography (FIRST) | Jacobs, D.J., Rader, A.J., Kuhn, L.A. & Thorpe, M.F. Protein flexibility predictions using graph theory. Proteins-Structure Function and Genetics 44, 150-165 (2001).

Probabilistic Approach to NMR Assignment and Validation (PANAV) | Bowei Wang, Yunjun Wang and David S. Wishart. "A probabilistic approach for validating protein NMR chemical shift assignments". Journal of Biomolecular NMR. Volume 47, Number 2 / June 2010: 85-99

DSSP | A series of PDB related databases for everyday needs. Wouter G Touw, Coos Baakman, Jon Black, Tim AH te Beek, E Krieger, Robbie P Joosten, Gert Vriend. Nucleic Acids Research 2015 January; 43(Database issue): D364-D368. | Dictionary of protein secondary structure: pattern recognition of hydrogen-bonded and geometrical features. Kabsch W, Sander C, Biopolymers. 1983 22 2577-2637.

adjustText - automatic label placement for matplotlib | https://github.com/Phlya/adjustText

CYRANGE | D.K. Kirchner & P. Güntert, BMC Bioinformatics 2011, 12 170.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for nickjf from gravatar.com nickjf

Credits

Author: Nick J Fowler

License

MIT License

Requires

Python >=3.6

Classifiers

Report project as malware

Download files

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

Source Distribution

ansurr-2.0.52.tar.gz (4.6 MB view details)

Uploaded Source

Built Distribution

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

ansurr-2.0.52-py3-none-any.whl (4.7 MB view details)

Uploaded Python 3

File details

Details for the file ansurr-2.0.52.tar.gz.

File metadata

  • Download URL: ansurr-2.0.52.tar.gz
  • Upload date:
  • Size: 4.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.5.0.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for ansurr-2.0.52.tar.gz
Algorithm Hash digest
SHA256 a175cb021de60d178048e398b86d9132766053bf6151e7cb77a08949f1ded93a
MD5 e350c759a0097194b62f3ce468e1e5db
BLAKE2b-256 4a387b5847c5b8913179e9cef7d32ece6eedbb3ed80906c7270ba842fcfd3545

See more details on using hashes here.

File details

Details for the file ansurr-2.0.52-py3-none-any.whl.

File metadata

  • Download URL: ansurr-2.0.52-py3-none-any.whl
  • Upload date:
  • Size: 4.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.5.0.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for ansurr-2.0.52-py3-none-any.whl
Algorithm Hash digest
SHA256 84640f376ef05ea77f3162d2b7d9fa59245bd3f7a118d612ebe6adaa8b7fe469
MD5 5a9b68e0c61430e939b9498de31dd300
BLAKE2b-256 c71b9c448cc2a90bade63640a7b9f036cfcf05af4e7f7eaa6febe2aee738d3b5

See more details on using hashes here.

Release history Release notifications | RSS feed

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.55

2 files

2.0.54

2 files

2.0.53

2 files

This release

2.0.52 This release

2 files

2.0.51

2 files

2.0.50

2 files

2.0.49

2 files

2.0.48

2 files

2.0.47

2 files

2.0.46

2 files

2.0.45

2 files

2.0.44

2 files

2.0.43

2 files

0.0.43

2 files

0.0.42

2 files

0.0.41

2 files

0.0.40

2 files

0.0.39

2 files

0.0.38

2 files

0.0.37

2 files

0.0.36

2 files

0.0.35

2 files

0.0.34

2 files

0.0.33

2 files

0.0.32

2 files

0.0.31

2 files

0.0.30

2 files

0.0.29

2 files

0.0.28

2 files

0.0.27

2 files

0.0.26

2 files

0.0.25

2 files

0.0.24

2 files

0.0.23

2 files

0.0.22

2 files

0.0.21

2 files

0.0.20

2 files

0.0.19

2 files

0.0.18

2 files

0.0.17

2 files

0.0.16

2 files

0.0.15

2 files

0.0.14

2 files

0.0.13

2 files

0.0.12

2 files

0.0.11

2 files

0.0.10

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

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