dataframes_tutorial.ipynb

{
    "cells": [
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "# *Tutorial: Tree Dataframes*\n",
                "\n",
                "**Author:** [Eivind Tøstesen](https://github.com/eivindtostesen)\n",
                "\n",
                "**Tutorial goal:** *How to organize results from peak analysis in dataframes using an interface to pandas or polars.*\n",
                "\n",
                "## Introduction\n",
                "\n",
                "*The results of a hierarchical analysis of peaks in 1D data are organized in a `Tree` object.\n",
                "It can always be printed (str and repr),\n",
                "but a better way of viewing, exploring and transforming the results is to export them to dataframes.*\n",
                "\n",
                "*This notebook demonstrates the dataframe functionality provided by `interface_pandas` and `interface_polars`, which equip  `Tree` objects with new methods built on pandas/polars, and gives some example recipes.*"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "## Imports\n",
                "The optional modules `interface_pandas` and `interface_polars` have almost identical methods and APIs, and each one is sufficient for doing dataframes, but we will demonstrate both."
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 1,
            "metadata": {},
            "outputs": [],
            "source": [
                "from matplotlib.pyplot import plot\n",
                "from pandas import concat\n",
                "\n",
                "import peakoscope\n",
                "\n",
                "# In this notebook, we import both, but you can choose to import only one:\n",
                "import peakoscope.interface_pandas  # requires pandas\n",
                "import peakoscope.interface_polars  # requires polars\n",
                "\n",
                "# We also document our random seed value: \n",
                "RANDOM_SEED = \"it's.....\""
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "## Example data set\n",
                "Throughout the notebook, we will use the same mini example for our data set. It consists of two lists: `X` (labels) and `Y` (values). The data types are str and float, respectively.\n",
                "\n"
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 2,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "image/png": "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JorTp0+L//znP0Kj0Yi9e/faHXv16tUiNjZWlJWVCYvFImbNmtXv5+fgwYMiPj5e3H///QO+Dr42aHtGWltbsXTpUuzevRubN2+GUqnEz3/+c7vIdM2aNVCr1di1axeeeeYZ/PWvf8U//vEPu+Pcd999eOyxx/B///d/OHjwIF5//XWkp6fLj999993YsmUL3n33XWzcuBFbt27FN998Y3eMP/7xj1i1ahVeeOEFHDhwAHfddRduuOEGbNu2Td7m6aefxsMPP4zhw4ejoqICu3fv7vOcli5dii+//BLvv/8+Nm3ahO3bt+Pbb7+122bNmjWIiYnBrl278Pjjj+Phhx/Gpk2bvHotB/LGG2/g2muvxdq1a7FgwQKX9lmzZg1SUlLw9ddfY8mSJbjttttwzTXXoLCwEN9++y2Kiopw4403wmKxuPSc7rnnHrz99ttYs2YNvv32W+Tn56OoqMjuCmyg99uV97L3sb788ku7KxMAqKiowPXXX49bbrkFhw4dwtatW3HllVfaLbH99NNPY9q0afj1r38tX7G4s2r1Nddcg9raWmzZskW+r6GhARs2bMD8+fNx0UUXobm5GXv37gUAbNu2DSkpKXafua1bt6KoqAivvvoqli9fjj179qClpQU33HADbr/9dsydO1c+l9lsxvvvvy/vW1tbiw8++AA333wzAOvVtO3V1969e5GcnIyLLrrIrt1vvvkmxowZgzFjxuCGG27AqlWr+l16vKWlBevWrUN+fj6Sk5NRX1+PTz75BIsXL0ZMTEyf7fvrxbv44otx1lln4Z133unnlXVdXV0dNm7c6LQtwXLvvffikUcewQcffICrrrrKo2PcfPPNWLVqlfzvV199Fbfccov8b5VKhZUrV+LZZ5/FqVOn7Patr6/Hhg0bcPvttyMqKsrusYyMDMyfPx9vvvmm0/c9KioKRqMRALB48WJotVps3LgRM2bMQHZ2Ni677DJ8+umnOH36NO6///4++5eVleGTTz6BRqOR74uNjUVsbCz+85//oLOz0/0XxAVqtRoLFizA6tWr7Z7bv//9b3R1dWHOnDl2f69btmzBzJkzMWPGDPn+rq4u7NixA7NmzcKSJUtw1llnYcGCBfjNb36DBx54AGeffbbdORcuXIhLLrkEN998M5577jns378ff//73x22r7GxET/72c8wY8YMl4bofS7g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bXbn6m8CqxCOU3vPP/98ce+998rPqfcEq5/+9Kdi4cKFfY7l69TegwcPirS0NLF06dIBt3V0bkcTNgGI8ePHu/Sc2tvbxZIlS0RKSorT1N6B3m9X3ktn7bd18OBBUVRUJKcZjx49Wjz77LN9tjty5Ii44IILRFRUVJ/U3qamJnHttdeK+Ph4kZWVJVavXt1nAqsQ1sm/mZmZdpPebP3v//6vACD2798v33fWWWeJ1NRUYbFYxJYtW4RarRbbt2+XHz9+/LhISEgQzz//fJ/j3XjjjQ7TfFetWtVvau8VV1whfvzjHzt8vaQJv998802flOe4uDhx3nnn9UlRPXPmjFi8eLHIyckRWq1WDBs2TPzkJz8RW7ZssTuGWq0WqampYvbs2eLVV1+1m1DrKL0agBgzZozdNgNNKD1z5oz43e9+J0aOHCk0Go2IjY0V559/vvh//+//ifnz5/s8tffGG28UV111VZ/7He175swZMWbMGHHeeefJ53L2vBcuXDjg+XtPYJWUl5cLnU4nbH9yysvLxU033SQyMjKERqMRWVlZYsmSJaK2ttbl53v06FGRkpIifvSjH4lt27aJEydOiI8//lhMmDBBnH322aK5udnpMdatWye0Wq04ceKE6OjoEPfee68455xzREJCgoiOjhZjxowRf/zjH/ukHzubwCqEEHv27BFFRUUiLS1NxMfHiylTpoj169f32e6rr74SAMTcuXPt7pdS4MeOHWt3/8mTJwUAkZeXJ7Zu3SpUKpXd36Rk7ty54uKLL+7zO/Xggw+Ks846y+6+1atXO3yfpVt/vzX+oBDCzcFwChutra0YNmwYnnzySbseAF+6/vrroVKp8Nprr/nl+IEyc+ZMnH322W733Hi6X6SaM2cOCgoK+kzipMC59NJLkZ+fj+eeey7YTQmI8vJyLF++HJ988gmqq6shhMCVV16Jf/7zn4iOjg5288hFg3LOSKTau3cv1q9fj9LSUnz77beYP38+ALjczegOk8mEgwcPYseOHRg/frzPj0/hpb6+Hm+88QY+++yzPtkmFBgNDQ348MMPsXXrVqdlxyPRiBEjsHr1alRWVsJiseCBBx7Axo0b8f333we7aeSGQTlnJJI98cQTOHLkCLRaLc4991xs377d5fFtd+zfvx+FhYWYNWuWw3UqaHA555xz0NDQgMcee8xpujP51y233ILdu3fjf//3f/1yARIuHnroIXm+1dSpUz2a10WBx2EaIiIiCiqGjERERBRUDEaIiIgoqBiMEBERUVAxGCEiIqKgYjBCREREQcVghIiIiIKKwQgREREFFYMRIiIiCioGI0RERBRU/x883T92hJvSfgAAAABJRU5ErkJggg==",
                        "text/plain": [
                            "<Figure size 640x480 with 1 Axes>"
                        ]
                    },
                    "metadata": {},
                    "output_type": "display_data"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "\n",
                "# Plot the data set:\n",
                "plot(X, Y);"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "## Peak analysis\n",
                "The peak regions in the data `X,Y` are analysed by calling `peakoscope.tree(Y)`. This function returns a `Tree` object, in which the tree nodes are objects of the `Scope` class. A `Scope` represents a peak and is written in the start:stop notation (a slice), which specifies the peak region."
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 3,
            "metadata": {},
            "outputs": [
                {
                    "name": "stdout",
                    "output_type": "stream",
                    "text": [
                        "0:52\n",
                        "└─1:52\n",
                        "  ├─20:52\n",
                        "  │ ├─23:52\n",
                        "  │ │ ├─38:52\n",
                        "  │ │ │ ├─42:52\n",
                        "  │ │ │ │ ├─46:52\n",
                        "  │ │ │ │ │ └─47:52\n",
                        "  │ │ │ │ │   └─47:51\n",
                        "  │ │ │ │ │     ├─48:49\n",
                        "  │ │ │ │ │     └─50:51\n",
                        "  │ │ │ │ └─43:44\n",
                        "  │ │ │ └─38:41\n",
                        "  │ │ │   └─39:41\n",
                        "  │ │ │     └─40:41\n",
                        "  │ │ └─23:37\n",
                        "  │ │   └─24:35\n",
                        "  │ │     ├─30:35\n",
                        "  │ │     │ └─31:35\n",
                        "  │ │     │   └─31:34\n",
                        "  │ │     │     └─31:33\n",
                        "  │ │     └─25:27\n",
                        "  │ └─20:21\n",
                        "  └─2:18\n",
                        "    ├─3:8\n",
                        "    │ └─4:8\n",
                        "    │   └─4:7\n",
                        "    ├─10:15\n",
                        "    │ ├─13:14\n",
                        "    │ └─11:12\n",
                        "    └─16:17\n"
                    ]
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "\n",
                "# print the tree of peaks:\n",
                "print(peaks)"
            ]
        },
        {
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "Dataframe functionality is then initialized by calling the `TreePolars` class. This will give the `peaks` an attribute called \"polars\".\n"
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 4,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/plain": [
                            "<peakoscope.interface_polars.TreePolars at 0x117ea2150>"
                        ]
                    },
                    "execution_count": 4,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "\n",
                "# Add polars functionality to the peaks:\n",
                "peakoscope.interface_polars.TreePolars(peaks, X=X)\n",
                "\n",
                "# The new attribute:\n",
                "peaks.polars"
            ]
        },
        {
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "The `peaks` can be exported to a series or a one-column dataframe by calling the methods `peaks.polars.series` or `peaks.polars.dataframe` with no arguments:"
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 5,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div><style>\n",
                            ".dataframe > thead > tr > th,\n",
                            ".dataframe > tbody > tr > td {\n",
                            "  text-align: right;\n",
                            "  white-space: pre-wrap;\n",
                            "}\n",
                            "</style>\n",
                            "<small>shape: (31,)</small><table border=\"1\" class=\"dataframe\"><thead><tr><th>node</th></tr><tr><td>object</td></tr></thead><tbody><tr><td>0:52</td></tr><tr><td>1:52</td></tr><tr><td>20:52</td></tr><tr><td>23:52</td></tr><tr><td>38:52</td></tr><tr><td>42:52</td></tr><tr><td>46:52</td></tr><tr><td>47:52</td></tr><tr><td>47:51</td></tr><tr><td>48:49</td></tr><tr><td>2:18</td></tr><tr><td>3:8</td></tr><tr><td>&hellip;</td></tr><tr><td>31:34</td></tr><tr><td>31:33</td></tr><tr><td>38:41</td></tr><tr><td>39:41</td></tr><tr><td>40:41</td></tr><tr><td>43:44</td></tr><tr><td>50:51</td></tr><tr><td>25:27</td></tr><tr><td>10:15</td></tr><tr><td>13:14</td></tr><tr><td>16:17</td></tr><tr><td>11:12</td></tr></tbody></table></div>"
                        ],
                        "text/plain": [
                            "shape: (31,)\n",
                            "Series: 'node' [o][object]\n",
                            "[\n",
                            "\t0:52\n",
                            "\t1:52\n",
                            "\t20:52\n",
                            "\t23:52\n",
                            "\t38:52\n",
                            "\t42:52\n",
                            "\t46:52\n",
                            "\t47:52\n",
                            "\t47:51\n",
                            "\t48:49\n",
                            "\t2:18\n",
                            "\t3:8\n",
                            "\t4:8\n",
                            "\t4:7\n",
                            "\t20:21\n",
                            "\t23:37\n",
                            "\t24:35\n",
                            "\t30:35\n",
                            "\t31:35\n",
                            "\t31:34\n",
                            "\t31:33\n",
                            "\t38:41\n",
                            "\t39:41\n",
                            "\t40:41\n",
                            "\t43:44\n",
                            "]"
                        ]
                    },
                    "execution_count": 5,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add polars functionality to the peaks:\n",
                "peakoscope.interface_polars.TreePolars(peaks, X=X)\n",
                "\n",
                "# A polars series containing all peak regions:\n",
                "peaks.polars.series()"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "The method `peaks.polars.location_properties` returns a dataframe with columns for the start and end positions on the x-axis of each peak region. It also has a column called location that combines start and end. These start and ends are both included in the peak region, because they are label-based, while the node is displayed as a slice, which is integer-based and do not include the stop value."
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 6,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div><style>\n",
                            ".dataframe > thead > tr > th,\n",
                            ".dataframe > tbody > tr > td {\n",
                            "  text-align: right;\n",
                            "  white-space: pre-wrap;\n",
                            "}\n",
                            "</style>\n",
                            "<small>shape: (31, 4)</small><table border=\"1\" class=\"dataframe\"><thead><tr><th>node</th><th>location</th><th>x_start</th><th>x_end</th></tr><tr><td>object</td><td>str</td><td>str</td><td>str</td></tr></thead><tbody><tr><td>0:52</td><td>&quot;a..Z&quot;</td><td>&quot;a&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>1:52</td><td>&quot;b..Z&quot;</td><td>&quot;b&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>20:52</td><td>&quot;u..Z&quot;</td><td>&quot;u&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>23:52</td><td>&quot;x..Z&quot;</td><td>&quot;x&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>38:52</td><td>&quot;M..Z&quot;</td><td>&quot;M&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>42:52</td><td>&quot;Q..Z&quot;</td><td>&quot;Q&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>46:52</td><td>&quot;U..Z&quot;</td><td>&quot;U&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>47:52</td><td>&quot;V..Z&quot;</td><td>&quot;V&quot;</td><td>&quot;Z&quot;</td></tr><tr><td>47:51</td><td>&quot;V..Y&quot;</td><td>&quot;V&quot;</td><td>&quot;Y&quot;</td></tr><tr><td>48:49</td><td>&quot;W..W&quot;</td><td>&quot;W&quot;</td><td>&quot;W&quot;</td></tr><tr><td>2:18</td><td>&quot;c..r&quot;</td><td>&quot;c&quot;</td><td>&quot;r&quot;</td></tr><tr><td>3:8</td><td>&quot;d..h&quot;</td><td>&quot;d&quot;</td><td>&quot;h&quot;</td></tr><tr><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td></tr><tr><td>31:34</td><td>&quot;F..H&quot;</td><td>&quot;F&quot;</td><td>&quot;H&quot;</td></tr><tr><td>31:33</td><td>&quot;F..G&quot;</td><td>&quot;F&quot;</td><td>&quot;G&quot;</td></tr><tr><td>38:41</td><td>&quot;M..O&quot;</td><td>&quot;M&quot;</td><td>&quot;O&quot;</td></tr><tr><td>39:41</td><td>&quot;N..O&quot;</td><td>&quot;N&quot;</td><td>&quot;O&quot;</td></tr><tr><td>40:41</td><td>&quot;O..O&quot;</td><td>&quot;O&quot;</td><td>&quot;O&quot;</td></tr><tr><td>43:44</td><td>&quot;R..R&quot;</td><td>&quot;R&quot;</td><td>&quot;R&quot;</td></tr><tr><td>50:51</td><td>&quot;Y..Y&quot;</td><td>&quot;Y&quot;</td><td>&quot;Y&quot;</td></tr><tr><td>25:27</td><td>&quot;z..A&quot;</td><td>&quot;z&quot;</td><td>&quot;A&quot;</td></tr><tr><td>10:15</td><td>&quot;k..o&quot;</td><td>&quot;k&quot;</td><td>&quot;o&quot;</td></tr><tr><td>13:14</td><td>&quot;n..n&quot;</td><td>&quot;n&quot;</td><td>&quot;n&quot;</td></tr><tr><td>16:17</td><td>&quot;q..q&quot;</td><td>&quot;q&quot;</td><td>&quot;q&quot;</td></tr><tr><td>11:12</td><td>&quot;l..l&quot;</td><td>&quot;l&quot;</td><td>&quot;l&quot;</td></tr></tbody></table></div>"
                        ],
                        "text/plain": [
                            "shape: (31, 4)\n",
                            "┌────────┬──────────┬─────────┬───────┐\n",
                            "│ node   ┆ location ┆ x_start ┆ x_end │\n",
                            "│ ---    ┆ ---      ┆ ---     ┆ ---   │\n",
                            "│ object ┆ str      ┆ str     ┆ str   │\n",
                            "╞════════╪══════════╪═════════╪═══════╡\n",
                            "│ 0:52   ┆ a..Z     ┆ a       ┆ Z     │\n",
                            "│ 1:52   ┆ b..Z     ┆ b       ┆ Z     │\n",
                            "│ 20:52  ┆ u..Z     ┆ u       ┆ Z     │\n",
                            "│ 23:52  ┆ x..Z     ┆ x       ┆ Z     │\n",
                            "│ …      ┆ …        ┆ …       ┆ …     │\n",
                            "│ 10:15  ┆ k..o     ┆ k       ┆ o     │\n",
                            "│ 13:14  ┆ n..n     ┆ n       ┆ n     │\n",
                            "│ 16:17  ┆ q..q     ┆ q       ┆ q     │\n",
                            "│ 11:12  ┆ l..l     ┆ l       ┆ l     │\n",
                            "└────────┴──────────┴─────────┴───────┘"
                        ]
                    },
                    "execution_count": 6,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add polars functionality to the peaks:\n",
                "peakoscope.interface_polars.TreePolars(peaks, X=X)\n",
                "\n",
                "# Dataframe with peak spans on the x-axis:\n",
                "peaks.polars.location_properties()"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "The method `peaks.polars.tree_structure` returns a dataframe containing each tree node and its parent node, its children nodes, etcetera, showing the network structure of the tree. \n",
                "\n",
                "Each node is looked up in the \"node\" column, which is the key column, and other columns then show the corresponding:\n",
                "- parent\n",
                "- children\n",
                "- core (the leaf node containing the maximum of the peak)\n",
                "- full (the largest node having the same core)\n",
                "\n",
                "For better readability, the dataframe rows are ordered according to paths from core nodes to full nodes. The node that has None as parent is the root and it spans the whole data set."
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 7,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div><style>\n",
                            ".dataframe > thead > tr > th,\n",
                            ".dataframe > tbody > tr > td {\n",
                            "  text-align: right;\n",
                            "  white-space: pre-wrap;\n",
                            "}\n",
                            "</style>\n",
                            "<small>shape: (31, 6)</small><table border=\"1\" class=\"dataframe\"><thead><tr><th>core</th><th>children</th><th>node</th><th>parent</th><th>full</th><th>root</th></tr><tr><td>object</td><td>object</td><td>object</td><td>object</td><td>object</td><td>object</td></tr></thead><tbody><tr><td>48:49</td><td>[]</td><td>48:49</td><td>47:51</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;48:49&quot;, Y), Scope(&quot;50:51&quot;, Y)]</td><td>47:51</td><td>47:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;47:51&quot;, Y)]</td><td>47:52</td><td>46:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;47:52&quot;, Y)]</td><td>46:52</td><td>42:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;46:52&quot;, Y), Scope(&quot;43:44&quot;, Y)]</td><td>42:52</td><td>38:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;42:52&quot;, Y), Scope(&quot;38:41&quot;, Y)]</td><td>38:52</td><td>23:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;38:52&quot;, Y), Scope(&quot;23:37&quot;, Y)]</td><td>23:52</td><td>20:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;23:52&quot;, Y), Scope(&quot;20:21&quot;, Y)]</td><td>20:52</td><td>1:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;20:52&quot;, Y), Scope(&quot;2:18&quot;, Y)]</td><td>1:52</td><td>0:52</td><td>0:52</td><td>0:52</td></tr><tr><td>48:49</td><td>[Scope(&quot;1:52&quot;, Y)]</td><td>0:52</td><td>None</td><td>0:52</td><td>0:52</td></tr><tr><td>50:51</td><td>[]</td><td>50:51</td><td>47:51</td><td>50:51</td><td>0:52</td></tr><tr><td>43:44</td><td>[]</td><td>43:44</td><td>42:52</td><td>43:44</td><td>0:52</td></tr><tr><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td></tr><tr><td>31:33</td><td>[Scope(&quot;30:35&quot;, Y), Scope(&quot;25:27&quot;, Y)]</td><td>24:35</td><td>23:37</td><td>23:37</td><td>0:52</td></tr><tr><td>31:33</td><td>[Scope(&quot;24:35&quot;, Y)]</td><td>23:37</td><td>23:52</td><td>23:37</td><td>0:52</td></tr><tr><td>25:27</td><td>[]</td><td>25:27</td><td>24:35</td><td>25:27</td><td>0:52</td></tr><tr><td>20:21</td><td>[]</td><td>20:21</td><td>20:52</td><td>20:21</td><td>0:52</td></tr><tr><td>4:7</td><td>[]</td><td>4:7</td><td>4:8</td><td>2:18</td><td>0:52</td></tr><tr><td>4:7</td><td>[Scope(&quot;4:7&quot;, Y)]</td><td>4:8</td><td>3:8</td><td>2:18</td><td>0:52</td></tr><tr><td>4:7</td><td>[Scope(&quot;4:8&quot;, Y)]</td><td>3:8</td><td>2:18</td><td>2:18</td><td>0:52</td></tr><tr><td>4:7</td><td>[Scope(&quot;3:8&quot;, Y), Scope(&quot;10:15&quot;, Y), Scope(&quot;16:17&quot;, Y)]</td><td>2:18</td><td>1:52</td><td>2:18</td><td>0:52</td></tr><tr><td>13:14</td><td>[]</td><td>13:14</td><td>10:15</td><td>10:15</td><td>0:52</td></tr><tr><td>13:14</td><td>[Scope(&quot;13:14&quot;, Y), Scope(&quot;11:12&quot;, Y)]</td><td>10:15</td><td>2:18</td><td>10:15</td><td>0:52</td></tr><tr><td>11:12</td><td>[]</td><td>11:12</td><td>10:15</td><td>11:12</td><td>0:52</td></tr><tr><td>16:17</td><td>[]</td><td>16:17</td><td>2:18</td><td>16:17</td><td>0:52</td></tr></tbody></table></div>"
                        ],
                        "text/plain": [
                            "shape: (31, 6)\n",
                            "┌────────┬───────────────────────────────────┬────────┬────────┬────────┬────────┐\n",
                            "│ core   ┆ children                          ┆ node   ┆ parent ┆ full   ┆ root   │\n",
                            "│ ---    ┆ ---                               ┆ ---    ┆ ---    ┆ ---    ┆ ---    │\n",
                            "│ object ┆ object                            ┆ object ┆ object ┆ object ┆ object │\n",
                            "╞════════╪═══════════════════════════════════╪════════╪════════╪════════╪════════╡\n",
                            "│ 48:49  ┆ []                                ┆ 48:49  ┆ 47:51  ┆ 0:52   ┆ 0:52   │\n",
                            "│ 48:49  ┆ [Scope(\"48:49\", Y), Scope(\"50:51… ┆ 47:51  ┆ 47:52  ┆ 0:52   ┆ 0:52   │\n",
                            "│ 48:49  ┆ [Scope(\"47:51\", Y)]               ┆ 47:52  ┆ 46:52  ┆ 0:52   ┆ 0:52   │\n",
                            "│ 48:49  ┆ [Scope(\"47:52\", Y)]               ┆ 46:52  ┆ 42:52  ┆ 0:52   ┆ 0:52   │\n",
                            "│ …      ┆ …                                 ┆ …      ┆ …      ┆ …      ┆ …      │\n",
                            "│ 13:14  ┆ []                                ┆ 13:14  ┆ 10:15  ┆ 10:15  ┆ 0:52   │\n",
                            "│ 13:14  ┆ [Scope(\"13:14\", Y), Scope(\"11:12… ┆ 10:15  ┆ 2:18   ┆ 10:15  ┆ 0:52   │\n",
                            "│ 11:12  ┆ []                                ┆ 11:12  ┆ 10:15  ┆ 11:12  ┆ 0:52   │\n",
                            "│ 16:17  ┆ []                                ┆ 16:17  ┆ 2:18   ┆ 16:17  ┆ 0:52   │\n",
                            "└────────┴───────────────────────────────────┴────────┴────────┴────────┴────────┘"
                        ]
                    },
                    "execution_count": 7,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add polars functionality to the peaks:\n",
                "peakoscope.interface_polars.TreePolars(peaks, X=X)\n",
                "\n",
                "# Dataframe with the network of peak nodes:\n",
                "peaks.polars.tree_structure()"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "The `peaks.polars.numeric_properties` method returns a dataframe containing each node's size, max and min values. Rows are ordered by descending max and size."
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 8,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div><style>\n",
                            ".dataframe > thead > tr > th,\n",
                            ".dataframe > tbody > tr > td {\n",
                            "  text-align: right;\n",
                            "  white-space: pre-wrap;\n",
                            "}\n",
                            "</style>\n",
                            "<small>shape: (31, 4)</small><table border=\"1\" class=\"dataframe\"><thead><tr><th>node</th><th>max</th><th>size</th><th>min</th></tr><tr><td>object</td><td>f64</td><td>f64</td><td>f64</td></tr></thead><tbody><tr><td>0:52</td><td>6.2</td><td>1.2</td><td>5.0</td></tr><tr><td>1:52</td><td>6.2</td><td>1.0</td><td>5.2</td></tr><tr><td>20:52</td><td>6.2</td><td>0.9</td><td>5.3</td></tr><tr><td>23:52</td><td>6.2</td><td>0.8</td><td>5.4</td></tr><tr><td>38:52</td><td>6.2</td><td>0.7</td><td>5.5</td></tr><tr><td>42:52</td><td>6.2</td><td>0.6</td><td>5.6</td></tr><tr><td>46:52</td><td>6.2</td><td>0.4</td><td>5.8</td></tr><tr><td>47:52</td><td>6.2</td><td>0.3</td><td>5.9</td></tr><tr><td>47:51</td><td>6.2</td><td>0.2</td><td>6.0</td></tr><tr><td>48:49</td><td>6.2</td><td>0.0</td><td>6.2</td></tr><tr><td>50:51</td><td>6.1</td><td>0.0</td><td>6.1</td></tr><tr><td>23:37</td><td>5.9</td><td>0.4</td><td>5.5</td></tr><tr><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td></tr><tr><td>3:8</td><td>5.7</td><td>0.2</td><td>5.5</td></tr><tr><td>10:15</td><td>5.7</td><td>0.2</td><td>5.5</td></tr><tr><td>38:41</td><td>5.7</td><td>0.2</td><td>5.5</td></tr><tr><td>4:8</td><td>5.7</td><td>0.1</td><td>5.6</td></tr><tr><td>39:41</td><td>5.7</td><td>0.1</td><td>5.6</td></tr><tr><td>4:7</td><td>5.7</td><td>0.0</td><td>5.7</td></tr><tr><td>40:41</td><td>5.7</td><td>0.0</td><td>5.7</td></tr><tr><td>25:27</td><td>5.7</td><td>0.0</td><td>5.7</td></tr><tr><td>13:14</td><td>5.7</td><td>0.0</td><td>5.7</td></tr><tr><td>11:12</td><td>5.6</td><td>0.0</td><td>5.6</td></tr><tr><td>16:17</td><td>5.5</td><td>0.0</td><td>5.5</td></tr><tr><td>20:21</td><td>5.4</td><td>0.0</td><td>5.4</td></tr></tbody></table></div>"
                        ],
                        "text/plain": [
                            "shape: (31, 4)\n",
                            "┌────────┬─────┬──────┬─────┐\n",
                            "│ node   ┆ max ┆ size ┆ min │\n",
                            "│ ---    ┆ --- ┆ ---  ┆ --- │\n",
                            "│ object ┆ f64 ┆ f64  ┆ f64 │\n",
                            "╞════════╪═════╪══════╪═════╡\n",
                            "│ 0:52   ┆ 6.2 ┆ 1.2  ┆ 5.0 │\n",
                            "│ 1:52   ┆ 6.2 ┆ 1.0  ┆ 5.2 │\n",
                            "│ 20:52  ┆ 6.2 ┆ 0.9  ┆ 5.3 │\n",
                            "│ 23:52  ┆ 6.2 ┆ 0.8  ┆ 5.4 │\n",
                            "│ …      ┆ …   ┆ …    ┆ …   │\n",
                            "│ 13:14  ┆ 5.7 ┆ 0.0  ┆ 5.7 │\n",
                            "│ 11:12  ┆ 5.6 ┆ 0.0  ┆ 5.6 │\n",
                            "│ 16:17  ┆ 5.5 ┆ 0.0  ┆ 5.5 │\n",
                            "│ 20:21  ┆ 5.4 ┆ 0.0  ┆ 5.4 │\n",
                            "└────────┴─────┴──────┴─────┘"
                        ]
                    },
                    "execution_count": 8,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add polars functionality to the peaks:\n",
                "peakoscope.interface_polars.TreePolars(peaks, X=X)\n",
                "\n",
                "# Dataframe with peak spans on the y-axis:\n",
                "peaks.polars.numeric_properties()"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "## Basic pandas functionality\n",
                "We could repeat the previous section on \"Basic polars functionality\", replacing \"polars\" with \"pandas\" everywhere, and it would show the same output.\n",
                "\n",
                "To make it less repetitive, we show how to concatenate the three dataframes into a one-view dataframe. The dataframes to be concatenated are:\n",
                "- `peaks.pandas.location_properties()`\n",
                "- `peaks.pandas.tree_structure()`\n",
                "- `peaks.pandas.numeric_properties()`\n",
                "\n",
                "Rows need to be sorted in the same order, but `peaks.pandas` has a `sort` method with a default order, that we can pipe each dataframe to."
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 9,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div>\n",
                            "<style scoped>\n",
                            "    .dataframe tbody tr th:only-of-type {\n",
                            "        vertical-align: middle;\n",
                            "    }\n",
                            "\n",
                            "    .dataframe tbody tr th {\n",
                            "        vertical-align: top;\n",
                            "    }\n",
                            "\n",
                            "    .dataframe thead tr th {\n",
                            "        text-align: left;\n",
                            "    }\n",
                            "</style>\n",
                            "<table border=\"1\" class=\"dataframe\">\n",
                            "  <thead>\n",
                            "    <tr>\n",
                            "      <th></th>\n",
                            "      <th colspan=\"4\" halign=\"left\">Location Props</th>\n",
                            "      <th colspan=\"6\" halign=\"left\">Tree Structure</th>\n",
                            "      <th colspan=\"4\" halign=\"left\">Numeric Props</th>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th></th>\n",
                            "      <th>node</th>\n",
                            "      <th>location</th>\n",
                            "      <th>x_start</th>\n",
                            "      <th>x_end</th>\n",
                            "      <th>core</th>\n",
                            "      <th>children</th>\n",
                            "      <th>node</th>\n",
                            "      <th>parent</th>\n",
                            "      <th>full</th>\n",
                            "      <th>root</th>\n",
                            "      <th>node</th>\n",
                            "      <th>max</th>\n",
                            "      <th>size</th>\n",
                            "      <th>min</th>\n",
                            "    </tr>\n",
                            "  </thead>\n",
                            "  <tbody>\n",
                            "    <tr>\n",
                            "      <th>0</th>\n",
                            "      <td>0:52</td>\n",
                            "      <td>a..Z</td>\n",
                            "      <td>a</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(1:52,)</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>None</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>1.2</td>\n",
                            "      <td>5.0</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>1</th>\n",
                            "      <td>1:52</td>\n",
                            "      <td>b..Z</td>\n",
                            "      <td>b</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(20:52, 2:18)</td>\n",
                            "      <td>1:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>1:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>1.0</td>\n",
                            "      <td>5.2</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>2</th>\n",
                            "      <td>20:52</td>\n",
                            "      <td>u..Z</td>\n",
                            "      <td>u</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(23:52, 20:21)</td>\n",
                            "      <td>20:52</td>\n",
                            "      <td>1:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>20:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.9</td>\n",
                            "      <td>5.3</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>3</th>\n",
                            "      <td>23:52</td>\n",
                            "      <td>x..Z</td>\n",
                            "      <td>x</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(38:52, 23:37)</td>\n",
                            "      <td>23:52</td>\n",
                            "      <td>20:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>23:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.8</td>\n",
                            "      <td>5.4</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>4</th>\n",
                            "      <td>38:52</td>\n",
                            "      <td>M..Z</td>\n",
                            "      <td>M</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(42:52, 38:41)</td>\n",
                            "      <td>38:52</td>\n",
                            "      <td>23:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>38:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.7</td>\n",
                            "      <td>5.5</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>5</th>\n",
                            "      <td>42:52</td>\n",
                            "      <td>Q..Z</td>\n",
                            "      <td>Q</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(46:52, 43:44)</td>\n",
                            "      <td>42:52</td>\n",
                            "      <td>38:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>42:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.6</td>\n",
                            "      <td>5.6</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>6</th>\n",
                            "      <td>46:52</td>\n",
                            "      <td>U..Z</td>\n",
                            "      <td>U</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(47:52,)</td>\n",
                            "      <td>46:52</td>\n",
                            "      <td>42:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>46:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.4</td>\n",
                            "      <td>5.8</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>7</th>\n",
                            "      <td>47:52</td>\n",
                            "      <td>V..Z</td>\n",
                            "      <td>V</td>\n",
                            "      <td>Z</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(47:51,)</td>\n",
                            "      <td>47:52</td>\n",
                            "      <td>46:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>47:52</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.3</td>\n",
                            "      <td>5.9</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>8</th>\n",
                            "      <td>47:51</td>\n",
                            "      <td>V..Y</td>\n",
                            "      <td>V</td>\n",
                            "      <td>Y</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>(48:49, 50:51)</td>\n",
                            "      <td>47:51</td>\n",
                            "      <td>47:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>47:51</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.2</td>\n",
                            "      <td>6.0</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>9</th>\n",
                            "      <td>48:49</td>\n",
                            "      <td>W..W</td>\n",
                            "      <td>W</td>\n",
                            "      <td>W</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>()</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>47:51</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>6.2</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>6.2</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>10</th>\n",
                            "      <td>2:18</td>\n",
                            "      <td>c..r</td>\n",
                            "      <td>c</td>\n",
                            "      <td>r</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>(3:8, 10:15, 16:17)</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>1:52</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.3</td>\n",
                            "      <td>5.4</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>11</th>\n",
                            "      <td>3:8</td>\n",
                            "      <td>d..h</td>\n",
                            "      <td>d</td>\n",
                            "      <td>h</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>(4:8,)</td>\n",
                            "      <td>3:8</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>3:8</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.2</td>\n",
                            "      <td>5.5</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>12</th>\n",
                            "      <td>4:8</td>\n",
                            "      <td>e..h</td>\n",
                            "      <td>e</td>\n",
                            "      <td>h</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>(4:7,)</td>\n",
                            "      <td>4:8</td>\n",
                            "      <td>3:8</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>4:8</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.1</td>\n",
                            "      <td>5.6</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>13</th>\n",
                            "      <td>4:7</td>\n",
                            "      <td>e..g</td>\n",
                            "      <td>e</td>\n",
                            "      <td>g</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>()</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>4:8</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.7</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>14</th>\n",
                            "      <td>20:21</td>\n",
                            "      <td>u..u</td>\n",
                            "      <td>u</td>\n",
                            "      <td>u</td>\n",
                            "      <td>20:21</td>\n",
                            "      <td>()</td>\n",
                            "      <td>20:21</td>\n",
                            "      <td>20:52</td>\n",
                            "      <td>20:21</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>20:21</td>\n",
                            "      <td>5.4</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.4</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>15</th>\n",
                            "      <td>23:37</td>\n",
                            "      <td>x..K</td>\n",
                            "      <td>x</td>\n",
                            "      <td>K</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>(24:35,)</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>23:52</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>5.9</td>\n",
                            "      <td>0.4</td>\n",
                            "      <td>5.5</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>16</th>\n",
                            "      <td>24:35</td>\n",
                            "      <td>y..I</td>\n",
                            "      <td>y</td>\n",
                            "      <td>I</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>(30:35, 25:27)</td>\n",
                            "      <td>24:35</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>24:35</td>\n",
                            "      <td>5.9</td>\n",
                            "      <td>0.3</td>\n",
                            "      <td>5.6</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>17</th>\n",
                            "      <td>30:35</td>\n",
                            "      <td>E..I</td>\n",
                            "      <td>E</td>\n",
                            "      <td>I</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>(31:35,)</td>\n",
                            "      <td>30:35</td>\n",
                            "      <td>24:35</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>30:35</td>\n",
                            "      <td>5.9</td>\n",
                            "      <td>0.2</td>\n",
                            "      <td>5.7</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>18</th>\n",
                            "      <td>31:35</td>\n",
                            "      <td>F..I</td>\n",
                            "      <td>F</td>\n",
                            "      <td>I</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>(31:34,)</td>\n",
                            "      <td>31:35</td>\n",
                            "      <td>30:35</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>31:35</td>\n",
                            "      <td>5.9</td>\n",
                            "      <td>0.2</td>\n",
                            "      <td>5.7</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>19</th>\n",
                            "      <td>31:34</td>\n",
                            "      <td>F..H</td>\n",
                            "      <td>F</td>\n",
                            "      <td>H</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>(31:33,)</td>\n",
                            "      <td>31:34</td>\n",
                            "      <td>31:35</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>31:34</td>\n",
                            "      <td>5.9</td>\n",
                            "      <td>0.1</td>\n",
                            "      <td>5.8</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>20</th>\n",
                            "      <td>31:33</td>\n",
                            "      <td>F..G</td>\n",
                            "      <td>F</td>\n",
                            "      <td>G</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>()</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>31:34</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>5.9</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.9</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>21</th>\n",
                            "      <td>38:41</td>\n",
                            "      <td>M..O</td>\n",
                            "      <td>M</td>\n",
                            "      <td>O</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>(39:41,)</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>38:52</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.2</td>\n",
                            "      <td>5.5</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>22</th>\n",
                            "      <td>39:41</td>\n",
                            "      <td>N..O</td>\n",
                            "      <td>N</td>\n",
                            "      <td>O</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>(40:41,)</td>\n",
                            "      <td>39:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>39:41</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.1</td>\n",
                            "      <td>5.6</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>23</th>\n",
                            "      <td>40:41</td>\n",
                            "      <td>O..O</td>\n",
                            "      <td>O</td>\n",
                            "      <td>O</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>()</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>39:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.7</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>24</th>\n",
                            "      <td>43:44</td>\n",
                            "      <td>R..R</td>\n",
                            "      <td>R</td>\n",
                            "      <td>R</td>\n",
                            "      <td>43:44</td>\n",
                            "      <td>()</td>\n",
                            "      <td>43:44</td>\n",
                            "      <td>42:52</td>\n",
                            "      <td>43:44</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>43:44</td>\n",
                            "      <td>5.8</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.8</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>25</th>\n",
                            "      <td>50:51</td>\n",
                            "      <td>Y..Y</td>\n",
                            "      <td>Y</td>\n",
                            "      <td>Y</td>\n",
                            "      <td>50:51</td>\n",
                            "      <td>()</td>\n",
                            "      <td>50:51</td>\n",
                            "      <td>47:51</td>\n",
                            "      <td>50:51</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>50:51</td>\n",
                            "      <td>6.1</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>6.1</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>26</th>\n",
                            "      <td>25:27</td>\n",
                            "      <td>z..A</td>\n",
                            "      <td>z</td>\n",
                            "      <td>A</td>\n",
                            "      <td>25:27</td>\n",
                            "      <td>()</td>\n",
                            "      <td>25:27</td>\n",
                            "      <td>24:35</td>\n",
                            "      <td>25:27</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>25:27</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.7</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>27</th>\n",
                            "      <td>10:15</td>\n",
                            "      <td>k..o</td>\n",
                            "      <td>k</td>\n",
                            "      <td>o</td>\n",
                            "      <td>13:14</td>\n",
                            "      <td>(13:14, 11:12)</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.2</td>\n",
                            "      <td>5.5</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>28</th>\n",
                            "      <td>13:14</td>\n",
                            "      <td>n..n</td>\n",
                            "      <td>n</td>\n",
                            "      <td>n</td>\n",
                            "      <td>13:14</td>\n",
                            "      <td>()</td>\n",
                            "      <td>13:14</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>13:14</td>\n",
                            "      <td>5.7</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.7</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>29</th>\n",
                            "      <td>16:17</td>\n",
                            "      <td>q..q</td>\n",
                            "      <td>q</td>\n",
                            "      <td>q</td>\n",
                            "      <td>16:17</td>\n",
                            "      <td>()</td>\n",
                            "      <td>16:17</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>16:17</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>16:17</td>\n",
                            "      <td>5.5</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.5</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>30</th>\n",
                            "      <td>11:12</td>\n",
                            "      <td>l..l</td>\n",
                            "      <td>l</td>\n",
                            "      <td>l</td>\n",
                            "      <td>11:12</td>\n",
                            "      <td>()</td>\n",
                            "      <td>11:12</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>11:12</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>11:12</td>\n",
                            "      <td>5.6</td>\n",
                            "      <td>0.0</td>\n",
                            "      <td>5.6</td>\n",
                            "    </tr>\n",
                            "  </tbody>\n",
                            "</table>\n",
                            "</div>"
                        ],
                        "text/plain": [
                            "   Location Props                        Tree Structure                       \\\n",
                            "             node location x_start x_end           core             children   \n",
                            "0            0:52     a..Z       a     Z          48:49              (1:52,)   \n",
                            "1            1:52     b..Z       b     Z          48:49        (20:52, 2:18)   \n",
                            "2           20:52     u..Z       u     Z          48:49       (23:52, 20:21)   \n",
                            "3           23:52     x..Z       x     Z          48:49       (38:52, 23:37)   \n",
                            "4           38:52     M..Z       M     Z          48:49       (42:52, 38:41)   \n",
                            "5           42:52     Q..Z       Q     Z          48:49       (46:52, 43:44)   \n",
                            "6           46:52     U..Z       U     Z          48:49             (47:52,)   \n",
                            "7           47:52     V..Z       V     Z          48:49             (47:51,)   \n",
                            "8           47:51     V..Y       V     Y          48:49       (48:49, 50:51)   \n",
                            "9           48:49     W..W       W     W          48:49                   ()   \n",
                            "10           2:18     c..r       c     r            4:7  (3:8, 10:15, 16:17)   \n",
                            "11            3:8     d..h       d     h            4:7               (4:8,)   \n",
                            "12            4:8     e..h       e     h            4:7               (4:7,)   \n",
                            "13            4:7     e..g       e     g            4:7                   ()   \n",
                            "14          20:21     u..u       u     u          20:21                   ()   \n",
                            "15          23:37     x..K       x     K          31:33             (24:35,)   \n",
                            "16          24:35     y..I       y     I          31:33       (30:35, 25:27)   \n",
                            "17          30:35     E..I       E     I          31:33             (31:35,)   \n",
                            "18          31:35     F..I       F     I          31:33             (31:34,)   \n",
                            "19          31:34     F..H       F     H          31:33             (31:33,)   \n",
                            "20          31:33     F..G       F     G          31:33                   ()   \n",
                            "21          38:41     M..O       M     O          40:41             (39:41,)   \n",
                            "22          39:41     N..O       N     O          40:41             (40:41,)   \n",
                            "23          40:41     O..O       O     O          40:41                   ()   \n",
                            "24          43:44     R..R       R     R          43:44                   ()   \n",
                            "25          50:51     Y..Y       Y     Y          50:51                   ()   \n",
                            "26          25:27     z..A       z     A          25:27                   ()   \n",
                            "27          10:15     k..o       k     o          13:14       (13:14, 11:12)   \n",
                            "28          13:14     n..n       n     n          13:14                   ()   \n",
                            "29          16:17     q..q       q     q          16:17                   ()   \n",
                            "30          11:12     l..l       l     l          11:12                   ()   \n",
                            "\n",
                            "                              Numeric Props                 \n",
                            "     node parent   full  root          node  max size  min  \n",
                            "0    0:52   None   0:52  0:52          0:52  6.2  1.2  5.0  \n",
                            "1    1:52   0:52   0:52  0:52          1:52  6.2  1.0  5.2  \n",
                            "2   20:52   1:52   0:52  0:52         20:52  6.2  0.9  5.3  \n",
                            "3   23:52  20:52   0:52  0:52         23:52  6.2  0.8  5.4  \n",
                            "4   38:52  23:52   0:52  0:52         38:52  6.2  0.7  5.5  \n",
                            "5   42:52  38:52   0:52  0:52         42:52  6.2  0.6  5.6  \n",
                            "6   46:52  42:52   0:52  0:52         46:52  6.2  0.4  5.8  \n",
                            "7   47:52  46:52   0:52  0:52         47:52  6.2  0.3  5.9  \n",
                            "8   47:51  47:52   0:52  0:52         47:51  6.2  0.2  6.0  \n",
                            "9   48:49  47:51   0:52  0:52         48:49  6.2  0.0  6.2  \n",
                            "10   2:18   1:52   2:18  0:52          2:18  5.7  0.3  5.4  \n",
                            "11    3:8   2:18   2:18  0:52           3:8  5.7  0.2  5.5  \n",
                            "12    4:8    3:8   2:18  0:52           4:8  5.7  0.1  5.6  \n",
                            "13    4:7    4:8   2:18  0:52           4:7  5.7  0.0  5.7  \n",
                            "14  20:21  20:52  20:21  0:52         20:21  5.4  0.0  5.4  \n",
                            "15  23:37  23:52  23:37  0:52         23:37  5.9  0.4  5.5  \n",
                            "16  24:35  23:37  23:37  0:52         24:35  5.9  0.3  5.6  \n",
                            "17  30:35  24:35  23:37  0:52         30:35  5.9  0.2  5.7  \n",
                            "18  31:35  30:35  23:37  0:52         31:35  5.9  0.2  5.7  \n",
                            "19  31:34  31:35  23:37  0:52         31:34  5.9  0.1  5.8  \n",
                            "20  31:33  31:34  23:37  0:52         31:33  5.9  0.0  5.9  \n",
                            "21  38:41  38:52  38:41  0:52         38:41  5.7  0.2  5.5  \n",
                            "22  39:41  38:41  38:41  0:52         39:41  5.7  0.1  5.6  \n",
                            "23  40:41  39:41  38:41  0:52         40:41  5.7  0.0  5.7  \n",
                            "24  43:44  42:52  43:44  0:52         43:44  5.8  0.0  5.8  \n",
                            "25  50:51  47:51  50:51  0:52         50:51  6.1  0.0  6.1  \n",
                            "26  25:27  24:35  25:27  0:52         25:27  5.7  0.0  5.7  \n",
                            "27  10:15   2:18  10:15  0:52         10:15  5.7  0.2  5.5  \n",
                            "28  13:14  10:15  10:15  0:52         13:14  5.7  0.0  5.7  \n",
                            "29  16:17   2:18  16:17  0:52         16:17  5.5  0.0  5.5  \n",
                            "30  11:12  10:15  11:12  0:52         11:12  5.6  0.0  5.6  "
                        ]
                    },
                    "execution_count": 9,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add pandas functionality to the peaks:\n",
                "peakoscope.interface_pandas.TreePandas(peaks, X=X)\n",
                "\n",
                "\n",
                "# Let pandas concatenate the sorted dataframes under a hierarchical index:\n",
                "concat(\n",
                "    {\n",
                "        \"Location Props\": peaks.pandas.location_properties().pipe(peaks.pandas.sort),\n",
                "        \"Tree Structure\": peaks.pandas.tree_structure().pipe(peaks.pandas.sort),\n",
                "        \"Numeric Props\": peaks.pandas.numeric_properties().pipe(peaks.pandas.sort),\n",
                "    },\n",
                "    axis=1,\n",
                ")"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "Notes:\n",
                "- The same node column appear three places. Just more readable?\n",
                "- The integer index on the left can be ignored, since it is not meaningful. This is true for all `tree.pandas` dataframes.\n",
                "\n"
            ]
        },
        {
            "attachments": {},
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "## Viewing internal data attributes\n",
                "The internal data structure of a `Tree` object can also be exported. This can be useful for inspection or storage.\n",
                "\n",
                "First in polars:"
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 10,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div><style>\n",
                            ".dataframe > thead > tr > th,\n",
                            ".dataframe > tbody > tr > td {\n",
                            "  text-align: right;\n",
                            "  white-space: pre-wrap;\n",
                            "}\n",
                            "</style>\n",
                            "<small>shape: (31, 6)</small><table border=\"1\" class=\"dataframe\"><thead><tr><th>node</th><th>_parent</th><th>_children</th><th>_core</th><th>_full</th><th>_root</th></tr><tr><td>object</td><td>str</td><td>list[str]</td><td>str</td><td>str</td><td>str</td></tr></thead><tbody><tr><td>0:52</td><td>null</td><td>[&quot;1:52&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>1:52</td><td>&quot;0:52&quot;</td><td>[&quot;20:52&quot;, &quot;2:18&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>20:52</td><td>&quot;1:52&quot;</td><td>[&quot;23:52&quot;, &quot;20:21&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>23:52</td><td>&quot;20:52&quot;</td><td>[&quot;38:52&quot;, &quot;23:37&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>38:52</td><td>&quot;23:52&quot;</td><td>[&quot;42:52&quot;, &quot;38:41&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>42:52</td><td>&quot;38:52&quot;</td><td>[&quot;46:52&quot;, &quot;43:44&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>46:52</td><td>&quot;42:52&quot;</td><td>[&quot;47:52&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>47:52</td><td>&quot;46:52&quot;</td><td>[&quot;47:51&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>47:51</td><td>&quot;47:52&quot;</td><td>[&quot;48:49&quot;, &quot;50:51&quot;]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>48:49</td><td>&quot;47:51&quot;</td><td>[]</td><td>&quot;48:49&quot;</td><td>&quot;0:52&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>2:18</td><td>&quot;1:52&quot;</td><td>[&quot;3:8&quot;, &quot;10:15&quot;, &quot;16:17&quot;]</td><td>&quot;4:7&quot;</td><td>&quot;2:18&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>3:8</td><td>&quot;2:18&quot;</td><td>[&quot;4:8&quot;]</td><td>&quot;4:7&quot;</td><td>&quot;2:18&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td><td>&hellip;</td></tr><tr><td>31:34</td><td>&quot;31:35&quot;</td><td>[&quot;31:33&quot;]</td><td>&quot;31:33&quot;</td><td>&quot;23:37&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>31:33</td><td>&quot;31:34&quot;</td><td>[]</td><td>&quot;31:33&quot;</td><td>&quot;23:37&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>38:41</td><td>&quot;38:52&quot;</td><td>[&quot;39:41&quot;]</td><td>&quot;40:41&quot;</td><td>&quot;38:41&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>39:41</td><td>&quot;38:41&quot;</td><td>[&quot;40:41&quot;]</td><td>&quot;40:41&quot;</td><td>&quot;38:41&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>40:41</td><td>&quot;39:41&quot;</td><td>[]</td><td>&quot;40:41&quot;</td><td>&quot;38:41&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>43:44</td><td>&quot;42:52&quot;</td><td>[]</td><td>&quot;43:44&quot;</td><td>&quot;43:44&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>50:51</td><td>&quot;47:51&quot;</td><td>[]</td><td>&quot;50:51&quot;</td><td>&quot;50:51&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>25:27</td><td>&quot;24:35&quot;</td><td>[]</td><td>&quot;25:27&quot;</td><td>&quot;25:27&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>10:15</td><td>&quot;2:18&quot;</td><td>[&quot;13:14&quot;, &quot;11:12&quot;]</td><td>&quot;13:14&quot;</td><td>&quot;10:15&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>13:14</td><td>&quot;10:15&quot;</td><td>[]</td><td>&quot;13:14&quot;</td><td>&quot;10:15&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>16:17</td><td>&quot;2:18&quot;</td><td>[]</td><td>&quot;16:17&quot;</td><td>&quot;16:17&quot;</td><td>&quot;0:52&quot;</td></tr><tr><td>11:12</td><td>&quot;10:15&quot;</td><td>[]</td><td>&quot;11:12&quot;</td><td>&quot;11:12&quot;</td><td>&quot;0:52&quot;</td></tr></tbody></table></div>"
                        ],
                        "text/plain": [
                            "shape: (31, 6)\n",
                            "┌────────┬─────────┬────────────────────┬───────┬───────┬───────┐\n",
                            "│ node   ┆ _parent ┆ _children          ┆ _core ┆ _full ┆ _root │\n",
                            "│ ---    ┆ ---     ┆ ---                ┆ ---   ┆ ---   ┆ ---   │\n",
                            "│ object ┆ str     ┆ list[str]          ┆ str   ┆ str   ┆ str   │\n",
                            "╞════════╪═════════╪════════════════════╪═══════╪═══════╪═══════╡\n",
                            "│ 0:52   ┆ null    ┆ [\"1:52\"]           ┆ 48:49 ┆ 0:52  ┆ 0:52  │\n",
                            "│ 1:52   ┆ 0:52    ┆ [\"20:52\", \"2:18\"]  ┆ 48:49 ┆ 0:52  ┆ 0:52  │\n",
                            "│ 20:52  ┆ 1:52    ┆ [\"23:52\", \"20:21\"] ┆ 48:49 ┆ 0:52  ┆ 0:52  │\n",
                            "│ 23:52  ┆ 20:52   ┆ [\"38:52\", \"23:37\"] ┆ 48:49 ┆ 0:52  ┆ 0:52  │\n",
                            "│ …      ┆ …       ┆ …                  ┆ …     ┆ …     ┆ …     │\n",
                            "│ 10:15  ┆ 2:18    ┆ [\"13:14\", \"11:12\"] ┆ 13:14 ┆ 10:15 ┆ 0:52  │\n",
                            "│ 13:14  ┆ 10:15   ┆ []                 ┆ 13:14 ┆ 10:15 ┆ 0:52  │\n",
                            "│ 16:17  ┆ 2:18    ┆ []                 ┆ 16:17 ┆ 16:17 ┆ 0:52  │\n",
                            "│ 11:12  ┆ 10:15   ┆ []                 ┆ 11:12 ┆ 11:12 ┆ 0:52  │\n",
                            "└────────┴─────────┴────────────────────┴───────┴───────┴───────┘"
                        ]
                    },
                    "execution_count": 10,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add polars functionality to the peaks:\n",
                "peakoscope.interface_polars.TreePolars(peaks, X=X)\n",
                "\n",
                "# Export Tree data:\n",
                "peaks.polars.dump_data_attributes()\n"
            ]
        },
        {
            "cell_type": "markdown",
            "metadata": {},
            "source": [
                "And in pandas:"
            ]
        },
        {
            "cell_type": "code",
            "execution_count": 11,
            "metadata": {},
            "outputs": [
                {
                    "data": {
                        "text/html": [
                            "<div>\n",
                            "<style scoped>\n",
                            "    .dataframe tbody tr th:only-of-type {\n",
                            "        vertical-align: middle;\n",
                            "    }\n",
                            "\n",
                            "    .dataframe tbody tr th {\n",
                            "        vertical-align: top;\n",
                            "    }\n",
                            "\n",
                            "    .dataframe thead th {\n",
                            "        text-align: right;\n",
                            "    }\n",
                            "</style>\n",
                            "<table border=\"1\" class=\"dataframe\">\n",
                            "  <thead>\n",
                            "    <tr style=\"text-align: right;\">\n",
                            "      <th></th>\n",
                            "      <th>node</th>\n",
                            "      <th>_parent</th>\n",
                            "      <th>_children</th>\n",
                            "      <th>_core</th>\n",
                            "      <th>_full</th>\n",
                            "      <th>_root</th>\n",
                            "    </tr>\n",
                            "  </thead>\n",
                            "  <tbody>\n",
                            "    <tr>\n",
                            "      <th>0</th>\n",
                            "      <td>0:52</td>\n",
                            "      <td>&lt;NA&gt;</td>\n",
                            "      <td>(1:52,)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>1</th>\n",
                            "      <td>1:52</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>(20:52, 2:18)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>2</th>\n",
                            "      <td>20:52</td>\n",
                            "      <td>1:52</td>\n",
                            "      <td>(23:52, 20:21)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>3</th>\n",
                            "      <td>23:52</td>\n",
                            "      <td>20:52</td>\n",
                            "      <td>(38:52, 23:37)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>4</th>\n",
                            "      <td>38:52</td>\n",
                            "      <td>23:52</td>\n",
                            "      <td>(42:52, 38:41)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>5</th>\n",
                            "      <td>42:52</td>\n",
                            "      <td>38:52</td>\n",
                            "      <td>(46:52, 43:44)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>6</th>\n",
                            "      <td>46:52</td>\n",
                            "      <td>42:52</td>\n",
                            "      <td>(47:52,)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>7</th>\n",
                            "      <td>47:52</td>\n",
                            "      <td>46:52</td>\n",
                            "      <td>(47:51,)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>8</th>\n",
                            "      <td>47:51</td>\n",
                            "      <td>47:52</td>\n",
                            "      <td>(48:49, 50:51)</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>9</th>\n",
                            "      <td>48:49</td>\n",
                            "      <td>47:51</td>\n",
                            "      <td>()</td>\n",
                            "      <td>48:49</td>\n",
                            "      <td>0:52</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>10</th>\n",
                            "      <td>2:18</td>\n",
                            "      <td>1:52</td>\n",
                            "      <td>(3:8, 10:15, 16:17)</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>11</th>\n",
                            "      <td>3:8</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>(4:8,)</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>12</th>\n",
                            "      <td>4:8</td>\n",
                            "      <td>3:8</td>\n",
                            "      <td>(4:7,)</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>13</th>\n",
                            "      <td>4:7</td>\n",
                            "      <td>4:8</td>\n",
                            "      <td>()</td>\n",
                            "      <td>4:7</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>14</th>\n",
                            "      <td>20:21</td>\n",
                            "      <td>20:52</td>\n",
                            "      <td>()</td>\n",
                            "      <td>20:21</td>\n",
                            "      <td>20:21</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>15</th>\n",
                            "      <td>23:37</td>\n",
                            "      <td>23:52</td>\n",
                            "      <td>(24:35,)</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>16</th>\n",
                            "      <td>24:35</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>(30:35, 25:27)</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>17</th>\n",
                            "      <td>30:35</td>\n",
                            "      <td>24:35</td>\n",
                            "      <td>(31:35,)</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>18</th>\n",
                            "      <td>31:35</td>\n",
                            "      <td>30:35</td>\n",
                            "      <td>(31:34,)</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>19</th>\n",
                            "      <td>31:34</td>\n",
                            "      <td>31:35</td>\n",
                            "      <td>(31:33,)</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>20</th>\n",
                            "      <td>31:33</td>\n",
                            "      <td>31:34</td>\n",
                            "      <td>()</td>\n",
                            "      <td>31:33</td>\n",
                            "      <td>23:37</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>21</th>\n",
                            "      <td>38:41</td>\n",
                            "      <td>38:52</td>\n",
                            "      <td>(39:41,)</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>22</th>\n",
                            "      <td>39:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>(40:41,)</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>23</th>\n",
                            "      <td>40:41</td>\n",
                            "      <td>39:41</td>\n",
                            "      <td>()</td>\n",
                            "      <td>40:41</td>\n",
                            "      <td>38:41</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>24</th>\n",
                            "      <td>43:44</td>\n",
                            "      <td>42:52</td>\n",
                            "      <td>()</td>\n",
                            "      <td>43:44</td>\n",
                            "      <td>43:44</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>25</th>\n",
                            "      <td>50:51</td>\n",
                            "      <td>47:51</td>\n",
                            "      <td>()</td>\n",
                            "      <td>50:51</td>\n",
                            "      <td>50:51</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>26</th>\n",
                            "      <td>25:27</td>\n",
                            "      <td>24:35</td>\n",
                            "      <td>()</td>\n",
                            "      <td>25:27</td>\n",
                            "      <td>25:27</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>27</th>\n",
                            "      <td>10:15</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>(13:14, 11:12)</td>\n",
                            "      <td>13:14</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>28</th>\n",
                            "      <td>13:14</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>()</td>\n",
                            "      <td>13:14</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>29</th>\n",
                            "      <td>16:17</td>\n",
                            "      <td>2:18</td>\n",
                            "      <td>()</td>\n",
                            "      <td>16:17</td>\n",
                            "      <td>16:17</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "    <tr>\n",
                            "      <th>30</th>\n",
                            "      <td>11:12</td>\n",
                            "      <td>10:15</td>\n",
                            "      <td>()</td>\n",
                            "      <td>11:12</td>\n",
                            "      <td>11:12</td>\n",
                            "      <td>0:52</td>\n",
                            "    </tr>\n",
                            "  </tbody>\n",
                            "</table>\n",
                            "</div>"
                        ],
                        "text/plain": [
                            "     node _parent            _children  _core  _full _root\n",
                            "0    0:52    <NA>              (1:52,)  48:49   0:52  0:52\n",
                            "1    1:52    0:52        (20:52, 2:18)  48:49   0:52  0:52\n",
                            "2   20:52    1:52       (23:52, 20:21)  48:49   0:52  0:52\n",
                            "3   23:52   20:52       (38:52, 23:37)  48:49   0:52  0:52\n",
                            "4   38:52   23:52       (42:52, 38:41)  48:49   0:52  0:52\n",
                            "5   42:52   38:52       (46:52, 43:44)  48:49   0:52  0:52\n",
                            "6   46:52   42:52             (47:52,)  48:49   0:52  0:52\n",
                            "7   47:52   46:52             (47:51,)  48:49   0:52  0:52\n",
                            "8   47:51   47:52       (48:49, 50:51)  48:49   0:52  0:52\n",
                            "9   48:49   47:51                   ()  48:49   0:52  0:52\n",
                            "10   2:18    1:52  (3:8, 10:15, 16:17)    4:7   2:18  0:52\n",
                            "11    3:8    2:18               (4:8,)    4:7   2:18  0:52\n",
                            "12    4:8     3:8               (4:7,)    4:7   2:18  0:52\n",
                            "13    4:7     4:8                   ()    4:7   2:18  0:52\n",
                            "14  20:21   20:52                   ()  20:21  20:21  0:52\n",
                            "15  23:37   23:52             (24:35,)  31:33  23:37  0:52\n",
                            "16  24:35   23:37       (30:35, 25:27)  31:33  23:37  0:52\n",
                            "17  30:35   24:35             (31:35,)  31:33  23:37  0:52\n",
                            "18  31:35   30:35             (31:34,)  31:33  23:37  0:52\n",
                            "19  31:34   31:35             (31:33,)  31:33  23:37  0:52\n",
                            "20  31:33   31:34                   ()  31:33  23:37  0:52\n",
                            "21  38:41   38:52             (39:41,)  40:41  38:41  0:52\n",
                            "22  39:41   38:41             (40:41,)  40:41  38:41  0:52\n",
                            "23  40:41   39:41                   ()  40:41  38:41  0:52\n",
                            "24  43:44   42:52                   ()  43:44  43:44  0:52\n",
                            "25  50:51   47:51                   ()  50:51  50:51  0:52\n",
                            "26  25:27   24:35                   ()  25:27  25:27  0:52\n",
                            "27  10:15    2:18       (13:14, 11:12)  13:14  10:15  0:52\n",
                            "28  13:14   10:15                   ()  13:14  10:15  0:52\n",
                            "29  16:17    2:18                   ()  16:17  16:17  0:52\n",
                            "30  11:12   10:15                   ()  11:12  11:12  0:52"
                        ]
                    },
                    "execution_count": 11,
                    "metadata": {},
                    "output_type": "execute_result"
                }
            ],
            "source": [
                "# Generate the data set:\n",
                "X, Y = peakoscope.example_1(randomseed=RANDOM_SEED)\n",
                "# Get the peak analysis results:\n",
                "peaks = peakoscope.tree(Y)\n",
                "# Add pandas functionality to the peaks:\n",
                "peakoscope.interface_pandas.TreePandas(peaks, X=X)\n",
                "\n",
                "# Export Tree data:\n",
                "peaks.pandas.dump_data_attributes()\n"
            ]
        }
    ],
    "metadata": {
        "kernelspec": {
            "display_name": "aug22",
            "language": "python",
            "name": "python3"
        },
        "language_info": {
            "codemirror_mode": {
                "name": "ipython",
                "version": 3
            },
            "file_extension": ".py",
            "mimetype": "text/x-python",
            "name": "python",
            "nbconvert_exporter": "python",
            "pygments_lexer": "ipython3",
            "version": "3.12.0"
        },
        "orig_nbformat": 4
    },
    "nbformat": 4,
    "nbformat_minor": 2
}