UNPKG

3dmol

Version:

JavaScript/TypeScript molecular visualization library

563 lines (467 loc) 49.7 kB
<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="Author" content="David Koes & 3Dmoljs Contributors"><meta name="Description" content="A modern, object-oriented JavaScript library for visualizing molecular data"><title>Source: VolumeData.ts</title><!--[if lt IE 9]> <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script> <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><style>article ul li{list-style:disc}</style><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124 C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124 c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227 c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6 V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474 c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323 c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848 S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328 c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="light"><div class="sidebar-container"><div class="sidebar" id="sidebar"><a href="/" class="sidebar-title sidebar-title-anchor">3Dmol.js</a><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="mei5HJjYKLn6aua5Z5PM5"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="$3Dmol.Label.html">Label</a></div><div class="sidebar-section-children"><a href="$3Dmol.StateManager.html">StateManager</a></div><div class="sidebar-section-children"><a href="$3Dmol.UI.html">UI</a></div><div class="sidebar-section-children"><a href="Color.html">Color</a></div><div class="sidebar-section-children"><a href="CustomLinear.html">CustomLinear</a></div><div class="sidebar-section-children"><a href="Cylinder.html">Cylinder</a></div><div class="sidebar-section-children"><a href="GLModel.html">GLModel</a></div><div class="sidebar-section-children"><a href="GLShape.html">GLShape</a></div><div class="sidebar-section-children"><a href="GLShape_GLShape.html">GLShape</a></div><div class="sidebar-section-children"><a href="GLViewer.html">GLViewer</a></div><div class="sidebar-section-children"><a href="GLVolumetricRender.html">GLVolumetricRender</a></div><div class="sidebar-section-children"><a href="Matrix3.html">Matrix3</a></div><div class="sidebar-section-children"><a href="Matrix4.html">Matrix4</a></div><div class="sidebar-section-children"><a href="Quaternion.html">Quaternion</a></div><div class="sidebar-section-children"><a href="ROYGB.html">ROYGB</a></div><div class="sidebar-section-children"><a href="RWB.html">RWB</a></div><div class="sidebar-section-children"><a href="Ray.html">Ray</a></div><div class="sidebar-section-children"><a href="Sinebow.html">Sinebow</a></div><div class="sidebar-section-children"><a href="Sphere.html">Sphere</a></div><div class="sidebar-section-children"><a href="Surface.html">Surface</a></div><div class="sidebar-section-children"><a href="Triangle.html">Triangle</a></div><div class="sidebar-section-children"><a href="Vector2.html">Vector2</a></div><div class="sidebar-section-children"><a href="Vector3.html">Vector3</a></div><div class="sidebar-section-children"><a href="VolumeData.html">VolumeData</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="kv4Yx5z0THf_b8XR4Gje1"><div>Namespaces</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="GLDraw.html">GLDraw</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="ykThSufQWJcKGT1kXzr-A"><div>Tutorials</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="tutorial-code.html">Using 3Dmol within your code</a></div><div class="sidebar-section-children"><a href="tutorial-embeddable.html">Embedding a 3Dmol Viewer</a></div><div class="sidebar-section-children"><a href="tutorial-home.html">3Dmol Tutorials - Home</a></div><div class="sidebar-section-children"><a href="tutorial-learning_environment.html">Active Learning with 3Dmol.js</a></div><div class="sidebar-section-children"><a href="tutorial-url.html">Viewing Molecules with the 3Dmol Server</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="XcP4RUEg6tp7YKHbBVi9E"><div>Interfaces</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="AmbientOcclusionStyle.html">AmbientOcclusionStyle</a></div><div class="sidebar-section-children"><a href="ArrowSpec.html">ArrowSpec</a></div><div class="sidebar-section-children"><a href="AtomSelectionSpec.html">AtomSelectionSpec</a></div><div class="sidebar-section-children"><a href="AtomSpec.html">AtomSpec</a></div><div class="sidebar-section-children"><a href="AtomStyleSpec.html">AtomStyleSpec</a></div><div class="sidebar-section-children"><a href="BondStyle.html">BondStyle</a></div><div class="sidebar-section-children"><a href="BoxSpec.html">BoxSpec</a></div><div class="sidebar-section-children"><a href="CartoonStyleSpec.html">CartoonStyleSpec</a></div><div class="sidebar-section-children"><a href="ClickSphereStyleSpec.html">ClickSphereStyleSpec</a></div><div class="sidebar-section-children"><a href="CrossStyleSpec.html">CrossStyleSpec</a></div><div class="sidebar-section-children"><a href="CurveSpec.html">CurveSpec</a></div><div class="sidebar-section-children"><a href="CustomShapeSpec.html">CustomShapeSpec</a></div><div class="sidebar-section-children"><a href="CylinderSpec.html">CylinderSpec</a></div><div class="sidebar-section-children"><a href="DashedBondSpec.html">DashedBondSpec</a></div><div class="sidebar-section-children"><a href="FogSpec.html">FogSpec</a></div><div class="sidebar-section-children"><a href="IsoSurfaceSpec.html">IsoSurfaceSpec</a></div><div class="sidebar-section-children"><a href="LabelSpec.html">LabelSpec</a></div><div class="sidebar-section-children"><a href="LineSpec.html">LineSpec</a></div><div class="sidebar-section-children"><a href="LineStyleSpec.html">LineStyleSpec</a></div><div class="sidebar-section-children"><a href="OutlineStyle.html">OutlineStyle</a></div><div class="sidebar-section-children"><a href="ParserOptionsSpec.html">ParserOptionsSpec</a></div><div class="sidebar-section-children"><a href="ShapeSpec.html">ShapeSpec</a></div><div class="sidebar-section-children"><a href="SphereSpec.html">SphereSpec</a></div><div class="sidebar-section-children"><a href="SphereStyleSpec.html">SphereStyleSpec</a></div><div class="sidebar-section-children"><a href="StickStyleSpec.html">StickStyleSpec</a></div><div class="sidebar-section-children"><a href="SurfaceStyleSpec.html">SurfaceStyleSpec</a></div><div class="sidebar-section-children"><a href="UnitCellStyleSpec.html">UnitCellStyleSpec</a></div><div class="sidebar-section-children"><a href="ViewStyle.html">ViewStyle</a></div><div class="sidebar-section-children"><a href="ViewerGridSpec.html">ViewerGridSpec</a></div><div class="sidebar-section-children"><a href="ViewerSpec.html">ViewerSpec</a></div><div class="sidebar-section-children"><a href="VolumetricRendererSpec.html">VolumetricRendererSpec</a></div><div class="sidebar-section-children"><a href="WithinSelectionSpec.html">WithinSelectionSpec</a></div><div class="sidebar-section-children"><a href="global.html#XYZ">XYZ</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="jmKnIXRJjdjZ366ci7cdd"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#BCIF">BCIF</a></div><div class="sidebar-section-children"><a href="global.html#CAP">CAP</a></div><div class="sidebar-section-children"><a href="global.html#CDJSON">CDJSON</a></div><div class="sidebar-section-children"><a href="global.html#CIF">CIF</a></div><div class="sidebar-section-children"><a href="global.html#CUBE">CUBE</a></div><div class="sidebar-section-children"><a href="global.html#ColorSpec">ColorSpec</a></div><div class="sidebar-section-children"><a href="global.html#ColorschemeSpec">ColorschemeSpec</a></div><div class="sidebar-section-children"><a href="global.html#GRO">GRO</a></div><div class="sidebar-section-children"><a href="global.html#GradientSpec">GradientSpec</a></div><div class="sidebar-section-children"><a href="global.html#MMTFparser">MMTFparser</a></div><div class="sidebar-section-children"><a href="global.html#MOL2">MOL2</a></div><div class="sidebar-section-children"><a href="global.html#OFFSETS">OFFSETS</a></div><div class="sidebar-section-children"><a href="global.html#PDB">PDB</a></div><div class="sidebar-section-children"><a href="global.html#PQR">PQR</a></div><div class="sidebar-section-children"><a href="global.html#PRMTOP">PRMTOP</a></div><div class="sidebar-section-children"><a href="global.html#SDF">SDF</a></div><div class="sidebar-section-children"><a href="global.html#SurfaceType">SurfaceType</a></div><div class="sidebar-section-children"><a href="global.html#VASP">VASP</a></div><div class="sidebar-section-children"><a href="global.html#XYZ">XYZ</a></div><div class="sidebar-section-children"><a href="global.html#assignPDBBonds">assignPDBBonds</a></div><div class="sidebar-section-children"><a href="global.html#builtinColorSchemes">builtinColorSchemes</a></div><div class="sidebar-section-children"><a href="global.html#builtinGradients">builtinGradients</a></div><div class="sidebar-section-children"><a href="global.html#conversionMatrix3">conversionMatrix3</a></div><div class="sidebar-section-children"><a href="global.html#createViewer">createViewer</a></div><div class="sidebar-section-children"><a href="global.html#createViewerGrid">createViewerGrid</a></div><div class="sidebar-section-children"><a href="global.html#decode">decode</a></div><div class="sidebar-section-children"><a href="global.html#dic">dic</a></div><div class="sidebar-section-children"><a href="global.html#download">download</a></div><div class="sidebar-section-children"><a href="global.html#elementColors">elementColors</a></div><div class="sidebar-section-children"><a href="global.html#get">get</a></div><div class="sidebar-section-children"><a href="global.html#getColorFromStyle">getColorFromStyle</a></div><div class="sidebar-section-children"><a href="global.html#getbin">getbin</a></div><div class="sidebar-section-children"><a href="global.html#parseV3000">parseV3000</a></div><div class="sidebar-section-children"><a href="global.html#setSyncSurface">setSyncSurface</a></div><div class="sidebar-section-children"><a href="global.html#ssColors">ssColors</a></div><div class="sidebar-section-children"><a href="global.html#syncSurface">syncSurface</a></div><div class="sidebar-section-children"><a href="global.html#viewers">viewers</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"><div class="navbar-item"><a id="" href="https://3dmol.org/doc/index.html" target="">Documentation</a></div><div class="navbar-item"><a id="" href="tutorial-home.html" target="">Tutorials</a></div><div class="navbar-item"><a id="" href="https://github.com/3dmol/3Dmol.js" target="_blank">GitHub</a></div></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#dark-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">VolumeData.ts</h1></header><article><pre class="prettyprint source lang-js"><code>import { base64ToArray } from "./utilities"; import { Vector3, Matrix4 } from "./WebGL/math"; import { VASP } from "./parsers/VASP"; import { CUBE } from "./parsers/CUBE"; import { inflate } from "pako"; interface VolumeDataOptions { negate?: boolean; normalize?: boolean; }; /** * $3Dmol.VolumeData stores volumetric data. This includes file parsing * functionality. * * @class * @param {string} str - volumetric data * @param {string} format - format of supplied data (cube, dx, vasp); append .gz if compressed * @param {Object} options - normalize (zero mean, unit variance), negate */ export class VolumeData { unit = { x: 1, y: 1, z: 1 }; // scale of each voxel origin = { x: 0, y: 0, z: 0 }; // origin (bottom "left", not center) size = { x: 0, y: 0, z: 0 }; // number of voxels in each direction data = new Float32Array([]); // actual floating point data, arranged // x->y->z matrix: any = null; //if set must transform data inversematrix: Matrix4|null = null; dimensionorder: any; isbinary = new Set&lt;string>(['ccp4','CCP4']); constructor(str: any, format: string, options?: VolumeDataOptions) { format = format.toLowerCase(); if (/\.gz$/.test(format)) { //unzip gzipped files format = format.replace(/\.gz$/, ''); try { if ((this as any)[format] &amp;&amp; this.isbinary.has(format)) { if (typeof (str) == "string") { //assume base64 encoded str = base64ToArray(str); } str = inflate(str); } else { str = new TextDecoder("utf-8").decode(inflate(str)); } } catch (err) { console.error(err); } } if ((this as any)[format]) { if (this.isbinary.has(format) &amp;&amp; typeof (str) == "string") { str = base64ToArray(str); } (this as any)[format](str); } if (options) { if (options.negate) { for (let i = 0, n = this.data.length; i &lt; n; i++) { this.data[i] = -this.data[i]; } } if (options.normalize) { var total = 0.0; for (let i = 0, n = this.data.length; i &lt; n; i++) { total += this.data[i]; } var mean = total / this.data.length; total = 0; for (let i = 0, n = this.data.length; i &lt; n; i++) { var diff = this.data[i] - mean; total += diff * diff; //variance is ave of squared difference with mean } var variance = total / this.data.length; //now normalize for (let i = 0, n = this.data.length; i &lt; n; i++) { this.data[i] = (this.data[i] - mean) / variance; } } } } /** * @function $3Dmol.VolumeData.getIndex * @param {number} x,y,z - the coordinates * @returns - index into flat array closest to provided coordinate; -1 if invalid */ getIndex(x: number, y: number, z: number) { if (this.matrix) { //all transformation is done through matrix multiply if (this.inversematrix == null) { this.inversematrix = new Matrix4().getInverse(this.matrix); } var pt = new Vector3(x, y, z); pt = pt.applyMatrix4(this.inversematrix as Matrix4); x = pt.x; y = pt.y; z = pt.z; } else { //use simple origin/unit transform x -= this.origin.x; y -= this.origin.y; z -= this.origin.z; x /= this.unit.x; y /= this.unit.y; z /= this.unit.z; } x = Math.round(x); y = Math.round(y); z = Math.round(z); if (x &lt; 0 || x >= this.size.x) return -1; if (y &lt; 0 || y >= this.size.y) return -1; if (z &lt; 0 || z >= this.size.z) return -1; return x * this.size.y * this.size.z + y * this.size.z + z; }; /** * @function $3Dmol.VolumeData.getVal * @param {number} x,y,z - the coordinates * @returns - value closest to provided coordinate; zero if coordinate invalid */ getVal(x: number, y: number, z: number) { let i = this.getIndex(x, y, z); if (i &lt; 0) return 0; return this.data[i]; }; getCoordinates = function (index: number) { var x = index / (this.size.y * this.size.z); var y = index % (this.size.y * this.size.z); var z = index % this.size.z; x *= this.unit.x; y *= this.unit.y; z *= this.unit.z; x += this.origin.x; y += this.origin.y; z += this.origin.z; return { x: x, y: y, z: z }; }; /* * parse vasp data * Essentially this parser converts the CHGCAR data into * cube data. It has been adapted from 'chg2cube.pl' found in * http://theory.cm.utexas.edu/vtsttools/ */ vasp = function (str: string) { var lines = str.replace(/^\s+/, "").split(/[\n\r]/); var atomicData = VASP(str)[0]; var natoms = atomicData.length; if (natoms == 0) { console.warn("No good formating of CHG or CHGCAR file, not atomic information provided in the file."); this.data = []; return; } // Assume atomic units // var unittype = "bohr/hartree"; var l_units = 1.889725992; var e_units = 0.036749309; // copied from $3Dmol.Parsers.vasp var convFactor = parseFloat(lines[1]); // This is how Vasp reads in the basis We need the l_units in order to // compute the volume of the cell. Afterwards to obtain the axis for the // voxels we have to remove this unit and divide by the number of voxels in // each dimension var v: string[]; v = lines[2].replace(/^\s+/, "").split(/\s+/); var xVec = new Vector3(parseFloat(v[0]), parseFloat(v[1]), parseFloat(v[2])).multiplyScalar(convFactor * l_units); v = lines[3].replace(/^\s+/, "").split(/\s+/); var yVec = new Vector3(parseFloat(v[0]), parseFloat(v[1]), parseFloat(v[2])).multiplyScalar(convFactor * l_units); v = lines[4].replace(/^\s+/, "").split(/\s+/); var zVec = new Vector3(parseFloat(v[0]), parseFloat(v[1]), parseFloat(v[2])).multiplyScalar(convFactor * l_units); // correct volume for non-orthognal box (expansion by minors) var vol = xVec.x * (yVec.y * zVec.z - zVec.y * yVec.z) - yVec.x * (xVec.y * zVec.z - zVec.y * xVec.z) + zVec.x * (xVec.y * yVec.z - yVec.y * xVec.z); vol = Math.abs(vol) / (Math.pow(l_units, 3)); var vol_scale = 1.0 / (vol); //This Only for CHGCAR files // We splice the structure information // 2 (header) + 3 (vectors) + 2 (atoms) + 1 (vaspMode) + natoms (coords) + 1 (blank line) lines.splice(0, 2 + 3 + 2 + 1 + natoms + 1); var lineArr = lines[0].replace(/^\s+/, "").replace(/\s+/g, " ").split(" "); var nX = Math.abs(parseFloat(lineArr[0])); var nY = Math.abs(parseFloat(lineArr[1])); var nZ = Math.abs(parseFloat(lineArr[2])); var origin = this.origin = new Vector3(0, 0, 0); this.size = { x: nX, y: nY, z: nZ }; this.unit = new Vector3(xVec.x, yVec.y, zVec.z); // resize the vectors accordingly xVec = xVec.multiplyScalar(1 / (l_units * nX)); yVec = yVec.multiplyScalar(1 / (l_units * nY)); zVec = zVec.multiplyScalar(1 / (l_units * nZ)); if (xVec.y != 0 || xVec.z != 0 || yVec.x != 0 || yVec.z != 0 || zVec.x != 0 || zVec.y != 0) { //need a transformation matrix this.matrix = new Matrix4(xVec.x, yVec.x, zVec.x, 0, xVec.y, yVec.y, zVec.y, 0, xVec.z, yVec.z, zVec.z, 0, 0, 0, 0, 1); //include translation in matrix this.matrix = this.matrix.multiplyMatrices(this.matrix, new Matrix4().makeTranslation(origin.x, origin.y, origin.z)); //all translation and scaling done by matrix, so reset origin and unit this.origin = new Vector3(0, 0, 0); this.unit = new Vector3(1, 1, 1); } lines.splice(0, 1); // Remove the dimension line var raw = lines.join(" "); raw = raw.replace(/^\s+/, ''); var rawArray = raw.split(/[\s\r]+/); rawArray.splice(nX * nY * nZ + 1); var preConvertedData = Float32Array.from(rawArray, parseFloat); //We still have to format it to get the density for (var i = 0; i &lt; preConvertedData.length; i++) { preConvertedData[i] = preConvertedData[i] * vol_scale * e_units; } this.data = preConvertedData; }; // parse dx data - does not support all features of the file format dx = function (str: string) { var lines = str.split(/[\n\r]+/); var m: string[]; var recounts = /gridpositions\s+counts\s+(\d+)\s+(\d+)\s+(\d+)/; var reorig = /^origin\s+(\S+)\s+(\S+)\s+(\S+)/; var redelta = /^delta\s+(\S+)\s+(\S+)\s+(\S+)/; var follows = /data follows/; var i = 0; for (i = 0; i &lt; lines.length; i++) { var line = lines[i]; if ((m = recounts.exec(line))) { var nX = parseInt(m[1]); var nY = parseInt(m[2]); var nZ = parseInt(m[3]); this.size = { x: nX, y: nY, z: nZ }; } else if ((m = redelta.exec(line))) { var xunit = parseFloat(m[1]); if (parseFloat(m[2]) != 0 || parseFloat(m[3]) != 0) { console.warn("Non-orthogonal delta matrix not currently supported in dx format"); } i += 1; line = lines[i]; m = redelta.exec(line); if (m == null) { console.error("Parse error in dx delta matrix"); return; } var yunit = parseFloat(m[2]); if (parseFloat(m[1]) != 0 || parseFloat(m[3]) != 0) { console.warn("Non-orthogonal delta matrix not currently supported in dx format"); } i += 1; line = lines[i]; m = redelta.exec(line); if (m == null) { console.error("Parse error in dx delta matrix"); return; } var zunit = parseFloat(m[3]); if (parseFloat(m[1]) != 0 || parseFloat(m[2]) != 0) { console.warn("Non-orthogonal delta matrix not currently supported in dx format"); } this.unit = new Vector3(xunit, yunit, zunit); } else if ((m = reorig.exec(line))) { var xorig = parseFloat(m[1]); var yorig = parseFloat(m[2]); var zorig = parseFloat(m[3]); this.origin = new Vector3(xorig, yorig, zorig); } else if ((m = follows.exec(line))) { break; } } i += 1; if (!this.size || !this.origin || !this.unit || !this.size) { console.error("Error parsing dx format"); return; } var raw = lines.splice(i).join(" "); var rawArray = raw.split(/[\s\r]+/); this.data = Float32Array.from(rawArray, parseFloat); }; // parse cube data cube(str: string) { var lines = str.split(/\r?\n/); if (lines.length &lt; 6) return; var cryst = CUBE(str, {}).modelData[0].cryst; var lineArr = lines[2].replace(/^\s+/, "").replace(/\s+/g, " ").split(" "); var atomsnum = parseFloat(lineArr[0]); //includes sign, which indicates presence of oribital line in header var natoms = Math.abs(atomsnum); this.origin = cryst.origin; this.size = cryst.size; this.unit = cryst.unit; this.matrix = cryst.matrix4; var headerlines = 6; if (atomsnum &lt; 0) headerlines++; //see: http://www.ks.uiuc.edu/Research/vmd/plugins/molfile/cubeplugin.html var raw = lines.splice(natoms + headerlines).join(" "); raw = raw.replace(/^\s+/, ''); var rawArray = raw.split(/[\s\r]+/); this.data = Float32Array.from(rawArray, parseFloat); }; //parse cp4 files ccp4(bin: Int8Array) { // http://www.ccp4.ac.uk/html/maplib.html#description //code from ngl: https://github.com/arose/ngl/blob/master/js/ngl/parser.js var header:any = {}; bin = new Int8Array(bin); var intView = new Int32Array(bin.buffer, 0, 56); var floatView = new Float32Array(bin.buffer, 0, 56); var dv = new DataView(bin.buffer); // 53 MAP Character string 'MAP ' to identify file type header.MAP = String.fromCharCode( dv.getUint8(52 * 4), dv.getUint8(52 * 4 + 1), dv.getUint8(52 * 4 + 2), dv.getUint8(52 * 4 + 3) ); // 54 MACHST Machine stamp indicating machine type which wrote file // 17 and 17 for big-endian or 68 and 65 for little-endian header.MACHST = [dv.getUint8(53 * 4), dv.getUint8(53 * 4 + 1)]; // swap byte order when big endian if (header.MACHST[0] === 17 &amp;&amp; header.MACHST[1] === 17) { var n = bin.byteLength; for (var i = 0; i &lt; n; i += 4) { dv.setFloat32(i, dv.getFloat32(i), true); } } header.NX = intView[0]; // NC - columns (fastest changing) header.NY = intView[1]; // NR - rows header.NZ = intView[2]; // NS - sections (slowest changing) // mode // 0 image : signed 8-bit bytes range -128 to 127 // 1 image : 16-bit halfwords // 2 image : 32-bit reals // 3 transform : complex 16-bit integers // 4 transform : complex 32-bit reals // 6 image : unsigned 16-bit range 0 to 65535 // 16 image: unsigned char * 3 (for rgb data, non-standard) // // Note: Mode 2 is the normal mode used in the CCP4 programs. // Other modes than 2 and 0 may NOT WORK header.MODE = intView[3]; // start header.NXSTART = intView[4]; // NCSTART - first column header.NYSTART = intView[5]; // NRSTART - first row header.NZSTART = intView[6]; // NSSTART - first section // intervals header.MX = intView[7]; // intervals along x header.MY = intView[8]; // intervals along y header.MZ = intView[9]; // intervals along z // cell length (Angstroms in CCP4) header.xlen = floatView[10]; header.ylen = floatView[11]; header.zlen = floatView[12]; // cell angle (Degrees) header.alpha = floatView[13]; header.beta = floatView[14]; header.gamma = floatView[15]; // axis correspondence (1,2,3 for X,Y,Z) header.MAPC = intView[16]; // column header.MAPR = intView[17]; // row header.MAPS = intView[18]; // section // density statistics header.DMIN = floatView[19]; header.DMAX = floatView[20]; header.DMEAN = floatView[21]; // space group number 0 or 1 (default=0) header.ISPG = intView[22]; // number of bytes used for symmetry data (0 or 80) header.NSYMBT = intView[23]; // Flag for skew transformation, =0 none, =1 if foll header.LSKFLG = intView[24]; // 26-34 SKWMAT Skew matrix S (in order S11, S12, S13, S21 etc) if // LSKFLG .ne. 0. // 35-37 SKWTRN Skew translation t if LSKFLG != 0. // Skew transformation is from standard orthogonal // coordinate frame (as used for atoms) to orthogonal // map frame, as Xo(map) = S * (Xo(atoms) - t) // 38 future use (some of these are used by the MSUBSX routines // . " in MAPBRICK, MAPCONT and FRODO) // . " (all set to zero by default) // . " // 52 " // 50-52 origin in X,Y,Z used for transforms header.originX = floatView[49]; header.originY = floatView[50]; header.originZ = floatView[51]; // 53 MAP Character string 'MAP ' to identify file type // => see top of this parser // 54 MACHST Machine stamp indicating machine type which wrote file // => see top of this parser // Rms deviation of map from mean density header.ARMS = floatView[54]; // 56 NLABL Number of labels being used // 57-256 LABEL(20,10) 10 80 character text labels (ie. A4 format) //create transformation matrix, code mostly copied from ngl var h = header; var basisX: Array&lt;any> = [ h.xlen, 0, 0 ]; var basisY: Array&lt;any> = [ h.ylen * Math.cos(Math.PI / 180.0 * h.gamma), h.ylen * Math.sin(Math.PI / 180.0 * h.gamma), 0 ]; var basisZ: Array&lt;any> = [ h.zlen * Math.cos(Math.PI / 180.0 * h.beta), h.zlen * ( Math.cos(Math.PI / 180.0 * h.alpha) - Math.cos(Math.PI / 180.0 * h.gamma) * Math.cos(Math.PI / 180.0 * h.beta) ) / Math.sin(Math.PI / 180.0 * h.gamma), 0 ]; basisZ[2] = Math.sqrt( h.zlen * h.zlen * Math.sin(Math.PI / 180.0 * h.beta) * Math.sin(Math.PI / 180.0 * h.beta) - basisZ[1] * basisZ[1] ); var basis: Array&lt;any> = [0, basisX, basisY, basisZ]; var nxyz: Array&lt;any> = [0, h.MX, h.MY, h.MZ]; var mapcrs: Array&lt;any> = [0, h.MAPC, h.MAPR, h.MAPS]; this.matrix = new Matrix4(); this.matrix.set( basis[mapcrs[1]][0] / nxyz[mapcrs[1]], basis[mapcrs[2]][0] / nxyz[mapcrs[2]], basis[mapcrs[3]][0] / nxyz[mapcrs[3]], 0, basis[mapcrs[1]][1] / nxyz[mapcrs[1]], basis[mapcrs[2]][1] / nxyz[mapcrs[2]], basis[mapcrs[3]][1] / nxyz[mapcrs[3]], 0, basis[mapcrs[1]][2] / nxyz[mapcrs[1]], basis[mapcrs[2]][2] / nxyz[mapcrs[2]], basis[mapcrs[3]][2] / nxyz[mapcrs[3]], 0, 0, 0, 0, 1 ); //include translation in matrix, NXSTART etc are an offset in grid space this.matrix = this.matrix.multiplyMatrices( this.matrix, new Matrix4().makeTranslation( h.NXSTART + h.originX, h.NYSTART + h.originY, h.NZSTART + h.originZ) ); //all translation and scaling done by matrix, so reset origin and unit this.origin = new Vector3(0, 0, 0); this.unit = new Vector3(1, 1, 1); this.size = { x: header.NX, y: header.NY, z: header.NZ }; this.dimensionorder = [header.MAPC, header.MAPR, header.MAPS]; var data = new Float32Array(bin.buffer, 1024 + header.NSYMBT); //data must by (slowest changing) x,y,z (fastest changing) var NX = header.NX, NY = header.NY, NZ = header.NZ; this.data = new Float32Array(NX * NY * NZ); for (let i = 0; i &lt; NX; i++) { for (let j = 0; j &lt; NY; j++) { for (let k = 0; k &lt; NZ; k++) { //should I be concerned that I'm not using mapc? this.data[((i * NY) + j) * NZ + k] = data[((k * NY) + j) * NX + i]; } } } }; }; </code></pre></article></section><footer class="footer" id="PeOAagUepe"><div class="wrapper">3Dmol.js © 2019-2024 | <a href="https://pitt.edu/" target="_blank">University of Pittsburgh</a> | <a href="https://github.com/3dmol/3Dmol.js/blob/master/LICENSE" target="_blank">License</a></div></footer></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><a href="/" class="sidebar-title sidebar-title-anchor">3Dmol.js</a><div class="mobile-nav-links"><div class="navbar-item"><a id="" href="https://3dmol.org/doc/index.html" target="">Documentation</a></div><div class="navbar-item"><a id="" href="tutorial-home.html" target="">Tutorials</a></div><div class="navbar-item"><a id="" href="https://github.com/3dmol/3Dmol.js" target="_blank">GitHub</a></div></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="mei5HJjYKLn6aua5Z5PM5"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="$3Dmol.Label.html">Label</a></div><div class="sidebar-section-children"><a href="$3Dmol.StateManager.html">StateManager</a></div><div class="sidebar-section-children"><a href="$3Dmol.UI.html">UI</a></div><div class="sidebar-section-children"><a href="Color.html">Color</a></div><div class="sidebar-section-children"><a href="CustomLinear.html">CustomLinear</a></div><div class="sidebar-section-children"><a href="Cylinder.html">Cylinder</a></div><div class="sidebar-section-children"><a href="GLModel.html">GLModel</a></div><div class="sidebar-section-children"><a href="GLShape.html">GLShape</a></div><div class="sidebar-section-children"><a href="GLShape_GLShape.html">GLShape</a></div><div class="sidebar-section-children"><a href="GLViewer.html">GLViewer</a></div><div class="sidebar-section-children"><a href="GLVolumetricRender.html">GLVolumetricRender</a></div><div class="sidebar-section-children"><a href="Matrix3.html">Matrix3</a></div><div class="sidebar-section-children"><a href="Matrix4.html">Matrix4</a></div><div class="sidebar-section-children"><a href="Quaternion.html">Quaternion</a></div><div class="sidebar-section-children"><a href="ROYGB.html">ROYGB</a></div><div class="sidebar-section-children"><a href="RWB.html">RWB</a></div><div class="sidebar-section-children"><a href="Ray.html">Ray</a></div><div class="sidebar-section-children"><a href="Sinebow.html">Sinebow</a></div><div class="sidebar-section-children"><a href="Sphere.html">Sphere</a></div><div class="sidebar-section-children"><a href="Surface.html">Surface</a></div><div class="sidebar-section-children"><a href="Triangle.html">Triangle</a></div><div class="sidebar-section-children"><a href="Vector2.html">Vector2</a></div><div class="sidebar-section-children"><a href="Vector3.html">Vector3</a></div><div class="sidebar-section-children"><a href="VolumeData.html">VolumeData</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="kv4Yx5z0THf_b8XR4Gje1"><div>Namespaces</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="GLDraw.html">GLDraw</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="ykThSufQWJcKGT1kXzr-A"><div>Tutorials</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="tutorial-code.html">Using 3Dmol within your code</a></div><div class="sidebar-section-children"><a href="tutorial-embeddable.html">Embedding a 3Dmol Viewer</a></div><div class="sidebar-section-children"><a href="tutorial-home.html">3Dmol Tutorials - Home</a></div><div class="sidebar-section-children"><a href="tutorial-learning_environment.html">Active Learning with 3Dmol.js</a></div><div class="sidebar-section-children"><a href="tutorial-url.html">Viewing Molecules with the 3Dmol Server</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="XcP4RUEg6tp7YKHbBVi9E"><div>Interfaces</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="AmbientOcclusionStyle.html">AmbientOcclusionStyle</a></div><div class="sidebar-section-children"><a href="ArrowSpec.html">ArrowSpec</a></div><div class="sidebar-section-children"><a href="AtomSelectionSpec.html">AtomSelectionSpec</a></div><div class="sidebar-section-children"><a href="AtomSpec.html">AtomSpec</a></div><div class="sidebar-section-children"><a href="AtomStyleSpec.html">AtomStyleSpec</a></div><div class="sidebar-section-children"><a href="BondStyle.html">BondStyle</a></div><div class="sidebar-section-children"><a href="BoxSpec.html">BoxSpec</a></div><div class="sidebar-section-children"><a href="CartoonStyleSpec.html">CartoonStyleSpec</a></div><div class="sidebar-section-children"><a href="ClickSphereStyleSpec.html">ClickSphereStyleSpec</a></div><div class="sidebar-section-children"><a href="CrossStyleSpec.html">CrossStyleSpec</a></div><div class="sidebar-section-children"><a href="CurveSpec.html">CurveSpec</a></div><div class="sidebar-section-children"><a href="CustomShapeSpec.html">CustomShapeSpec</a></div><div class="sidebar-section-children"><a href="CylinderSpec.html">CylinderSpec</a></div><div class="sidebar-section-children"><a href="DashedBondSpec.html">DashedBondSpec</a></div><div class="sidebar-section-children"><a href="FogSpec.html">FogSpec</a></div><div class="sidebar-section-children"><a href="IsoSurfaceSpec.html">IsoSurfaceSpec</a></div><div class="sidebar-section-children"><a href="LabelSpec.html">LabelSpec</a></div><div class="sidebar-section-children"><a href="LineSpec.html">LineSpec</a></div><div class="sidebar-section-children"><a href="LineStyleSpec.html">LineStyleSpec</a></div><div class="sidebar-section-children"><a href="OutlineStyle.html">OutlineStyle</a></div><div class="sidebar-section-children"><a href="ParserOptionsSpec.html">ParserOptionsSpec</a></div><div class="sidebar-section-children"><a href="ShapeSpec.html">ShapeSpec</a></div><div class="sidebar-section-children"><a href="SphereSpec.html">SphereSpec</a></div><div class="sidebar-section-children"><a href="SphereStyleSpec.html">SphereStyleSpec</a></div><div class="sidebar-section-children"><a href="StickStyleSpec.html">StickStyleSpec</a></div><div class="sidebar-section-children"><a href="SurfaceStyleSpec.html">SurfaceStyleSpec</a></div><div class="sidebar-section-children"><a href="UnitCellStyleSpec.html">UnitCellStyleSpec</a></div><div class="sidebar-section-children"><a href="ViewStyle.html">ViewStyle</a></div><div class="sidebar-section-children"><a href="ViewerGridSpec.html">ViewerGridSpec</a></div><div class="sidebar-section-children"><a href="ViewerSpec.html">ViewerSpec</a></div><div class="sidebar-section-children"><a href="VolumetricRendererSpec.html">VolumetricRendererSpec</a></div><div class="sidebar-section-children"><a href="WithinSelectionSpec.html">WithinSelectionSpec</a></div><div class="sidebar-section-children"><a href="global.html#XYZ">XYZ</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="jmKnIXRJjdjZ366ci7cdd"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#BCIF">BCIF</a></div><div class="sidebar-section-children"><a href="global.html#CAP">CAP</a></div><div class="sidebar-section-children"><a href="global.html#CDJSON">CDJSON</a></div><div class="sidebar-section-children"><a href="global.html#CIF">CIF</a></div><div class="sidebar-section-children"><a href="global.html#CUBE">CUBE</a></div><div class="sidebar-section-children"><a href="global.html#ColorSpec">ColorSpec</a></div><div class="sidebar-section-children"><a href="global.html#ColorschemeSpec">ColorschemeSpec</a></div><div class="sidebar-section-children"><a href="global.html#GRO">GRO</a></div><div class="sidebar-section-children"><a href="global.html#GradientSpec">GradientSpec</a></div><div class="sidebar-section-children"><a href="global.html#MMTFparser">MMTFparser</a></div><div class="sidebar-section-children"><a href="global.html#MOL2">MOL2</a></div><div class="sidebar-section-children"><a href="global.html#OFFSETS">OFFSETS</a></div><div class="sidebar-section-children"><a href="global.html#PDB">PDB</a></div><div class="sidebar-section-children"><a href="global.html#PQR">PQR</a></div><div class="sidebar-section-children"><a href="global.html#PRMTOP">PRMTOP</a></div><div class="sidebar-section-children"><a href="global.html#SDF">SDF</a></div><div class="sidebar-section-children"><a href="global.html#SurfaceType">SurfaceType</a></div><div class="sidebar-section-children"><a href="global.html#VASP">VASP</a></div><div class="sidebar-section-children"><a href="global.html#XYZ">XYZ</a></div><div class="sidebar-section-children"><a href="global.html#assignPDBBonds">assignPDBBonds</a></div><div class="sidebar-section-children"><a href="global.html#builtinColorSchemes">builtinColorSchemes</a></div><div class="sidebar-section-children"><a href="global.html#builtinGradients">builtinGradients</a></div><div class="sidebar-section-children"><a href="global.html#conversionMatrix3">conversionMatrix3</a></div><div class="sidebar-section-children"><a href="global.html#createViewer">createViewer</a></div><div class="sidebar-section-children"><a href="global.html#createViewerGrid">createViewerGrid</a></div><div class="sidebar-section-children"><a href="global.html#decode">decode</a></div><div class="sidebar-section-children"><a href="global.html#dic">dic</a></div><div class="sidebar-section-children"><a href="global.html#download">download</a></div><div class="sidebar-section-children"><a href="global.html#elementColors">elementColors</a></div><div class="sidebar-section-children"><a href="global.html#get">get</a></div><div class="sidebar-section-children"><a href="global.html#getColorFromStyle">getColorFromStyle</a></div><div class="sidebar-section-children"><a href="global.html#getbin">getbin</a></div><div class="sidebar-section-children"><a href="global.html#parseV3000">parseV3000</a></div><div class="sidebar-section-children"><a href="global.html#setSyncSurface">setSyncSurface</a></div><div class="sidebar-section-children"><a href="global.html#ssColors">ssColors</a></div><div class="sidebar-section-children"><a href="global.html#syncSurface">syncSurface</a></div><div class="sidebar-section-children"><a href="global.html#viewers">viewers</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#dark-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>