{"id":25927949,"url":"https://github.com/samirelanduk/atomium","last_synced_at":"2025-04-09T13:11:05.799Z","repository":{"id":8327733,"uuid":"58009878","full_name":"samirelanduk/atomium","owner":"samirelanduk","description":"Python macromolecular parsing (with .pdb/.cif/.mmtf parsing and production)","archived":false,"fork":false,"pushed_at":"2023-12-07T11:48:47.000Z","size":32603,"stargazers_count":105,"open_issues_count":15,"forks_count":19,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T04:59:23.113Z","etag":null,"topics":["biology","chemistry","molecules","proteins","structural-biology"],"latest_commit_sha":null,"homepage":"https://atomium.bio","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/samirelanduk.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":".github/CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-05-04T00:11:12.000Z","updated_at":"2025-03-06T12:45:36.000Z","dependencies_parsed_at":"2023-02-16T01:31:18.754Z","dependency_job_id":"4977bd49-0624-4bf2-8b6b-fa6f19ff1bb5","html_url":"https://github.com/samirelanduk/atomium","commit_stats":{"total_commits":1295,"total_committers":6,"mean_commits":"215.83333333333334","dds":0.006949806949806958,"last_synced_commit":"ba03bc84882adc6572b8b37da44766c861393c55"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samirelanduk%2Fatomium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samirelanduk%2Fatomium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samirelanduk%2Fatomium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samirelanduk%2Fatomium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samirelanduk","download_url":"https://codeload.github.com/samirelanduk/atomium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248045245,"owners_count":21038554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biology","chemistry","molecules","proteins","structural-biology"],"created_at":"2025-03-03T21:11:14.118Z","updated_at":"2025-04-09T13:11:05.769Z","avatar_url":"https://github.com/samirelanduk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"atomium\n=======\n\n|travis| |coveralls| |pypi| |version| |commit| |downloads|\n\n.. |travis| image:: https://api.travis-ci.org/samirelanduk/atomium.svg?branch=master\n  :target: https://travis-ci.org/samirelanduk/atomium/\n\n.. |coveralls| image:: https://coveralls.io/repos/github/samirelanduk/atomium/badge.svg?branch=master\n  :target: https://coveralls.io/github/samirelanduk/atomium/\n\n.. |pypi| image:: https://img.shields.io/pypi/pyversions/atomium.svg\n  :target: https://pypi.org/project/atomium/\n\n.. |version| image:: https://img.shields.io/pypi/v/atomium.svg\n  :target: https://pypi.org/project/atomium/\n\n.. |commit| image:: https://img.shields.io/github/last-commit/samirelanduk/atomium/master.svg\n  :target: https://github.com/samirelanduk/atomium/tree/master/\n\n.. |downloads| image:: https://img.shields.io/pypi/dm/atomium.svg\n  :target: https://pypi.org/project/atomium/\n\n\natomium is a molecular modeller and file parser, capable of reading from and\nwriting to .pdb, .cif and .mmtf files.\n\nExample\n-------\n\n    \u003e\u003e\u003e import atomium\n    \u003e\u003e\u003e pdb = atomium.fetch(\"5HVD\")\n    \u003e\u003e\u003e pdb.model\n    \u003cModel (1 chain, 6 ligands)\u003e\n    \u003e\u003e\u003e pdb.model.chain(\"A\")\n    \u003cChain A (255 residues)\u003e\n\n\n\nInstalling\n----------\n\npip\n~~~\n\natomium can be installed using pip:\n\n``$ pip3 install atomium``\n\natomium is written for Python 3, and does not support Python 2.\n\nIf you get permission errors, try using ``sudo``:\n\n``$ sudo pip3 install atomium``\n\n\nDevelopment\n~~~~~~~~~~~\n\nThe repository for atomium, containing the most recent iteration, can be\nfound `here \u003chttp://github.com/samirelanduk/atomium/\u003e`_. To clone the\natomium repository directly from there, use:\n\n``$ git clone git://github.com/samirelanduk/atomium.git``\n\n\nRequirements\n~~~~~~~~~~~~\n\natomium requires `requests \u003chttp://docs.python-requests.org/\u003e`_ for fetching\nstructures from the RCSB, `paramiko \u003chttp://www.paramiko.org//\u003e`_ for\nfetching structures over SSH,\n`msgpack \u003chttps://github.com/msgpack/msgpack-python\u003e`_ for parsing .mmtf files,\nand `valerius \u003chttps://valerius.samireland.com\u003e`_ for dealing with sequences.\n\n\nTesting\n~~~~~~~\n\nTo test a local version of atomium, cd to the atomium directory and run:\n\n``$ python -m unittest discover tests``\n\nYou can opt to only run unit tests or integration tests:\n\n``$ python -m unittest discover tests.unit``\n``$ python -m unittest discover tests.integration``\n\nYou can run the 'big test' to get a random 1000 structures, parse them all, and\nreport any problems:\n\n``$ python tests/big.py``\n\nFinally, to perform speed profiles you can run:\n\n``$ python tests/time/time.py``\n\n...which creates various profiles that SnakeViz can visualise.\n\n\n\nOverview\n--------\n\natomium is a Python library for opening and saving .pdb, .cif and .mmtf files,\nand presenting and manipulating the information contained within.\n\n\nLoading Data\n~~~~~~~~~~~~\n\nWhile you can use atomium to create models from scratch to build an entirely\n*de novo* structure, in practice you would generally use it to load molecular\ndata from an existing file...\n\n\t\u003e\u003e\u003e import atomium\n\t\u003e\u003e\u003e pdb1 = atomium.open('../1LOL.pdb')\n\t\u003e\u003e\u003e mmtf1 = atomium.open('/structures/glucose.mmtf')\n\t\u003e\u003e\u003e cif1 = atomium.open('/structures/1XDA.cif')\n\t\u003e\u003e\u003e pdb3 = atomium.open('./5CPA.pdb.gz')\n\t\u003e\u003e\u003e pdb2 = atomium.fetch('5XME.pdb')\n\t\u003e\u003e\u003e cif2 = atomium.fetch('5XME')\n\nIn that latter case, you don't need the file to be saved locally - it will just\ngo and grab the PDB with that code from the RCSB.\n\natomium will use the file extension you provide to decide how to parse it. If\nthere isn't one, or it doesn't recognise the extension, it will peek at the\nfile contents and try and guess whether it should be interpreted as .pdb, .cif\nor .mmtf.\n\n\nUsing Data\n~~~~~~~~~~\n\nOnce you've got your ``File`` object, what can you do with it?\n\nAnnotation\n##########\n\nThere is meta information contained within the ``File`` object:\n\n    \u003e\u003e\u003e pdb1.title\n    'CRYSTAL STRUCTURE OF OROTIDINE MONOPHOSPHATE DECARBOXYLASE COMPLEX WITH XMP'\n    \u003e\u003e\u003e pdb1.deposition_date\n    datetime.date(2002, 5, 6)\n    \u003e\u003e\u003e pdb1.keywords\n    ['TIM BARREL', 'LYASE']\n    \u003e\u003e\u003e pdb1.classification\n    'LYASE'\n    \u003e\u003e\u003e pdb1.source_organism\n    'METHANOTHERMOBACTER THERMAUTOTROPHICUS STR. DELTA H'\n    \u003e\u003e\u003e pdb1.resolution\n    1.9\n    \u003e\u003e\u003e pdb1.rvalue\n    0.193\n    \u003e\u003e\u003e pdb1.rfree\n    0.229\n\natomium doesn't currently parse *every* bit of information from these\nfiles, but there is more than those shown above. See\n`the full API docs \u003capi/pdb.html\u003e`_ for more details. In particular, you can\naccess the processed intermediate MMCIF dictionary to get *any* attribute of\nthese structures.\n\nModels and Assembly\n###################\n\nAll .pdb files contain one or more models - little universes containing a\nmolecular scene.\n\n    \u003e\u003e\u003e pdb1.model\n    \u003cModel (2 chains, 4 ligands)\u003e\n    \u003e\u003e\u003e pdb1.models\n    (\u003cModel (2 chains, 4 ligands)\u003e,)\n\nMost just contain one - it's generally those that come from NMR experiments\nwhich contain multiple models. You can easily iterate through these to get their\nindividual metrics:\n\n    \u003e\u003e\u003e for model in pdb2.models:\n            print(model.center_of_mass)\n\nThis model contains the 'asymmetric unit' - this is one or more protein\n(usually) chains arranged in space, which may not be how the molecule arranges\nitself in real life. It might just be how they arranged themselves in the\nexperiment. To create the 'real thing' from the asymmetric unit, you use\n**biological assemblies.**\n\nMost .pdb files contain one or more biological assemblies - instructions for how\nto create a more realistic structure from the chains present, which in atomium\nare accessed using ``File.assemblies``.\n\nIn practice, what you need to know is that you can create a new model - not the\none already there containing the asymmetric unit - as follows...\n\n    \u003e\u003e\u003e pdb3 = atomium.fetch('1XDA')\n    \u003e\u003e\u003e pdb3.model\n    \u003cModel (8 chains, 16 ligands)\u003e\n    \u003e\u003e\u003e pdb3.generate_assembly(1)\n    \u003cModel (2 chains, 4 ligands)\u003e\n    \u003e\u003e\u003e pdb3.generate_assembly(10)\n    \u003cModel (6 chains, 12 ligands)\u003e\n    \u003e\u003e\u003e [pdb.generate_assembly(n + 1) for n in range(len(pdb.assemblies))]\n    [\u003cModel (2 chains, 4 ligands)\u003e, \u003cModel (2 chains, 4 ligands)\u003e, \u003cModel (2 cha\n    ins, 4 ligands)\u003e, \u003cModel (2 chains, 4 ligands)\u003e, \u003cModel (12 chains, 24 ligan\n    ds)\u003e, \u003cModel (12 chains, 24 ligands)\u003e, \u003cModel (6 chains, 12 ligands)\u003e, \u003cMode\n    l (6 chains, 12 ligands)\u003e, \u003cModel (6 chains, 12 ligands)\u003e, \u003cModel (6 chains,\n     12 ligands)\u003e, \u003cModel (4 chains, 8 ligands)\u003e, \u003cModel (4 chains, 8 ligands)\u003e]\n\nHere you load a .pdb with multiple possible assemblies, have a quick look at\nthe asymmetric unit with 1,842 atoms, and then generate first , and then all,\nof its possible biological assemblies by passing in their IDs.\n\n\nModel Contents\n##############\n\nThe basic structures within a model are chains, residues, ligands, and atoms.\n\n    \u003e\u003e\u003e pdb1.model.chains()\n    {\u003cChain A (204 residues)\u003e, \u003cChain B (214 residues)\u003e}\n    \u003e\u003e\u003e pdb1.model.chain('B')\n    \u003cChain B (214 residues)\u003e\n    \u003e\u003e\u003e pdb1.model.residues(name='TYR')\n    {\u003cResidue TYR (A.37)\u003e, \u003cResidue TYR (B.1037)\u003e, \u003cResidue TYR (A.45)\u003e, \u003cResidu\n    e TYR (A.154)\u003e, \u003cResidue TYR (B.1206)\u003e, \u003cResidue TYR (B.1154)\u003e, \u003cResidue TYR\n     (B.1045)\u003e, \u003cResidue TYR (A.206)\u003e}\n    \u003e\u003e\u003e pdb1.model.residues(name__regex='TYR|PRO')\n    {\u003cResidue PRO (A.101)\u003e, \u003cResidue PRO (A.46)\u003e, \u003cResidue PRO (A.161)\u003e, \u003cResidu\n    e TYR (A.45)\u003e, \u003cResidue PRO (B.1046)\u003e, \u003cResidue TYR (A.154)\u003e, \u003cResidue TYR (\n    B.1206)\u003e, \u003cResidue TYR (B.1045)\u003e, \u003cResidue PRO (B.1189)\u003e, \u003cResidue TYR (A.37\n    )\u003e, \u003cResidue PRO (B.1129)\u003e, \u003cResidue PRO (B.1077)\u003e, \u003cResidue PRO (A.211)\u003e, \u003c\n    Residue PRO (B.1180)\u003e, \u003cResidue PRO (B.1157)\u003e, \u003cResidue PRO (B.1211)\u003e, \u003cResi\n    due PRO (B.1228)\u003e, \u003cResidue PRO (B.1101)\u003e, \u003cResidue TYR (B.1154)\u003e, \u003cResidue\n    PRO (A.157)\u003e, \u003cResidue PRO (A.77)\u003e, \u003cResidue PRO (A.180)\u003e, \u003cResidue TYR (B.1\n    037)\u003e, \u003cResidue PRO (A.129)\u003e, \u003cResidue PRO (B.1161)\u003e, \u003cResidue TYR (A.206)\u003e}\n    \u003e\u003e\u003e pdb1.model.chain('B').residue('B.1206')\n    \u003cResidue TYR (B.1206)\u003e\n    \u003e\u003e\u003e pdb1.model.chain('B').residue('B.1206').helix\n    True\n    \u003e\u003e\u003e pdb1.model.ligands()\n    {\u003cLigand BU2 (A.5001)\u003e, \u003cLigand XMP (A.2001)\u003e, \u003cLigand BU2 (B.5002)\u003e, \u003cLigan\n    d XMP (B.2002)\u003e}\n    \u003e\u003e\u003e pdb1.model.ligand(name='BU2').atoms()\n    {\u003cAtom 3196 (O3)\u003e, \u003cAtom 3192 (C1)\u003e, \u003cAtom 3193 (O1)\u003e, \u003cAtom 3197 (C4)\u003e, \u003cAt\n    om 3194 (C2)\u003e, \u003cAtom 3195 (C3)\u003e}\n    \u003e\u003e\u003e pdb1.model.ligand(name='BU2').atoms(mass__gt=12)\n    {\u003cAtom 3196 (O3)\u003e, \u003cAtom 3192 (C1)\u003e, \u003cAtom 3193 (O1)\u003e, \u003cAtom 3197 (C4)\u003e, \u003cAt\n    om 3194 (C2)\u003e, \u003cAtom 3195 (C3)\u003e}\n    \u003e\u003e\u003e pdb1.model.ligand(name='BU2').atoms(mass__gt=14)\n    {\u003cAtom 3196 (O3)\u003e, \u003cAtom 3193 (O1)\u003e}\n\nThe examples above demonstrate atomium's selection language. In the case of the\nmolecules - ``Model``, ``Chain``, ``Residue`` and\n``Ligand`` - you can pass in an ``id`` or ``name``, or search by regex\npattern with ``id__regex`` or ``name__regex``.\n\nThese structures have an even more powerful syntax too - you can pass in *any*\nproperty such as ``charge=1``, any comparitor of a property such as\n``mass__lt=100``, or any regex of a property such as ``name__regex='[^C]'``.\n\nFor pairwise comparisons, structures also have the\n``AtomStructure.pairwise_atoms`` generator which will yield all\nunique atom pairs in the structure. These can obviously get very big indeed - a\n5000 atom PDB file would have about 12 million unique pairs.\n\nStructures can be moved around and otherwise compared with each other...\n\n    \u003e\u003e\u003e pdb1.model.ligand(id='B:2002').mass\n    351.1022\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').formula\n    Counter({'C': 10, 'O': 9, 'N': 4, 'P': 1})\n    \u003e\u003e\u003e pdb1.model.ligand(id='B:2002').nearby_atoms(2.8)\n    {\u003cAtom 3416 (O)\u003e, \u003cAtom 3375 (O)\u003e, \u003cAtom 1635 (OD1)\u003e}\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').nearby_atoms(2.8, name='OD1')\n    {\u003cAtom 1635 (OD1)\u003e}\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').nearby_residues(2.8)\n    {\u003cResidue ASP (B.1020)\u003e}\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').nearby_structures(2.8, waters=True)\n    {\u003cResidue ASP (B.1020)\u003e, \u003cWater HOH (B.3155)\u003e, \u003cWater HOH (B.3059)\u003e}\n    \u003e\u003e\u003e import math\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').rotate(math.pi / 2, 'x')\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').translate(10, 10, 15)\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').center_of_mass\n    (-9.886734282781484, -42.558415679537184, 77.33400578435568)\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').radius_of_gyration\n    3.6633506511540825\n    \u003e\u003e\u003e pdb1.model.ligand(id='B.2002').rmsd_with(pdb1.model.ligand(id='A.2001'))\n    0.133255572356\n\nHere we look at one of the ligands, identify its mass and molecular formula,\nlook at what atoms are within 2.8 Angstroms of it, and what residues are within\nthat same distance, rotate it and translate it through space, see where its new\ncenter of mass is, and then finally get its RMSD with the other similar ligand\nin the model.\n\nAny operation which involves identifying nearby structures or atoms can be sped\nup - dramatically in the case of very large structures - by calling\n``Model.optimise_distances`` on the ``Model`` first. This\nprevents atomium from having to compare every atom with every other atom every\ntime a proximity check is made.\n\nThe ``Atom`` objects themselves have their own useful properties.\n\n    \u003e\u003e\u003e pdb1.model.atom(97)\n    \u003cAtom 97 (CA)\u003e\n    \u003e\u003e\u003e pdb1.model.atom(97).mass\n    12.0107\n    \u003e\u003e\u003e pdb1.model.atom(97).anisotropy\n    [0, 0, 0, 0, 0, 0]\n    \u003e\u003e\u003e pdb1.model.atom(97).bvalue\n    24.87\n    \u003e\u003e\u003e pdb1.model.atom(97).location\n    (-12.739, 31.201, 43.016)\n    \u003e\u003e\u003e pdb1.model.atom(97).distance_to(pdb1.model.atom(1))\n    26.18289982030257\n    \u003e\u003e\u003e pdb1.model.atom(97).nearby_atoms(2)\n    {\u003cAtom 96 (N)\u003e, \u003cAtom 98 (C)\u003e, \u003cAtom 100 (CB)\u003e}\n    \u003e\u003e\u003e pdb1.model.atom(97).is_metal\n    False\n    \u003e\u003e\u003e pdb1.model.atom(97).structure\n    \u003cResidue ASN (A.23)\u003e\n    \u003e\u003e\u003e pdb1.model.atom(97).chain\n    \u003cChain A (204 residues)\u003e\n\nChains are a bit different from other structures in that they are iterable,\nindexable, and return their residues as a tuple, not a set...\n\n    \u003e\u003e\u003e pdb1.model.atom(97).chain\n    \u003cChain A (204 residues)\u003e\n    \u003e\u003e\u003e pdb1.model.chain('A')\n    \u003cChain A (204 residues)\u003e\n    \u003e\u003e\u003e len(pdb1.model.chain('A'))\n    204\n    \u003e\u003e\u003e pdb1.model.chain('A')[10]\n    \u003cResidue LEU (A.21)\u003e\n    \u003e\u003e\u003e pdb1.model.chain('A').residues()[:5]\n    (\u003cResidue VAL (A.11)\u003e, \u003cResidue MET (A.12)\u003e, \u003cResidue ASN (A.13)\u003e, \u003cResidue\n    ARG (A.14)\u003e, \u003cResidue LEU (A.15)\u003e)\n    \u003e\u003e\u003e pdb1.model.chain('A').sequence\n    'LRSRRVDVMDVMNRLILAMDLMNRDDALRVTGEVREYIDTVKIGYPLVLSEGMDIIAEFRKRFGCRIIADFKVAD\n    IPETNEKICRATFKAGADAIIVHGFPGADSVRACLNVAEEMGREVFLLTEMSHPGAEMFIQGAADEIARMGVDLGV\n    KNYVGPSTRPERLSRLREIIGQDSFLISPGVGAQGGDPGETLRFADAIIVGRSIYLADNPAAAAAGIIESIKDLLI\n    PE'\n\nThe sequence is\nthe 'real' sequence that exists in nature. Some of them will be\nmissing from the model for practical reasons.\n\nResidues can generate name information based on their three letter code, and are\naware of their immediate neighbors.\n\n    \u003e\u003e\u003e pdb1.model.residue('A.100')\n    \u003cResidue PHE (A.100)\u003e\n    \u003e\u003e\u003e pdb1.model.residue('A.100').name\n    'PHE'\n    \u003e\u003e\u003e pdb1.model.residue('A.100').code\n    'F'\n    \u003e\u003e\u003e pdb1.model.residue('A.100').full_name\n    'phenylalanine'\n    \u003e\u003e\u003e pdb1.model.residue('A.100').next\n    \u003cResidue PRO (A.101)\u003e\n    \u003e\u003e\u003e pdb1.model.residue('A.100').previous\n    \u003cResidue GLY (A.99)\u003e\n\nSaving Data\n~~~~~~~~~~~\n\nA model can be saved to file using:\n\n  \u003e\u003e\u003e model.save(\"new.cif\")\n  \u003e\u003e\u003e model.save(\"new.pdb\")\n\nAny structure can be saved in this way, so you can save chains or molecules to\ntheir own seperate files if you so wish.\n\n\n  \u003e\u003e\u003e model.chain(\"A\").save(\"chainA.pdb\")\n  \u003e\u003e\u003e model.chain(\"B\").save(\"chainB.cif\")\n  \u003e\u003e\u003e model.ligand(name=\"XMP\").save(\"ligand.mmtf\")\n\nNote that if the model you are saving is one from a biological assembly, it will\nlikely have many duplicated IDs, so saving to file may create unexpected\nresults.\n\n\nChangelog\n---------\n\nRelease 1.0.11\n~~~~~~~~~~~~~~\n\n`27 November 2021`\n\n* Optimised distance lookup for finding atoms within sphere.\n\n\nRelease 1.0.10\n~~~~~~~~~~~~~~\n\n`29 May 2021`\n\n* Fixed secondary structure parsing for multi character asym IDs in mmCIF.\n\n\nRelease 1.0.9\n~~~~~~~~~~~~~\n\n`4 February 2021`\n\n* Fixed temperature factor zero-padding in PDB saving.\n* Fixed MMTF decode bug in Ubuntu.\n\n\nRelease 1.0.8\n~~~~~~~~~~~~~\n\n`9 December 2020`\n\n* HETATM identity now preserved when parsing PDB files\n\n\nRelease 1.0.7\n~~~~~~~~~~~~~\n\n`5 November 2020`\n\n* Fixed blank ANISOU values in PDB saving.\n* Fixed negative residue IDs in PDB saving.\n* Fixed SyntaxWarning messages on PDB saving.\n\nRelease 1.0.6\n~~~~~~~~~~~~~\n\n`8 September 2020`\n\n* Added handling of new branched entities in MMCIF/MMTF.\n\nRelease 1.0.5\n~~~~~~~~~~~~~\n\n`21 July 2020`\n\n* Added ability to open compressed .gz files.\n\n\nRelease 1.0.4\n~~~~~~~~~~~~~\n\n`1 May 2020`\n\n* Made TER records more compliant in saved PDB files.\n* Specified required msgpack version to fix MMTF parsing issue.\n\n\nRelease 1.0.3\n~~~~~~~~~~~~~\n\n`5 December 2019`\n\n* Made quality information detection more broad.\n* Improved documentation. \n\n\nRelease 1.0.2\n~~~~~~~~~~~~~\n\n`1 October 2019`\n\n* Added distance optimiser for proximity checks.\n* Improved test coverage.\n\n\nRelease 1.0.1\n~~~~~~~~~~~~~\n\n`26 September 2019`\n\n* Added a pdb2json script for converting local structure files to JSON.\n* Improved speed comparison checks.\n\n\nRelease 1.0.0\n~~~~~~~~~~~~~\n\n`23 June 2019`\n\n* Saving now issues warning if the stucture has duplicate IDs.\n* Missing residues parsed for all three file types.\n* Crystallographic information now parsed.\n* Refactor of atomic structures.\n* Refactor of .mmtf parsing.\n* Structure copying now retains all properties.\n* Fixed bug in parsing .cif expression systems.\n* Full names of ligands and modified residues now parsed.\n* Secondary structure information parsed and available now.\n* Atoms now have covalent radius property for calculating bond cutoffs.\n* .pdb parsing can now handle heavy water (DOD).\n* General speed improvements.\n\n\nRelease 0.12.2\n~~~~~~~~~~~~~~\n\n`4 February 2019`\n\n* Angle between superimposed atoms now possible.\n* Fixed source speices lookup in .cif files.\n* Fixed bug relating to embedded quotes in .cif files.\n\n\nRelease 0.12.1\n~~~~~~~~~~~~~~\n\n`13 January 2019`\n\n* Fixed assembly parsing bug in small number of .cif files.\n\n\nRelease 0.12.0\n~~~~~~~~~~~~~~\n\n`2 January 2019`\n\n* Refactored parse utilities to improve speed.\n* Added support for .mmtf files.\n* Added file writing for all three file types (.pdb, .cif, .mmtf).\n* Made .cif the default file type.\n* General library restructuring.\n\n\nRelease 0.11.1\n~~~~~~~~~~~~~~\n\n`13 September 2018`\n\n* Fixed bug pertaining to residues with ID 0.\n* Fixed bug pertaining to SEQRES parsing when chain ID is numeric.\n* Changed format of residue IDs to include colon.\n* Considerable speed improvements in .mmcif parsing.\n\n\nRelease 0.11.0\n~~~~~~~~~~~~~~\n\n`22 August 2018`\n\n* Added .mmcif parsing.\n* Changed how parsing in general is done under the hood.\n* Added atom angle calculation.\n* Fixed bug where modified residues were treated as ligands if authors used HETATM records.\n\n\nRelease 0.10.2\n~~~~~~~~~~~~~~\n\n`29 July 2018`\n\n* Added function for getting PDBs over SSH.\n* Fixed biological assembly parsing bug.\n* Fixed chain copying of sequence bug.\n\n\nRelease 0.10.1\n~~~~~~~~~~~~~~\n\n`25 June 2018`\n\n* Added function for returning best biological assembly.\n* Fixed bug with sorting None energy assemblies.\n* Fixed bug pertaining to excessive atom duplication when creating assembly.\n\n\nRelease 0.10.0\n~~~~~~~~~~~~~~\n\n`22 June 2018`\n\n* Parsing of .pdb keywords.\n* Parsing of atom anisotropy.\n* Parsing of .pdb sequence information.\n* More R-factor information.\n* Biological assembly parsing and generation.\n* More powerful transformations rather than just simple rotation.\n* Backend simplifications.\n* Powerful new atom querying syntax.\n\n\nRelease 0.9.1\n~~~~~~~~~~~~~\n\n`17 May 2018`\n\n* Added Residue one-letter codes.\n* Fixed stray print statement.\n\n\nRelease 0.9.0\n~~~~~~~~~~~~~\n\n`10 April 2018`\n\n* Turned many methods into properties.\n* Added full residue name generation.\n* Made bind site detection more picky.\n* Added coordinate rounding to deal with floating point rounding errors.\n* Atomic structures now 'copy'able.\n* Refactored atom querying.\n* Added grid generation.\n* Implemented Kabsch superposition/rotation.\n* Implemented RMSD comparison.\n* Created Complex class (for later).\n\n\nRelease 0.8.0\n~~~~~~~~~~~~~\n\n`2 December 2017`\n\n* Added option to get water residues in binding sites.\n* Added extra PDB meta information parsing, such as:\n\n\t* Classification\n\t* Experimental Technique\n\t* Source Organism\n\t* Expression Organism\n\t* R-factor\n\n\nRelease 0.7.0\n~~~~~~~~~~~~~\n\n`2 November 2017`\n\n* PDBs with multiple occupancy can now be parsed correctly.\n* Added pairwise atom generator.\n* PDB parser now extracts resolution.\n* Further speed increased to PDB parser.\n* Miscellaneous bug fixes.\n* Implemented Continuous Integration.\n\n\nRelease 0.6.0\n~~~~~~~~~~~~~\n\n`3 October 2017`\n\n* Now allows for fetching and opening of PDB data dictionaries.\n* Added parsing/saving of HEADER and TITLE records in PDB files.\n* Added ability to exclude elements from atom search.\n* Added ability to get nearby atoms in a model.\n* Added bind site identification.\n* Fixed chain length bottleneck in PDB model saving.\n* Overhauled PDB parsing by replacing classes with built in Python types.\n* Fixed bug where numerical residue names were interpreted as integers.\n* Changed atoms so that they can allow negative B factors.\n* Added loading of .xyz data dictionaries.\n* Miscellaneous speed increases.\n\nRelease 0.5.0\n~~~~~~~~~~~~~\n\n`16 September 2017`\n\n* Added atom temperature factors.\n* Added bond vector production.\n* Added parse time tests and reduced parse time by over a half.\n* Changed way atoms are stored in structures to make ID lookup orders of \\\n  magnitude faster.\n* Made IDs immutable.\n* Added multiple model parsing and saving.\n* Added option to fetch PDBs from PDBe rather than RCSB.\n\n\nRelease 0.4.0\n~~~~~~~~~~~~~\n\n`26 August 2017`\n\n* Added PDB parsing.\n* Added PDB saving.\n* Gave atoms ability to get specific bond with other atom.\n* Added bond angle calculation.\n* Added ability to filter out water molecules.\n\nRelease 0.3.0\n~~~~~~~~~~~~~\n\n`11 August 2017`\n\n* Added classes for Molecules, Chains, Residues, and their interfaces.\n* Added charges to atoms and structures.\n* Add ability to create AtomicStructures from AtomicStructures.\n\n\nRelease 0.2.0\n~~~~~~~~~~~~~\n\n`14 June 2017`\n\n* Made all Atomic Structures savable.\n* Added Atom IDs and uniqueness constraints.\n* Added Atom Bonds.\n\n\nRelease 0.1.1\n~~~~~~~~~~~~~\n\n`1 June 2017`\n\n* Fixed setup.py\n* Minor typos\n\n\nRelease 0.1.0\n~~~~~~~~~~~~~\n\n`1 June 2017`\n\n* Added basic Model and Atom classes.\n* Added .xyz parsing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamirelanduk%2Fatomium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamirelanduk%2Fatomium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamirelanduk%2Fatomium/lists"}