binary-type-tree

<!doctype html> <html class="default no-js"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>binary-type-tree</title> <meta name="description" content=""> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="stylesheet" href="assets/css/main.css"> </head> <body> <header> <div class="tsd-page-toolbar"> <div class="container"> <div class="table-wrap"> <div class="table-cell" id="tsd-search" data-index="assets/js/search.js" data-base="."> <div class="field"> <label for="tsd-search-field" class="tsd-widget search no-caption">Search</label> <input id="tsd-search-field" type="text" /> </div> <ul class="results"> <li class="state loading">Preparing search index...</li> <li class="state failure">The search index is not available</li> </ul> <a href="index.html" class="title">binary-type-tree</a> </div> <div class="table-cell" id="tsd-widgets"> <div id="tsd-filter"> <a href="#" class="tsd-widget options no-caption" data-toggle="options">Options</a> <div class="tsd-filter-group"> <div class="tsd-select" id="tsd-filter-visibility"> All <ul class="tsd-select-list"> <li data-value="public">Public</li> <li data-value="protected">Public/Protected</li> <li data-value="private" class="selected">All</li> </ul> </div> <input type="checkbox" id="tsd-filter-inherited" checked /> <label class="tsd-widget" for="tsd-filter-inherited">Inherited</label> <input type="checkbox" id="tsd-filter-only-exported" /> <label class="tsd-widget" for="tsd-filter-only-exported">Only exported</label> </div> </div> <a href="#" class="tsd-widget menu no-caption" data-toggle="menu">Menu</a> </div> </div> </div> </div> <div class="tsd-page-title"> <div class="container"> <ul class="tsd-breadcrumb"> <li> <a href="globals.html">Globals</a> </li> </ul> <h1> binary-type-tree</h1> </div> </div> </header> <div class="container container-main"> <div class="row"> <div class="col-8 col-content"> <div class="tsd-panel tsd-typography"> <a href="https://travis-ci.org/marcusjwhelan/binary-type-tree"><img src="https://travis-ci.org/marcusjwhelan/binary-type-tree.svg?branch=master" alt="Build Status"></a> <h1 id="binary-type-tree">binary-type-tree</h1> A binary search tree with AVL balancing. I will be working to add different balancing techniques such as red black trees, scapegoat, and splay. Uses Commonjs module system. Every utility function, type, interface, and class are able to be imported from the module or as one object. <h2 id="previous-important-issues">Previous Important Issues</h2> <ul> <li>Can not enter falsy keys. Version 1.0.6 fixed a small but important issue where keys could not be falsy values. All previous version have this issue. </li> </ul> <h2 id="install">Install</h2> <pre><code class="lang-bash">npm install --save binary-type-tree </code></pre> <h2 id="usage">Usage</h2> The library for now uses only an AVL balanced binary tree. The basic structure is <pre><code>AVLTree - AVLNode - Node<T> </code></pre>The node is a generic abstract class which can be extended. AVLNode class extends this generic Node. Finally the AVLTree extends the AVLNode, which simply is a parent class that holds the entire tree of AVLNodes. AVLNode is simply an extension of the base Node class which I hope to build on for more self balancing trees. AVL is simply the first choice. <h2 id="table-of-contents">Table of Contents</h2> <ul> <li><a href="#creating-an-avl-tree">Creating an AVL Tree</a></li> <li><a href="#inserting-and-deleting-into-the-avl-tree">Inserting and deleting into the AVL Tree</a></li> <li><a href="#querying-the-avl-tree">Querying the AVL Tree</a></li> <li><a href="#key-update-on-avl-tree">Key update on AVL Tree</a></li> <li><a href="#avl-tree-extra-functionality">AVL tree extra functionality</a></li> <li><a href="#tojson">toJSON</a></li> </ul> <h2 id="creating-an-avl-tree">Creating an AVL Tree</h2> Before you create a tree you will want to consider how your keys and values will be structured. All values are stored as an array even when just one element. The key can be many different types but cannot be an <code>object</code>. There are three functions provided by default in <code>src/bTreeUtils.ts</code>, that compare equality and validity that can be replaced by custom functions. These are very important when it comes to <code>$gt, $lt, $ne</code> comparisons made for the <code>query</code> method. The implementation of the <code>query</code> is on the root Node<T> at <code>lib/basic-node/node.ts</code>. During the constructor you can choose to initialize your AVL tree with several starters or none. <ul> <li>key - If you would like a key on the initial Node. Inserting a new key/value pair will balance.</li> <li>value - If you would like a value on the initial Node.</li> <li>unique - Set your keys to be unique or not</li> <li>compareKeys - A function to compare keys, mostly used in the comparison during <code>$gt, $lt, $gte, $lte</code>. Takes two arguments <code>{ a: this.key, b: $queryValue }</code>, the query value is of $gt/$lt/$gte/$lte. The Default takes only a <code>number|string</code>. If you supply an fn you must adhere to these rules. <code>this.key</code> is supplied by the inner workings of this library as the the tree is traversed. <ul> <li>a <li>a > b - returns 1</li> <li>a === b - returns 0</li> <li>else throws new Error();</li> </ul> </li> <li>checkKeyEquality - Checks the equality of the key and the query from $ne. Default only uses <code>===</code> as a comparison and returns that boolean. The two arguments are <code>{a: this.key, b: $queryValue }</code>, the query value is the value of $ne. The default takes only <code>number|string|Date</code>. If you supply a fn you only need to return boolean of the comparison of the two with your own logic. </li> <li>checkValueEquality - Checks the equality of the value just like the key equality, however it is only used in one spot currently in the avl.ts file. It does loop over the array. </li> </ul> <pre><code class="lang-typescript">import { AVLTree } from "binary-type-tree"; // This will create a tree with unique false, key/value null and default fns let TestTree: AVLTree = new AVLTree({}); // I think this would be the best use of the tree. let TestUTree: AVLTree = new AVLTree({unique: true}); </code></pre> <h2 id="inserting-and-deleting-into-the-avl-tree">Inserting and deleting into the AVL Tree</h2> Inserting and deleting is very easy and re-balances after during both and returns the re-balanced tree. <pre><code class="lang-typescript">TestUTree.insert(123, ["abc"]); // this is a unique tree TestUTree.insert(123, ["abc"]); // Throws error TestUTree.insert(456, ["efg"]); // no error TestUTree.delete(456, ["efg"]); // true. // if there is not key that matches it will simply return the unchanged tree. </code></pre> <h2 id="querying-the-avl-tree">Querying the AVL Tree</h2> Query is very simple and easy to use and returns an array of the values found. There are also some other methods to query information from the tree. <pre><code class="lang-typescript">import * as BTT from "binary-type-tree"; // BTT.ASNDBS is a type which is almost any. Used for Keys // Array,string,number,Date,boolean,symbol,null // the full type declaration is // // Array<any[]|string|number|Date|boolean|symbol|null>|string|number|Date|boolean|symbol|null // // BTT.SNDBSA is a type which is almost any in array for Values // full type // // Array<{}|any[]|string|number|Date|boolean|symbol|null> // let numEight: BTT.SNDBSA = avlTree.tree.search(8); // let avlTree: BTT.AVLTree = new BTT.AVLTree({unique: true}); // Lets avlTree tree has keys 0-100 with values 100-0 // // I want all the keys greater than or equal 90 let nintyUp: BTT.SNDBSA = avlTree.tree.query({$gte: 90}); // nintyUp will have an array of values from [10..0] // // If I want to get values greater then 50 but less than 60 but not 55 let fullQuery: BTT.SNDBSA = avlTree.tree.query({$gte: 50, $lte: 60, $ne: 55}); // fullQuery = [50,51,52,53,54,56,57,58,59,60]; // // You could supply a new checkKeyEquality to check for arrays // so you could possibly have let exampleQ: BTT.SNDBSA = avlTree.tree.query({$ne: [...90]}); // // // // You could also find yourself needing more information let max: BTT.ASNDBS = avlTree.tree.getMaxKey(); let min: BTT.ASNDBS = avlTree.tree.getMinKey(); let totalKeys: number = avlTree.tree.getNumberOfKeys(); let maxAVLNode: BTT.AVLNode = avlTree.tree.getMaxKeyDescendant(); let minAVLNode: BTT.AVLNode = avlTree.tree.getMinKeyDescendant(); // // // If you would like to check the AVLTree for validity avlTree.tree.checkisAVLT(); // throw error if pointers fail, wrong ordering. and AVL height restrictions. or if not root node. </code></pre> <h2 id="key-update-on-avl-tree">Key update on AVL Tree</h2> If you would like to update a key you can with this new method. With unique trees the method will throw an error if the attempt to update a key to an existing key is made. Updates do not upsert, the method will simply return a non modified tree if the key to be update is not found. For non unique trees if the values are simply moved from one node to the node matching the <code>newKey</code> argument. If the <code>newKey</code> does not match anykeys on the tree then a new one is created and the old node is removed. For unique keys this also happens when there is no match for the <code>newKey</code>. <pre><code class="lang-typescript">const AVL = new AVLTree({}); const AVLU = new AVLTree({unique: true}); AVLU.insert(123, [45]); AVLU.insert(13, [56]); AVLU.updateKey(123, 133); // node 123 will be removed and 133 will be created AVLU.updateKey(13, 133); // no change, newKey exists. Error is thrown. AVL.insert(1, [1]); AVL.insert(1, [2]); // node with key 1 now has value [1,2]; AVL.insert(2, [3]); AVL.updateKey(1, 2); // node with key 2 now has value [1,2,3]; </code></pre> <h2 id="avl-tree-extra-functionality">AVL tree extra functionality</h2> If you would like to write a custom function to execute on every AVLNode then you can use the <code>executeOnEveryNode</code> method, it takes a type of <code>any</code> but and returns. Best used by supplying a reference to a function. <pre><code class="lang-typescript">const keys: BTT.ASNDBS = []; let executed: number = 0; avlTree.tree.executeOnEveryNode((node) => { keys.push(node.key); executed += 1; }); </code></pre> If you would like to create a AVLNode with similar options to another tree without a key or value there is a method to do so. <pre><code class="lang-typescript">const similarNode: BTT.AVLNode = avlTree.tree.createSimilar({}); </code></pre> There is also a method available to retrieve the node holding a key. <pre><code class="lang-typescript">// returns null if node is not found. const queryNode: BTT.AVLNode|null = avlTree.tree.getAVLNodeFromKey(123); </code></pre> <h2 id="tojson">toJSON</h2> toJSON has been added to convert a any tree into an array in JSON of objects holding the key and value of every node. The order of the nodes in the array are sorted in a way that a re-balance will not occur if you were to loop over the array and insert into any tree. <pre><code class="lang-typescript">// for now there is only one tree type so AVLTree is used for the type. const JSONTree = AVLTree.tree.toJSON<AVLTree>(); // retrieve tree as JSON </code></pre> <h4 id="how-it-works">How it works</h4> lets say given this btree <pre><code> __________ 40 ___________ / \ ____ 20 ____ ____ 60 ___ / \ / \ 10 30 50 _70 _ / \ / \ / \ / \ 5 15 25 35 45 55 65 75 / \ / \ / \ / \ / \ / \ / \ / \ 3 7 12 17 23 27 33 37 43 47 52 57 62 67 72 77 </code></pre>The master array would hold <pre><code class="lang-typescript">const input = [ [40], [20,60], [10,30,50,70], [5,15,25,35,45,55,65,75], [3,7,12,17,23,27,33,37,43,47,52,57,62,67,72,77]]; // // This would then be formatted into this const result = [ [40], [60,20], [70,30,50,10], [75,35,55,15,65,25,45,5], [77,37,67,17,57,27,47,7,72,33,62,23,52,12,43,3]]; // // This is done by breaking up each array as it comes in by their indices // // Previous: [0,1], Current: [0,1,2,3] // get evens/odds and sub Previous from Current, Current odds [3], Previous odds [1], Current evens [2], Prev Evens [0]; // creates const row3 = [3,1,2,0]; // 70,30,50,10 // Now for the next level // // Previous: [3,1,2,0], Current: [0,1,2,3,4,5,6,7] // same step // Current odds: [7,5], Previous odds: [3,1], Current evens: [6,4], Previous evens: [2,0] // creates const row4 = [7,3,5,1,6,2,4,0]; // 75,35,55,15,65,25,45,5 </code></pre> All of these arrays are then put together into one array to reference the master array of objects to then create a JSON array. Since this method only looks at the index of the arrays and not the contents of the keys or values no comparisons are needed. </div> </div> <div class="col-4 col-menu menu-sticky-wrap menu-highlight"> <nav class="tsd-navigation primary"> <ul> <li class="globals "> <a href="globals.html">Globals</a> </li> <li class=" tsd-kind-external-module"> <a href="modules/_avl_node_avl_.html">"avl-node/avl"</a> </li> <li class=" tsd-kind-external-module"> <a href="modules/_avl_tree_avltree_.html">"avl-tree/avlTree"</a> </li> <li class=" tsd-kind-external-module"> <a href="modules/_basic_node_node_.html">"basic-node/node"</a> </li> <li class=" tsd-kind-external-module"> <a href="modules/_utils_btreeutils_.html">"utils/bTreeUtils"</a> </li> <li class=" tsd-kind-external-module"> <a href="modules/_utils_equalarray_.html">"utils/equalArray"</a> </li> </ul> </nav> <nav class="tsd-navigation secondary menu-sticky"> <ul class="before-current"> </ul> </nav> </div> </div> </div> <footer class="with-border-bottom"> <div class="container"> <h2>Legend</h2> <div class="tsd-legend-group"> <ul class="tsd-legend"> <li class="tsd-kind-module">Module</li> <li class="tsd-kind-object-literal">Object literal</li> <li class="tsd-kind-variable">Variable</li> <li class="tsd-kind-function">Function</li> <li class="tsd-kind-function tsd-has-type-parameter">Function with type parameter</li> <li class="tsd-kind-index-signature">Index signature</li> <li class="tsd-kind-type-alias">Type alias</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-enum">Enumeration</li> <li class="tsd-kind-enum-member">Enumeration member</li> <li class="tsd-kind-property tsd-parent-kind-enum">Property</li> <li class="tsd-kind-method tsd-parent-kind-enum">Method</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-interface">Interface</li> <li class="tsd-kind-interface tsd-has-type-parameter">Interface with type parameter</li> <li class="tsd-kind-constructor tsd-parent-kind-interface">Constructor</li> <li class="tsd-kind-property tsd-parent-kind-interface">Property</li> <li class="tsd-kind-method tsd-parent-kind-interface">Method</li> <li class="tsd-kind-index-signature tsd-parent-kind-interface">Index signature</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-class">Class</li> <li class="tsd-kind-class tsd-has-type-parameter">Class with type parameter</li> <li class="tsd-kind-constructor tsd-parent-kind-class">Constructor</li> <li class="tsd-kind-property tsd-parent-kind-class">Property</li> <li class="tsd-kind-method tsd-parent-kind-class">Method</li> <li class="tsd-kind-accessor tsd-parent-kind-class">Accessor</li> <li class="tsd-kind-index-signature tsd-parent-kind-class">Index signature</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-constructor tsd-parent-kind-class tsd-is-inherited">Inherited constructor</li> <li class="tsd-kind-property tsd-parent-kind-class tsd-is-inherited">Inherited property</li> <li class="tsd-kind-method tsd-parent-kind-class tsd-is-inherited">Inherited method</li> <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-inherited">Inherited accessor</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-property tsd-parent-kind-class tsd-is-protected">Protected property</li> <li class="tsd-kind-method tsd-parent-kind-class tsd-is-protected">Protected method</li> <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-protected">Protected accessor</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-property tsd-parent-kind-class tsd-is-private">Private property</li> <li class="tsd-kind-method tsd-parent-kind-class tsd-is-private">Private method</li> <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-private">Private accessor</li> </ul> <ul class="tsd-legend"> <li class="tsd-kind-property tsd-parent-kind-class tsd-is-static">Static property</li> <li class="tsd-kind-call-signature tsd-parent-kind-class tsd-is-static">Static method</li> </ul> </div> </div> </footer> <div class="container tsd-generator"> Generated using <a href="http://typedoc.org/" target="_blank">TypeDoc</a> </div> <div class="overlay"></div> <script src="assets/js/main.js"></script> <script>if (location.protocol == 'file:') document.write('<script src="assets/js/search.js"><' + '/script>');</script> </body> </html>