linear interpolation between sparse annotation element values.
[jalview.git] / src / jalview / datamodel / BinaryNode.java
index cbec833..bb9a426 100755 (executable)
-/*\r
- * Jalview - A Sequence Alignment Editor and Viewer\r
- * Copyright (C) 2005 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle\r
- *\r
- * This program is free software; you can redistribute it and/or\r
- * modify it under the terms of the GNU General Public License\r
- * as published by the Free Software Foundation; either version 2\r
- * of the License, or (at your option) any later version.\r
- *\r
- * This program is distributed in the hope that it will be useful,\r
- * but WITHOUT ANY WARRANTY; without even the implied warranty of\r
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
- * GNU General Public License for more details.\r
- *\r
- * You should have received a copy of the GNU General Public License\r
- * along with this program; if not, write to the Free Software\r
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA\r
- */\r
-package jalview.datamodel;\r
-\r
-/**\r
- * DOCUMENT ME!\r
- *\r
- * @author $author$\r
- * @version $Revision$\r
- */\r
-public class BinaryNode\r
-{\r
-    Object element;\r
-    String name;\r
-    BinaryNode left;\r
-    BinaryNode right;\r
-    BinaryNode parent;\r
-\r
-    /** DOCUMENT ME!! */\r
-    public int bootstrap;\r
-\r
-    /**\r
-     * Creates a new BinaryNode object.\r
-     */\r
-    public BinaryNode()\r
-    {\r
-        left = right = parent = null;\r
-        bootstrap = 0;\r
-    }\r
-\r
-    /**\r
-     * Creates a new BinaryNode object.\r
-     *\r
-     * @param element DOCUMENT ME!\r
-     * @param parent DOCUMENT ME!\r
-     * @param name DOCUMENT ME!\r
-     */\r
-    public BinaryNode(Object element, BinaryNode parent, String name)\r
-    {\r
-        this.element = element;\r
-        this.parent = parent;\r
-        this.name = name;\r
-\r
-        left = right = null;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public Object element()\r
-    {\r
-        return element;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @param v DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public Object setElement(Object v)\r
-    {\r
-        return element = v;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public BinaryNode left()\r
-    {\r
-        return left;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @param n DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public BinaryNode setLeft(BinaryNode n)\r
-    {\r
-        return left = n;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public BinaryNode right()\r
-    {\r
-        return right;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @param n DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public BinaryNode setRight(BinaryNode n)\r
-    {\r
-        return right = n;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public BinaryNode parent()\r
-    {\r
-        return parent;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @param n DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public BinaryNode setParent(BinaryNode n)\r
-    {\r
-        return parent = n;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public boolean isLeaf()\r
-    {\r
-        return (left == null) && (right == null);\r
-    }\r
-\r
-    /**\r
-     * attaches FIRST and SECOND node arguments as the LEFT and RIGHT children of this node (removing any old references)\r
-     * a null parameter DOES NOT mean that the pointer to the corresponding child node is set to  NULL - you  should use\r
-     * setChild(null), or detach() for this.\r
-     *\r
-     */\r
-    public void SetChildren(BinaryNode leftchild, BinaryNode rightchild)\r
-    {\r
-        if (leftchild != null)\r
-        {\r
-            this.setLeft(leftchild);\r
-            leftchild.detach();\r
-            leftchild.setParent(this);\r
-        }\r
-\r
-        if (rightchild != null)\r
-        {\r
-            this.setRight(rightchild);\r
-            rightchild.detach();\r
-            rightchild.setParent(this);\r
-        }\r
-    }\r
-\r
-    /**\r
-     * Detaches the node from the binary tree, along with all its child nodes.\r
-     * @return BinaryNode The detached node.\r
-     */\r
-    public BinaryNode detach()\r
-    {\r
-        if (this.parent != null)\r
-        {\r
-            if (this.parent.left == this)\r
-            {\r
-                this.parent.left = null;\r
-            }\r
-            else\r
-            {\r
-                if (this.parent.right == this)\r
-                {\r
-                    this.parent.right = null;\r
-                }\r
-            }\r
-        }\r
-\r
-        this.parent = null;\r
-\r
-        return this;\r
-    }\r
-\r
-    /**\r
-     * Traverses up through the tree until a node with a free leftchild is discovered.\r
-     * @return BinaryNode\r
-     */\r
-    public BinaryNode ascendLeft()\r
-    {\r
-        BinaryNode c = this;\r
-\r
-        do\r
-        {\r
-            c = c.parent();\r
-        }\r
-        while ((c != null) && (c.left() != null) && !c.left().isLeaf());\r
-\r
-        return c;\r
-    }\r
-\r
-    /**\r
-     * Traverses up through the tree until a node with a free rightchild is discovered.\r
-     * Jalview builds trees by descent on the left, so this may be unused.\r
-     * @return BinaryNode\r
-     */\r
-    public BinaryNode ascendRight()\r
-    {\r
-        BinaryNode c = this;\r
-\r
-        do\r
-        {\r
-            c = c.parent();\r
-        }\r
-        while ((c != null) && (c.right() != null) && !c.right().isLeaf());\r
-\r
-        return c;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @param name DOCUMENT ME!\r
-     */\r
-    public void setName(String name)\r
-    {\r
-        this.name = name;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public String getName()\r
-    {\r
-        return this.name;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @param boot DOCUMENT ME!\r
-     */\r
-    public void setBootstrap(int boot)\r
-    {\r
-        this.bootstrap = boot;\r
-    }\r
-\r
-    /**\r
-     * DOCUMENT ME!\r
-     *\r
-     * @return DOCUMENT ME!\r
-     */\r
-    public int getBootstrap()\r
-    {\r
-        return bootstrap;\r
-    }\r
-}\r
+/*
+ * Jalview - A Sequence Alignment Editor and Viewer
+ * Copyright (C) 2006 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
+ */
+package jalview.datamodel;
+
+/**
+ * DOCUMENT ME!
+ *
+ * @author $author$
+ * @version $Revision$
+ */
+public class BinaryNode
+{
+    Object element;
+    String name;
+    BinaryNode left;
+    BinaryNode right;
+    BinaryNode parent;
+
+    /** DOCUMENT ME!! */
+    public int bootstrap;
+
+    /**
+     * Creates a new BinaryNode object.
+     */
+    public BinaryNode()
+    {
+        left = right = parent = null;
+        bootstrap = 0;
+    }
+
+    /**
+     * Creates a new BinaryNode object.
+     *
+     * @param element DOCUMENT ME!
+     * @param parent DOCUMENT ME!
+     * @param name DOCUMENT ME!
+     */
+    public BinaryNode(Object element, BinaryNode parent, String name)
+    {
+        this.element = element;
+        this.parent = parent;
+        this.name = name;
+
+        left = right = null;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public Object element()
+    {
+        return element;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @param v DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public Object setElement(Object v)
+    {
+        return element = v;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public BinaryNode left()
+    {
+        return left;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @param n DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public BinaryNode setLeft(BinaryNode n)
+    {
+        return left = n;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public BinaryNode right()
+    {
+        return right;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @param n DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public BinaryNode setRight(BinaryNode n)
+    {
+        return right = n;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public BinaryNode parent()
+    {
+        return parent;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @param n DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public BinaryNode setParent(BinaryNode n)
+    {
+        return parent = n;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public boolean isLeaf()
+    {
+        return (left == null) && (right == null);
+    }
+
+    /**
+     * attaches FIRST and SECOND node arguments as the LEFT and RIGHT children of this node (removing any old references)
+     * a null parameter DOES NOT mean that the pointer to the corresponding child node is set to  NULL - you  should use
+     * setChild(null), or detach() for this.
+     *
+     */
+    public void SetChildren(BinaryNode leftchild, BinaryNode rightchild)
+    {
+        if (leftchild != null)
+        {
+            this.setLeft(leftchild);
+            leftchild.detach();
+            leftchild.setParent(this);
+        }
+
+        if (rightchild != null)
+        {
+            this.setRight(rightchild);
+            rightchild.detach();
+            rightchild.setParent(this);
+        }
+    }
+
+    /**
+     * Detaches the node from the binary tree, along with all its child nodes.
+     * @return BinaryNode The detached node.
+     */
+    public BinaryNode detach()
+    {
+        if (this.parent != null)
+        {
+            if (this.parent.left == this)
+            {
+                this.parent.left = null;
+            }
+            else
+            {
+                if (this.parent.right == this)
+                {
+                    this.parent.right = null;
+                }
+            }
+        }
+
+        this.parent = null;
+
+        return this;
+    }
+
+    /**
+     * Traverses up through the tree until a node with a free leftchild is discovered.
+     * @return BinaryNode
+     */
+    public BinaryNode ascendLeft()
+    {
+        BinaryNode c = this;
+
+        do
+        {
+            c = c.parent();
+        }
+        while ((c != null) && (c.left() != null) && !c.left().isLeaf());
+
+        return c;
+    }
+
+    /**
+     * Traverses up through the tree until a node with a free rightchild is discovered.
+     * Jalview builds trees by descent on the left, so this may be unused.
+     * @return BinaryNode
+     */
+    public BinaryNode ascendRight()
+    {
+        BinaryNode c = this;
+
+        do
+        {
+            c = c.parent();
+        }
+        while ((c != null) && (c.right() != null) && !c.right().isLeaf());
+
+        return c;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @param name DOCUMENT ME!
+     */
+    public void setName(String name)
+    {
+        this.name = name;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public String getName()
+    {
+        return this.name;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @param boot DOCUMENT ME!
+     */
+    public void setBootstrap(int boot)
+    {
+        this.bootstrap = boot;
+    }
+
+    /**
+     * DOCUMENT ME!
+     *
+     * @return DOCUMENT ME!
+     */
+    public int getBootstrap()
+    {
+        return bootstrap;
+    }
+}