icn3d

iCn3D Structure Viewer

Usage no npm install needed!

<script type="module">
  import icn3d from 'https://cdn.skypack.dev/icn3d';
</script>

README

icn3d

"I see in 3D" (iCn3D) Structure Viewer is not only a web-based 3D viewer, but also a structure analysis tool interactively or in the batch mode using NodeJS scripts based on the npm package icn3d. iCn3D synchronizes the display of 3D structure, 2D interaction, and 1D sequences and annotations. Users' custom display can be saved in a short URL or a PNG image. More features are listed at iCn3D Doc.

Installation

iCn3D can be installed with the following command:

npm install icn3d

The following packages are required as shown in dependency:

npm install jquery
npm install jsdom
npm install three

Usage

  • Use icn3d as a 3D Viewer

    To use icn3d as a 3D Viewer, the source code is available in the iCn3D GitHub page, not this icn3d npm package. You can following the instruction at iCn3D Doc. The JavaScript code could be as simple as the following:

      var cfg = {'mmdbid': '1tup'};
      var icn3dui = new icn3d.iCn3DUI(cfg);
      icn3dui.show3DStructure();
    
  • Use icn3d to generate Node.js scripts

    To use icn3d to generate Node.js scripts, the source code is from this icn3d npm package. As shown in one example of Node.js script, part of the script can be like the following. All classes and functions can be accessed with the variable "icn3dui". The class structure is listed at iCn3D Doc.

      global.THREE = require('three');
      let jsdom = require('jsdom');
      global.$ = require('jquery')(new jsdom.JSDOM().window);
      
      let icn3d = require('icn3d');
      let icn3dui = new icn3d.iCn3DUI({});