npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

pdb-lite-mol

v0.2.0

Published

Web-component implementation of LiteMol 3D structure viewer. LiteMol is a streamlined structure viewer which enables a PDB structure to be explored within a browser rather than requiring pre-installed molecular graphics software. It is a PDB Component dev

Downloads

5

Readme

PDB LiteMol

NPM version

This is an AngularJs Web-Component for LiteMol 3D structure viewer. LiteMol is a streamlined structure viewer which enables a PDB structure to be explored within a browser rather than requiring pre-installed molecular graphics software. There is also the option to view electron density of the structure where structure factors have been deposited to the PDB. Litemol also displays validation and domain information for the structure. It is a PDB Component Library component.

If you are interested in using core LiteMol library or if you want to customize / extend the functionality, you can refer to LiteMol repository for more information.

PDB LiteMol

Getting Started

It takes only 3 easy steps to get started with PDB Components.

  • Include module files and required dependencies
  • Install the component
  • Use component as custom element anywhere in the page

If you have installed the PDB Component Library in your application then you can directly start using the component as custom element (refer step 3).

1. Include module files and dependencies

Download the module javascript file (pdb.litemol.min.js and pdb.litemol.min.css) stored in the 'build' folder. Include the files in your page <head> section.

You'll also need to include the AngularJS library file (please refer 'bower.json' file for complete dependency details).

<!-- minified component css -->
<link rel="stylesheet" type="text/css" href="build/pdb.litemol.min.css">

<!-- Dependencey scripts (these can be skipped if already included in page) -->
<script src="bower_components/angular/angular.min.js"></script>

<!-- minified component js -->
<script src="build/pdb.litemol.min.js"></script>

2. Installation

As soon as you've got the dependencies and library files included in your application page you just need to include following installation script :

I) If you are developing an AngularJs Application

<script>
angular.module('myModule', ['pdb.litemol']);
</script>

II) For other Applications

<script>
(function () {
  'use strict';
  angular.element(document).ready(function () {
      angular.bootstrap(document, ['pdb.litemol']);
  });
}());
</script>

3. Using component as custom element anywhere in the page

The component can be used as custom element, attribute or class anywhere in the page.

<!-- component as custom element -->
<pdb-lite-mol pdb-id="'1cbs'"></pdb-lite-mol>

<!-- component as attribute -->
<div pdb-lite-mol pdb-id="'1cbs'"></div>

<!-- component as class -->
<div class="pdb-lite-mol" pdb-id="'1cbs'"></div>

Documentation

Attributes

| Sr. No. | Attribute | Values | Description | |:-------------:|:-------------|:-----|:-----| | 1 | pdb-id | PDB ID Mandatory attribute! | Example : pdb-id='1cbs' | | 2 | load-ed-maps | Boolean (true/false) (Optional Attribute) Default : 'false' |Load Electron Density Maps if value is set to trueExample : load-ed-maps="true" | | 3 | hide-controls | Boolean (true/false) (Optional Attribute) Default : 'false' |Hide controls menu if value is set to trueExample : hide-controls="true" | | 4 | custom-query | refer: Coordinate Server |load specific part of the structureExample : custom-query="ligandInteraction?name=REA&radius=4" | | 5 | show-logs | Boolean (true/false) (Optional Attribute) Default : 'true' |Display logs panel | | 6 | tree-menu | Boolean (true/false) (Optional Attribute) Default : 'false' |Display Menu in Tree/CCP4 format | | 7 | is-expanded | Boolean (true/false) (Optional Attribute) Default : 'false' |Display full screen | | 8 | validation-annotation | Boolean (true/false) (Optional Attribute) Default : 'false' |Load Validation Report Annotation (works only when tree-menu='false') | | 9 | domain-annotation | Boolean (true/false) (Optional Attribute) Default : 'false' |Load Domain Annotation (works only when tree-menu='false') | | 10 | source-url | Absolute url to downlaod structure data (Optional attribute) |load specific data from a given url. Note - you have to add 'source-format' attribute to load data using this option.Example: source-url="http://ftp.ebi.ac.uk/pub/databases/msd/pdbechem/files/sdf/ATP.sdf" | | 11 | source-format | String supported format : mmcif, bcif (binarycif) , pdb, sdf - (Optional attribute) * Default : 'mmcif' |This attribute is mandatory to load data using 'source-url' attribute. Example: source-format="sdf" | | 12 | display-full-map-onload | Boolean (true/false) (Optional Attribute)* Default : 'false' |Display full density map onload | | 13 | subscribe-events | Boolean (true/false) (Optional Attribute) Default : 'true' |Subscribe to other PDB Components custom events. |

Helper functions

Use this to programatically control the component. Check out the examples (litemol-customize-demo.html) to see how the helper function can be used.

| Sr. No. | Function | Description | |:-------------:|:-------------|:-----| | 1 | hideControls()| Use : hide control panel.Parameter : none | | 2 | showControls()| Use : show control panel.Parameter : none | | 3 | expand()| Use : switch to full-screen mode.Parameter : none | | 4 | setBackground()| Use : set background colour to white.Parameter : none | | 5 | loadDensity(isWireframe)| Use : programatically load density.Parameter : 1. isWireframe (type : boolean) (value : true / false)if set to..true : shows density as wire-frame.false: shows density as surface. | | 6 | toggleDensity()| Use : programatically toggle density.Parameter : none | | 7 | colorChains( chainId, colorArr )| Use : set chain colour and greys out remaining residues colour.Parameter : 1. chainId (type : string)2. colorArr (type : array) (value : RGB value - example : [255,0,0] for red) | | 8 | SelectExtractFocus(selectionDetails, colorCode, showSideChains)| Use : Colour and focus desired range of residues in the structure.Parameter : 1. selectionDetails (type : object)Example :{    entity_id : '1',    struct_asym_id : 'A',    start_residue_number : 10,    end_residue_number : 15}2. colorCode (type : object) (value : RGB value - example : {r:255, g:0, b:0} for red)3. showSideChains (type : boolean) (value : true / false) (optional)if set to..true : shows sidechain residues for the selected range. | | 9 | highlightOn(selectionDetails)| Use : highlight desired range of residues in the structure.Similar to SelectExtractFocus() except it do not allow colour setting and focus.Parameter : 1. selectionDetails (type : object)Example :{    entity_id : '1',    struct_asym_id : 'A',    start_residue_number : 10,    end_residue_number : 15} | | 10 | highlightOff()| Use :Removes highlight set using highlightOn()Parameter : none | | 11 | resetThemeSelHighlight()| Use : Reset any selection and highlight to default.Parameter : none |

Custom Events

Use this to subscript/bind events of this component. Event data (available in key = 'eventData') contains information about the residue number, chain, entry and entity, etc.

| Sr. No. | Event | Description | |:-------------:|:-------------|:-----| | 1 | PDB.litemol.click | Use this to bind to the click event of this component elements. Event data (available in key = 'eventData') contains information structure residue clicked Example: document.addEventListener('PDB.litemol.click', function(e){ //do something on event }) | | 2 | PDB.litemol.mouseover | Use this to bind to the mouseover event of this component elements. Example: document.addEventListener('PDB.seqViewer.mouseover', function(e){ //do something on event }) | | 3 | PDB.litemol.mouseout | Use this to bind to the mouseout event of this component elements. Example: document.addEventListener('PDB.seqViewer.mouseout', function(e){ //do something on event }) |

Please refer this link for more documentation, demo and parameters details.

Contact

Please use github to report bugs, discuss potential new features or ask questions in general. Also you can contact us here for support, feedback or to report any issues.

License

The plugin is released under the Apache License Version 2.0. You can find out more about it at http://www.apache.org/licenses/LICENSE-2.0 or within the license file of the repository.

If you are interested in this plugin...

...you might also want to have a look at the PDB Component Library.