\r\n\r\n\r\n## Features overview\r\n\r\n- Visualization of protein structure as provided by LiteMol\r\n- Annotation of protein sequence as provided by ProtVista\r\n- Annotations of protein sequence from [PredictProtein](https://en.wikipedia.org/wiki/Predictprotein) \r\n- Mapping of structure on corresponding substring in the sequence\r\n- Automatic retrieval of sequence data based on UniProt ID and corresponding experimental structures from PDB\r\n- Retrieval of predicted models from [AlphaFold Protein Structure DB](https://alphafold.ebi.ac.uk/) (ADB) and [SWISS-MODEL Repository](https://swissmodel.expasy.org/repository) (SMR) if \r\nno PDB structure is available\r\n- Controlling transparency of the structure to see both cartoon and surface view of the structure\r\n- Hovering over position in sequence to highlight it in structure and vice versa\r\n- Color overlay any sequence feature over the structure\r\n- Color overlay all sequence features of given type over the structure\r\n- Color overlay individual variation over the structure\r\n- Color overlay all mutations to given amino acid over the structure\r\n- Color overlay mutation frequency of residues over the structure\r\n- Exports of the structure and annotations to [PyMol](https://pymol.org/2/) for advanced inspection \r\n(the export does not include variants)\r\n- Upload of custom annotations\r\n- Ability to control which structures will be shown\r\n- Ability to select and highlight specific residues (not necessarily corresponding to annotations) and specific atoms .\r\nThe selection can be visualized either as a surface, a balls and stick representation or simply van der \r\nWaals-based spheres with given color and transparency.\r\n- Ability to provide custom sequence and mapping\r\n\r\n\r\n\r\n## Data sources\r\n\r\n- Sequence and annotation data\r\n - Sequence information comes from [UniProt website REST API](https://www.uniprot.org/help/api) or can be provided by the user\r\n - Sequence annotations are provided by \r\n - ProtVista plugin which utilizes the EBI's \r\n [Proteins REST API](https://www.ebi.ac.uk/proteins/api/doc/). \r\n Proteins API includes access to variation, proteomics and antigen services containing \r\n \"annotations imported and mapped from large scale data sources, such as 1000 Genomes, \r\n ExAC (Exome Aggregation Consortium), COSMIC (Catalogue Of Somatic Mutations In Cancer), \r\n PeptideAtlas, MaxQB (MaxQuant DataBase), EPD (Encyclopedia of Proteome Dynamics) and HPA, \r\n along with UniProtKB annotations for these feature types\".\r\n - [PredictProtein API](https://en.wikipedia.org/wiki/Predictprotein) which gives access to a range\r\n of integrated sequence-based [prediction methods](https://www.predictprotein.org/about) such as\r\n conservation or prediction of functional changes. If the user prefers only experimental data, \r\n the PredictProtein annotations can be easily turned off with the exclusion parameter as \r\n described in the [documentation](https://github.com/davidhoksza/MolArt/tree/master/docs) \r\n \r\n- Structure mapping\r\n - Automatic\r\n - To obtain the mapping between UniProt and PDB, MolArt is using the [SIFTS API](https://www.ebi.ac.uk/pdbe/api/doc/sifts.html), part of the [PDBe REST API](http://www.ebi.ac.uk/pdbe/pdbe-rest-api).\r\n - In case the SIFTS mapping yields no PDB structures, ADB and SMR are queried using their respective APIs for available models.\r\n - Custom\r\n - When working with sequence which is not in UniProt or when the mapping is not known, \r\n sequence-structure mapping can be provided. This includes\r\n - Molecule-level mapping, i.e. which PDB structures correspond to the sequence\r\n - Residue-level mapping, i.e. which regions in sequence correspond to which regions in the structure\r\n\r\n- Structure data\r\n - In case an experimental structure is available in PDB for given UniProt ID, this structure is downloaded by LiteMol. In this case, MolArt instructs LiteMol to use the mmCIF format.\r\n - In case there is no experimental structure in PDB, but a model exists in ADB \r\n or SMR, MolArt instructs LiteMol to use the mmCIF-format in case of ADB and PDB-format in case of SMR.\r\n\r\n## How to use MolArt\r\n\r\n- Obtain the JavaScript file with MolArt and link it from your web page\r\n- Create a container DIV (or SPAN) element which will hold the viewer\r\n- Create a JavaScript object and pass it reference to the DIV\r\n\r\nThe detail description of how to incorporate MolArt into your project can be found in the [developer documentation](https://github.com/davidhoksza/MolArt/tree/master/docs).\r\n\r\n### Examples of use\r\nExmpales of how to use MolArt are located in the ``examples`` folder.\r\n- See the ``bare.html`` file for a bare bones example of how to use the plugin.\r\n- The ``plugin-page.html`` is slightly styled plugin usage.\r\n- For an advanced example, see the ``web`` directory. It contains a simple web application which enables querying Uniprot (only top 10 matches are retrieved) and for every found record one can click the UniProt ID which creates a new tab with new instance of MolArt for that UniProt ID.\r\n\r\n## Contributing\r\n\r\nWe would be happy to hear about your use cases, experiences and ideas/feature requests. Either raise an issue [here](https://github.com/davidhoksza/MolArt/issues) or get in touch by mail (david.hoksza at gmail).\r\n\r\n## Support\r\n\r\nPlease submit your issues through the MolArt's repository issue tracker available [here](https://github.com/davidhoksza/MolArt/issues).\r\n\r\n## License\r\n\r\nThis project is licensed under the Apache 2.0 license, quoted below.\r\n\r\nCopyright (c) 2018 David Hoksza\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.\r\n\r\n## Support\r\n\r\n
\r\n \r\n
\r\n\r\nMolArt is a part of services provided by ELIXIR – European research infrastructure for biological information.\r\nSee [services](https://www.elixir-czech.cz/services) provided [ELIXIR's Czech Republic Node](https://www.elixir-czech.cz/).\r\n\r\n","readmeFilename":"README.md"}
![](\"gitweb/teaser.png\")
\r\n![](\"img/logo-elixir.png\"){kind=logo}
\r\n