scripts/HackTribing_Notebook.ipynb

{
  "nbformat": 4,
  "nbformat_minor": 0,
  "metadata": {
    "colab": {
      "provenance": [],
      "mount_file_id": "10PMr9ydMXb3WKN4HRPeLkVuX47DJCwEi",
      "authorship_tag": "ABX9TyNjNEWd+PbqYx7jh0Nv7A/2",
      "include_colab_link": true
    },
    "kernelspec": {
      "name": "python3",
      "display_name": "Python 3"
    },
    "language_info": {
      "name": "python"
    }
  },
  "cells": [
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "view-in-github",
        "colab_type": "text"
      },
      "source": [
        "<a href=\"https://colab.research.google.com/github/untergeekDE/hacktribe/blob/main/scripts/HackTribing_Notebook.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "**How to run this thing:** *Click the \"Open in Colab\" button above. Colab is free to use, but you need a Google account, e.g. an Android, Gmail or Youtube user. \n",
        "\n",
        "# HackTribing Notebook\n",
        "\n",
        "**Don't want to mess with installing Python, or (God beware!) Linux, on your PC?** \n",
        "\n",
        "This Notebook - a mixture of explanations and runnable code - will run on a virtual machine with Google (for free!), which has Python and a lot of Linux tools pre-installed. \n",
        "\n",
        "**This is like a book that can do things with code.** It should do the work for you - all you have to do is to upload and download the files you want to have changed, and click \"Run\" on each of the code cells. \n",
        "\n",
        "Run each code cell by clicking on the small arrow button left of it, one after the other.\n",
        "\n",
        "## You've got a RedTribe Sampler, haven't you?\n",
        "\n",
        "This is for people trying to patch their red (or black) Electribe 2S sampler. If you've got the blue (or grey) synth version, there will be another notebook for you. \n",
        "\n",
        "## You've got a computer, haven't you?\n",
        "\n",
        "Well, obviously. You are sitting in a computer connected to the Internet. You will also need that computer to read and write the SD card from your Electribe. (If you haven't got an SD card yet, don't worry: get a run-of-the-mill SD memory card - 4GB will be enough, but you probably will find 16GB or 32GB, which is OK - turn on your Tribe, insert the card, and navigate the Menu to DATA UTILITY (28/29), then select CARD FORMAT (12/14) - only if you have got a blank card, of course. \n",
        "\n",
        "## You have no fear of damaging your e2s, have you?\n",
        "\n",
        "Well, you don't have to. Everything you do is reversible - if you don't like the HackTribe firmware, you may go back to the standard firmware (the last paragraph of this notebook tells you how). \n",
        "\n",
        "But of course, by fumbling with free third-party software, you step over a line the manufacturer drew for your safety. It might void you warranty, make your music demonic, corrupt your partner's morality, teach your children swear words, etc. etc. And none of all those volunteer software authors like bangcorrupt or me is going to take any responsibility for any of this. \n",
        "\n",
        "## You can read, can you?\n",
        "\n",
        "Loads of text here - but while you may just skip over the computer code in the grey boxes, I would ask you politely to Read. Every. Bloody. Step. \n",
        "\n",
        "Most of the work will be done by the code in the workbook. Whenever it needs you to do something, it will tell you: \n",
        "\n",
        "### *IT'S YOUR TURN: Could you click RUN on this code box, please?*"
      ],
      "metadata": {
        "id": "XWnMW8Gd9HZO"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "# A simple way of hiding readable text from humans\n",
        "def rot13(sentence):\n",
        "    d = {}\n",
        "    for ascii_code in (65, 97):\n",
        "        for alphabet_index in range(26):\n",
        "            d[chr(ascii_code + alphabet_index)] = \\\n",
        "                        chr(ascii_code + (alphabet_index + 13) % 26)\n",
        "    return ''.join([d.get(letter, letter) for letter in sentence])\n",
        "\n",
        "# No need to understand what the code does if you don't want to!\n",
        "print(rot13(\"Rkpryyrag. Lbh'er qbvat terng!!!\"))"
      ],
      "metadata": {
        "id": "5JdOi-YOYVFL"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "Did it say \"Excellent\" in the output field above? \n",
        "\n",
        "# Okay, let's get going!\n",
        "\n",
        "## Step 1: Prepare your Electribe\n",
        "\n",
        "If you want to keep your work, you should export your RedTribe's factory samples, and your patterns, to your SD card. \n",
        "\n",
        "### *It's your turn: Export samples and patches from your E2S to an SD card. *\n",
        "\n",
        "* Insert the card. \n",
        "* Navigate the menu to DATA UTILITY (28/29), then select and execute EXPORT ALL PATTERN (2/14).\n",
        "* Stay in the DATA UTILITY menu, select and execute EXPORT ALL SAMPLE (11/14). \n",
        "\n",
        "Switch off your Tribe, take the SD card to your computer, and have a look at it: \n",
        "\n",
        "* In the folder ```KORG/electribe sampler/```, you will find a file name ```electribe_sampler_allpattern.e2sallpat``` containing your patterns.\n",
        "* in the folder ```KORG/electribe sampler/sample``` containing ```e2sSample.all```, a dump of all your samples. \n",
        "\n",
        "We will get to the files later - but you know where they are now. **And please keep the files on the card, don't erase them - if you want to reverse the hack, you will need these filesm.** Now let's prepare our virtual machine. \n",
        "\n",
        "## Step 2: Download the HackTribe code. \n",
        "\n",
        "It's as simple as clicking on the RUN button. "
      ],
      "metadata": {
        "id": "xZaY1iL4YbmH"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "# Get the Hacktribe code. \n",
        "!git clone --recursive https://github.com/untergeekDE/hacktribe.git"
      ],
      "metadata": {
        "id": "Q1A0dgfN-VWH"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "**What you have just done:** You have told the computer to download bangcorrupt's Hacktribe scripts onto your virtual machine's harddisk memory \n",
        "\n",
        "**Where has it gone?** Look - there's a small folder symbol to the very right of the screen. Click it, and then click on the small triangle next to the \"hacktribe\" folder to show what is in there. \n",
        "\n",
        "![folder-screen.png](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZEAAAGBCAYAAACn94zMAAAhwXpUWHRSYXcgcHJvZmlsZSB0eXBlIGV4aWYAAHjarZtpdty4koX/YxW9BEyBYTkYz+kd9PL7u0xJtmS5yu7X5bJSzmSSBCLiDgHQnf/57+v+i/+axeyy1VZ6KZ7/cs89Dn5p/vXfeH4Gn5+fz389vP0WPr/v2vsHkdfEa3p90MrrNby///aF99cw+M1+PtF6+2B+/qDn12tsX070dqGkG4j8st9O1N9OlOLrg/B2gvEali+91Z+HMM/r9e37r2ngr9OPsvwzkPD26dd/58rsbeM6KcaTQvL8jCm+biDpb3Rp8EHkZ0yNAzno4x1L4e1OmJDv5sn/dFfua1Q+fvsSlWtvn34JSiqvIxxvfJ7M8vH67fvBvp9890zxT1dO6yMdPr3vR/xlOO9/793N3Xteoxu5MKXlbVDvQ3x+48DJlKfna4U/lb/G7/X50/nTHNm7CPn2y0/+rNBDZMZvyGGHEW44z+sKi1vM8cTKa4wrpue9lmrscSXviFDWn3BjTT3t1IjYIryJd+PHvYTnuv253AqNC+/AkTFwsvAKf/z/+fPbE92rlA/hmUx75or7ippxbkOR00+OIiDhvueRPRP8/ufrf4prIoL2THNjgMPP1ymmhbfcUh6lJ9CJA43XV62Fut9OwBRxbeNmQiICvoRkoQRfY6whMI+N+AxO1GLKcRKCYBY3dxlzSoXgUDFcm+/U8BwbLb7eBrMIhKWSKqHpaRArARv5U3Mjh4Yly2ZWrFqzbqOkkouVUmoR+I2aaq5WS6211V5HSy03a6XV1lzrbfTYE+BovfTaW+99DC46OPPg24MDxphxppmnzTLrbLPPsUiflZetsupqbvU1dtxpgxO77Lrb7nuccEilk4+dcuppp59xSbWbbr52y6233X7HR9SCe4X1lz9/HrXwHrX4REoH1o+o8dVa308RBCemmBGxmAMRr4oACR0VM99CztEpdIqZ75GqsMhdmoKzgyJGBPMJ0W74iN2PyH2Km8v5P4pbfI+cU+j+PyLnFLrfRO7XuH0TtS22WT65J0IqQ02qT5TfrXu3ebjr10vfGbxOtcQ7/Eivl2rirZ8OdH985L8c6P4PF//2QPc3F18z1TnGYj5X3b3wSj40gh8awJbP4rN2C6e8fSvSFIhtZpXJD2Ndg3KP7QTG9pFz5fT8JcczAF4vMWWyh326kzHOCAS79NEDd5DLvYX0nKIYkq1VkkpRO4R4xp0Pf6GE4kgKKz36Ntud2UeyNdVqdm3VChdMRmikleUMvaiUYj+l3ynoI7frJRFqT+7une4aZB5kepbdHHJ5Xgzw4gj4a2xIo2ULpFzJcNck8TozGG9esevd6pJmtlqscxozwc34kma/cR2l6uzcW5yrgqt9VaIS6vwUgVNj3rm7sSliztjD2X2qpm3xxTEn87Yi1yO7M4S3LuPnIBs32dhWUo/WT5jlpnIimH1KnESsKSZh8qZNlfQCDto9uRASInBUyY16joEA9sCR8/Qa563p9J3c6bZNiRRsZi7KXETLINWsI+ZcUriM/WQgoLbJzVL20fxpC8Tst5wiuIjL5VG5OAMJq4e2Njeks6JJdMF8y9y8mE2gPq8+QIwEOJxUiGNPZXYAs1VzxBdeS4F/5kK5H5LQ0tiFrAoEQROQmJlEjowd9mRSyo17cFd7Nk54srKCWjtzzz3mjqWRAjfNy7SDJSeUOXNjBlc/Pk/CBLSAkDaDUsoDNYS3twlcBLcQl9SV9em3zZVT1eUWcpPAhM71gOKekS+pAL+9RKolWD1gMt9F5N4Y55yOovMJ3POT008yr6xxys0lMo0NmM5l73nJdr5lpe2gaubHl1dnv/ng9VryKjDCzF3xB2lbKY20onYN/A4zH88FCuHPhzBMAsnVCulSNvdIBg0oIx1GXBnNMk8S33P62FljiK2MTlWWQaS2kMUdIguDULNAzK2Zn4RoT6UypJKy0Jwj4i2baJGcjDH5lXcHjYLyPRzi5aiOQfk/ycPbwuxwkIF3Cp0skZcgTq83jcLHfP7zx7k/kHj6dfvYXafp99ev79j44wTpx68vMNX8FRtnpt6DtT3AAAdYcscG5UTKtBK/wE1iJzYvF0bkTkd/m/sUS0cwNVCOgoT4MyRdBcLegWcBXQKlihpnvSiyPWHZNYHLtQz1Gg8J2SKwl4VT06iJuxpJTfLClBqwi8DG5pBzziqtF1QbZL0ZYitUXq7M7F4gA9ZyURHM4UKnnkvcvD+qGrDOqkPrg18pIhFWA362gUwUGcYMzCblH++35LlID5DoMtaWRr+gXo47Rsh2levA8UXtc/yMDaqe5A9/IjipaC6DDoAbWEjVU2Yk6UgQYJzaZ6B9LJLuckdzxovymSA07+4Rau2Il3zTasB+XSPrzBSyJ/2gDHTGmWDwWId7ASxJaKTfFnhMBub5BijCPAxJIWFku/bMAwlNzhHNdU6VSe0RChGzWp3XZ265OqT86hgSzXxUrGHKAMpcf8sw2SBQgtCno7qFM1ehViKTxt2jbiYaB3tSnORL7FTAJmH3gtZuRHcaehuYarEwVkZb4Vnzi3f9JS8Y1SSJuOm9ssowOwj35nr94ms9AqwQxLIHc2/YkLnM7qxlL6aUu04HaAaKRKCT8VVEnnEPjtNN33bMEywUi7S8bzsh94MYPAuMACyZVJiNoMDaG80mg1HkyagSYAVwcxgwzJ5VXQ1GfSiQKjqwHpRySQdKrfUKGUDEPeRRNBbSHPnAN0gs5mBNxw2gXHtnfLV3RkewpyEDsjF3E3PfIqJYJpFkItvRD5VRkougPwi2ak7UnRPdzHUmdxjJSaYAuXsZ9QEG1XCQACK3f/caU8cWJ4Ata1D1+RmH5PPrg6/vN0a8Fvqjro1lz/CWrZUJLGoYFeK6aicSidhuapBebrAKYn74lrZaINbGAkCxz/ADGqFOFDG2GXF2AliCcq9oyEmc0Cow8DN8vDNof8RwJccCeWaUFaSMmgf9gidEaV+PzqYA0GsWsRc7ytSoWbGV1oGazWMGPkNRcOwu1pThTV6/oAqZmsMnVoYk1DmNMUnqUcYOJWDqx/A/km4TV5wMQmjBiZB6V7NhdFLgXuTDqfmXU7zO4OR6EPXwzaYahJN51zz5AmJzHdFNJgIVPMNK/PgqTkgMoIISwg/3xOZ1KbwBRPxQwffHZ97kXwGewswEJdNAHD036b65yzB1+EovAvmXIcXEC8YNzAars5jB1ImCYQEKfloe/KcOXBow+PxxZ9KOMGk9Rpl8DMOJ0jj/4fw7fDlaCfnl+N8e7r47+9+evGd1azYZfPPIPwYeoYKkWBwR8vq+ZL6WkvtRSxFShPcqMHkNEf8AT/j1PSlMxFzHRlJ4iJ6yczjO94veT1kCg5SWJ6mJ8SRIkqoKAWN5BMzCijpBcOPFmowAFjnHdhqmOsH9XKHIK8EqqAtR1YloQ4wAggCAPl3wkpGldkZBY3dBHBp6+kOBZSjngNnqWoILCEs5qyn7dBCknAPwheCwcaRHhI2ZcKh9SsFjHHyyfaGvukqoS7KG7LNRkRG4sHjQqxEhHTHl/M0RQYG/BuZGwyWjYPBN655qckiMd4Evcx5rrhvKAD8ipwApITMO81Tw/TcE9DqyiIue4pka3sU/DFAajapGIwjRKZQeIsDWOSsYjzm7CwvE+TkVimZDI3cU0IPhYOqoWBy/BAeFDcoi8Bsuq43ZSKDuBDxBSBPKg8E5YAJwmPuRtjEU9R7BvS47Vn6P3e5Pwf2vEnIt/Cwm2VeR10WDIWIQvRUHLeeEdAIARq8YFt6SCSWJjmRpcGP1ugMyv0D4HhVtQfFAJwfBT0GyN4kwXXCRvXwmJdMJKF4Nz2Ddk1nc0cGUndbOCTYymSqgPWSA/BiRxMKWfYhagxcBYLj2EfMbW8aZwTY8DJPsKsIL0YlPhbtl0QMiXa6yS24hiYpJP1JNAy5GA2yJH5h6+ceYtCKnY7gjeecbhBpmLQ80uhQtNIjg8DALOl+3is7gI3VuJvYN1ER7kZfXGCieGHlMObSzkZlL5eaxiFII1Kp8ZpeJYAq5QOBG28Pp3C25h8Y8XrJ+U+QGsMH9G82J0F4gLbW2UcNHSrzHhc5uEDLDz8SqSJJzuQn7UjcZtRgRkyjJutX0pX76kzIee4yjmtJZ6KkcD0w5uQ/5gUfBEgCi17jRtSGfnTX5gxJgjpK8nZUV+LBLlhU1wrLaX4QVDPA5n03eIHL741WJZrmDOt5S2wSGGoXXmL3WGtYiKeGmFhnWpMBHoe7RmnUXuP1GUrFIMgpcCsoH7wLuNQq4or6PI67M2EEMX6pzGJ5jExW0N/HMwEs0kB5EaIIAXN3VtNd4mOuFCnmIzlO0Y6KZC0beBwqpHuoCCUu+IwBhCSQ3+o8YEvetLK3LUAdq/MXOaSIpXzT/rqIfkaMEraqGCIgkO3kGCN1xCG+W25Fwj4yWVExEJ8tkAUSRU2BscQmO5CgIaHIDR47f8lTuKw2R/VgflCZoiMBBmc6EWgbZ8Gtq1gRqkSTgrlfY7k4hWUAQEUXKB9+zSnlHniUnEY6k0ZBNErZ8/+q++4D6fOtT/WhTffeelFMU7ZFj7o33DB/18ebbewlbfUhNCkhAc7BQnYyFmjuRMcJz4Ah0PXqyOBJacbastk6zxZzgeHNmqvgHEUAYgbXklWQOmITzT2orgWJUugj9an3BCaVyL+lZiIlxQq0QhIov445enilSA+Sj2BvkngYxq+MXIvnbAiHu6KPZJb36oCSNemUq0m0UNKrf1Pza92YGsLDSpl7hFiag94+ohCQOFXwClR2hnWLVSfArEIMghTIBCQATQw2uIdDzgg9Xlb5E0kKswBzKGJcLXFq2qVa92A0F0fkcfCN95cHhZYRIVhMT5x4xqPui32JWr0TLBJO4Fe4A1bsv3q24hGTsIAVgFylEgozvG7lvIFU9hi6gjQ0n27SASiSHOu8ziLyP5nBGw2g7DF9iPKQiVSq5DyhE5kErf6LxPFDLYI8KkGJOFTirI3AV+Jp7ht1J9zydlzTaSKQwz2beYSeU6X66X4U5r2vVSqgk3B9lktpB8RglqwB0Ik8moY8IPKQ54ThmWXOM3i6g5lOm4powDS8iuXUCSMIRQT0lM/AKLSbHtBIE2VWogCRQ4eEt4hLJAabhUBYB6CNyodWIo2QOlhcNPt6Wqerq12GetIbjVBEU2BtUIBW9en5H5umg3AHdEAm+lkRykXzFskQ1e7g6OohbgON1R/JXmOn4b9X9b8Xt/rS63wqZq5fGDM4DOMGnTfKTab6u2UbUnrMA8LjVmGM6d62eSrFyVZQAmK87v/UqJIsrUgQteG2CqF7atDnYG11CiV/cydZKMyUDT17saYxVzW0lt0w9eVwWaq5akduERxcukimF5IpjkneB3qci9cQDw7jVKm9Pffei1kqknEDSfq7WqgzLr9aEVhZTQVLmGR0j4zpkvLwZjojijer1w94dUukwpagFvQWCAMKNxFPHiRtYECt5mqHctgC2LjZGd8rXYiKl1BK2BgDKD2iRv7sAAS30Bf8NSi8hbst+ShOBQnnv7irY8gonJBvJOcwGGb7RHJPfBgqUOoAqWw0duqZ0UXvwIoWCt6M20bIHMRqf1cW5Nhl4c2WIpdapBQ3UUZeewVAsYoiWRwmClM3fp5OCnnsEIVLvanl1J/lrL+UyNsUmA5SwoKBBHyurcYZU4BCyXuIue3E+N4csuocECJIWQ22fTS51Tk3ddLX/yrOQEVBEEW0km4LOUOvwhlHIT2xsZZ5iUAxAsjQhD2doF+QTDiYB38dgTjIHsqeIEVNkKGKlFCXTQfwFICDMBsIu0j4cLESDJbCiXF+bVZK6faTCkHHTEuVhJp6WW6Um1PxHdg0G7mcXrZ+IjeL2hJsTDDUH2mlNVM0xwow9o96VMJvrt9EB7GSGFoK5o6/SI0mpApYIctEMhAC1V1zR2soAAyucT8Kj6qItvpUwNpl4IsC0UMJl1ccBfaN95zbcP9iQT3aEML+Mh+zIhxn58a57e5vDYYyvlY44wpLCeE8vFEsoWQ+2kfvyFRDT8Ts+33M/f1GxpIKHWovXd1IQYt52AUOGSzWvldW0CAmcwXcBDV6LGmIbh//cEaCltqBNuCZ18odvoJka16eEB7/KfXq8YK/EFd+KPizVZwBC1RAmXqStY4An0qObvEFGrtzM3UHk2GVuwGIEi2Cwg7LjavBWxHB2sFtG9mgF4DoEIN/vlCAFixFFPOR1Pfr0WULHlFyE5+OI8KDSx4hYEuY+hLXje2DcR4RgTw7cETXlJYZK6yGQgQT7En/YJQMjAsCNPd7P6gJi2KA7ihrwp1aAmSdBphADqk0jE9Mgldaf7AEuqiKOBr3BQxJU7nqhVVbjDBHgNEL0kFhTmmdqFXepUwoXUBUb0jzqtAxIFkcY44MEFQU0qWXYuel0dlxvaKcsDAUfsQp5zNHq0oaevtPKhq6K2k7TGAJjq166Ri1KnE9ORUsD6ptrgaWXwzSVPbSkiYD0+DZGRnoQ4OJVZQT5ATP1hbvyDQYnMupPEuu1YnXMF4zXJLFq1HoxZ+9aKNVwKMsJYS8SIEYLN2ER0EwetpyMiQkDH7oand1BE6PE2ijdiGMF20lixOTWSu71YDu5SIFEND9Xa0ldGmRyRxgyCmSdz9xhcSiBtjtuWUuqUC1jWiTltYIRUa0kXBn2TwJP0gdwMQkLxQFPA3shoMh1B5pECadOFiNlPT5rNfRR0GrTzP+8jvfTq/v0Rq7PasSqE85nrgB3Ixm/fZeYa4kFJIfuR1cDoUhOrgwJWWUOgZMivtZqNmiu3TG4gs4hkAMqAbEVVIJUsXaNyK7DCO5n71FM1jVy5Uv8G5a+CAO2zBcO0GODSYhnd57u33AW0tbM1jLHYZ4chVbJ6J7XlLAl63ARoj6UA6NeEyoq2kESiEfVqiFFnycFoaWs/mytsmeNGuLXMh25Dw1praNqW9Gons+gq6OGZMAakjSzBa81dDxnTNppiVAewcU4uHlgdcrEDjW2J+iGQGc24O8etAyljZYJSioaYZgeugIBD/4Hi/REyv0UQ+2xAS21j6AzlXK5aS3EnRDFDBMGzEurESqrQ77rxDszQ2Wyl0FUKCxPrWgyHybnNBEhASRoJXBjAwrJiA231ZlrNeEnaYiwsHabkoBaM8T61lsHOYd2RFih+NUoiCYPACpqWcIj1LBKEgNJWx6wXwUGlbmSUZiug+Ln1QSAoike8fz11AG1C8grIdt9TChOiFpNWfXiZ5uza73qpBF9v27dZ2EHkQZgMId1G8M7tYFMW6vU8DIgpr2eZFDn7tW+1TaEoarcSfSNakBng/LkPYSd5VCaah8x4JmcR5zgYfif8HC7iXA+aq4zUFTLWDVKR4SznFQd2gc0HNqYJVVDcAPZCOwWBHrgtXrTqtmKET+OdGFoOMy8L05NWXHjclydEM7iiW/fbcJg3IuvSxQHBjNCNKdWtBNKxWbX6oCXkYJNSJnNTVIi3qGq1Gt4ratpjRopWVtXm+5mrWIihhdIiSSEFOxYGjPoFAAXlrldiLkLj6I2jQTeSZqIv0Ggz8Dj/h55HuBJ5C6kpZwk+CCKa9qlRmlNzPHWr1QRiIBPCZoSbTEiDKBO+uqT8A6tBbhVHJcd/mJr2i3iB0aaSIZJdQBD6tqBLVCAqR91uiCCrxdmjEIPhthBJAzij/93pPEsEA01CZgnCHmixO0WbOmRsj0Xf6YtA9oPp+YUQPFw3Onap2disgnUGpiJuNQ+CpDtQb8h56fNk8/GBTT4ZkwT60bdatkMxkXdFJFSPL7zK7jktLBmjBHaBAQ3JwEGSUTSsFf1vpYcHhl5qeMkmBhH3Q/8LPoPDbHaS7GNXyXoEOWKwg4pgxhHOx6p9qR1Rd0mzI/+vajmMad8JEFysg2yadUfpizntE3LCEkyijpFQ46rLs+YGg1zkLM6m0fbIrPhMi+eYrTtEAei5Gc+NM/P68ob5YiSW3eTDuXEo27xjdo6oU4i1s0v2aZneiMY7XibsDEfmCT8NceiEboah+FpRgDJDeQYiwtvKQgTyoGPmFn1wG6G+qgWFzFZJCEjkEpcoEORLiVKxKZJbWqLViaQPeKFPZeS8Iot8AsTwFGdCE087SF7zpTFF4n2KXm7YF18u5e+R0p0Cj5iYYFa5v6CQVErt4jhqz1haK/rwOWdiEKSNcFTUzxdu57mAoKE2Pi2yc0bVKaFisT8kEERRE07i5HQREV4FKBK1PiSY9+gA5dO2p2QkY/tyhDDxdocBNoZ9AzMoK21lw3CPeK6iIxB+nnEH5oL4CtLrSBMLHDppXnI7R20e3RLKSR0pswfKd6O1cdLyDF7yQ8ye9+nXwIKalUIodpgAe2mO9wwt5QWpbDVf2PkFL42+l8tz2EQqvD42Z6S3NaK0H/YqVFTxv1Fp0auEQIhMCkfuT/yglILxwIECYEXmX6s89bmlv5lTWggFmqeBCcq26+aM+gt2UxsghqI4Kr0EaFi5vCp87ws68MCAhxi08sLB5jN0rVFAl2hZqThiCGHCSKjSbQs0px61U+PBvosHg9FrgAjXbg0n2cMpnbzEsMhKbOxyRx6Nmlai/o8WW2XfZx2k0lxa5dTJRDq0a6AmkHlIfovvm9sbR7DXpjMR8WLrzV1N2OXQBlq52hx6B8LQVaJT9uS1OYCQ31cblpbDgDoL4EbHv3KaOdh8kguBEdwAVfI1cfALXVN9hld5mHDcEO7gshypGSjyBBGWh1Ds6UFOWlTxj4bH4A4nK5N0z41PArSSx0TLdpLIhRtvRLMKoL52YelBi+FgVrL2rvj1V7FbahH7R0cs/JS272BMwAacrOhpgDRLDGFSgBfqjaxRRCqqL77y1ir87eBSfgNYNOOboQEZYE20QZwpJB2swQF6kgC4vQ4p4CRYqJIE0jJpdGCsOCbFbnRoYXRHDVzj/hHjD92n9oqBHkACdo7wq0kNWmb3NLOz1olPqkb9eljmFx1DYddJM9WwzVOD4chKJquIL0P66vpoPa0MV7mkKgVxD5GF4IleePkEKp7N6cDFfWsHm1CqSNkkIzawPasyyVBTpLS0epT0lor8g5iFgYKkqkJDOZ2OpAZDlgzkNj6093WCiFJqMKZAZm0D2wCgZqEpiThilrd7uqCbPnPbmS21AJfWlG7pZL22Yg9ukYxADjIC78OzGqr9WvDYPjm1f3mg++2NFKs376rPbnRfQEN2MO+AgmhsSYvkXCgnfsDLcDOJba47wrOfZV0eOkeQgWhuDizt+AsjCsSW3ugD+r66U0FLSpiwoj9gGq6d2pNqREI2WR1+HQ3GOlh8K7XRoh7w1axgJSy53DX0qMAajPtk/doqhYSckRxulGXAI5suiAWdGLSBWdaBrUJ/vIvrfeFGARJ3AZViyuaasetlLo7KLlKzaaQpRlDk8CfSk+ENnnU1SwgaU5lZDjVM+5+NVYDUgAAhoBJBYwfckHDx16NOlYZzCboFZHNVEvSAlST1NayK4bN+DHBqoWAkKZkmtr2EKDDGsy8FvEuG4oGlhbIFQJWL18KAFUijmsQCOjAwalNX7VbGmoDIVBFSbsj3KjahxrVFSOu0TM4mKLjGhcVZQOxWSIlp30Z2jvcJJ61R7Vi8fIhp4K2pWRnKARQJ8BFWu3Z8uRajCE0qgLtmVXjXetl0d+qpF9PqytblrLAkeoJlYanVa0hxZjTKwyZFvRUCAKUOVZ3EiGLYhraRx0raH8fe41xxVuPM6TXqXo9nIMPVo/8td/jb1mbl4ei3ef10/e3/4m5K/gwAuIGgWH3jByZieAmeiaiZr35g5Xjy8xaqmqEriYvjWXbavB9djXg+DV5QtnamefRqihkArQcP2/qICGcgLNF1VyJuISLI44dlm8ZA1e3No6TRCTDUjOqBRTA4UTa1X8TcLifJjSVEu6WQ/HqR+F4llpQZ23eHo860DYR2WAmVwaTN9CJLmkrVk2IMhKHooiy7PGspV08MNlY+fFGEBIgO3CsQKIJCywH8Fu7Cakr76b28nQSwmvNPQViLmTVWsJrCfJ3oZvaN3GbOila1nVZ2xm101YPheC3SX896YcVn2qaLeG/jAB1AB9WKSNUhlYLZbqvdhUwx7U6pIe2CpH5b9tbUYxWGCJKvZZ8Br+YFh6D1dfDsagYJPOzdp/gC5ia4wv6SM+Qag+mrGfU7kgAbqglfYj8CSgsqmNxQ7dQfkzRs7oK21FxWssaLQOLTg0j6B25j9tdA5AkBrq+mQABqaMlbbXKfR1a6Xo5lCCLknCvR1IS5YVgRwUh3RPyzXLLUgAo88ctFZJBD9g2PUB5DjheEO4yazAXMFeDVBckjRqF1y7KoxErvDEFiE1kzNou5w3kp26nHlvb2tHl1XvByWIyTa0aOD1LWiJyp8NXBuYWjaOtc9qLkZl7PcsV2rOi4rWdFTUvIUBKZTTg0vOZQY0aJlt9WQSV09MTPqP0tUVchSOMUQf2eXYLEaTdIEmLaeB203Nn2Gk9o4BLB7PkoAvZw2QvTHPIaojjkALsCUFa0QbRgZ2xoeV+5kZdaqoULUeSMf23p9DbxShpa2zHHOtJMgWiyW3mSQlobThCPtAuSIfxZvrWfHYya9pwN6CsL2r2IzhGPbJBruy/7Kh818jlPfcv3ZRGdBLDAiik9DqzoW03GOClJ7Of+sCu1uyIKepv/CIcqnrnB1H89EeY6ykdlyO1jhfIxF97GZG9Qa2Wa+6ISXeH5Sss0tXMpGi03ZgChm7Vqchk6y9ebIyHTEkehIJtipbAPF40U/do97TIIgpKPb3xcKmeGtS8q8v7JO7VPrUOHCFuq7ZvUHpObVMtmqAUjAy9oWp3lB4lw+LAkKQlRMk/FcBnm7VaCzWEqEYAkkN7l4wT7UtKLkFvBLYLDOyTMeNeW5YoZkDoRI/60OMR0jT4tt6pcSIJqFAQ2oZxhmOEA7BTbuvJgIKYe3sKCymbY8JOS1Rz4137rwR6elp9FIbefLnAGRO/CT+FhxwhUJiBRdzxznoCV88aYeTs6CkI3isNE0IJHLQG9szj4tW5IGAqJMIfDjfc8GRKFngKnEJrQzTcJj5dXYFbQBmt7wCz2iJDgj2boeS0tMPlaT06jAKln2U4EAHgYtxJu37JZfWjupd1msLpJoNJKqHQTCtJDd4lybXxFkXtIMz9xEjr0hU3C77GPShGlEsukE5Sf1Db2x9reBi5aZVMywjPs21YKW7FcSCiZfZa9cjdUncFFcVNNzXb99KKKQNEBuihsrY4mlqQ7w16dKLA77Bpva5KWt9CWXntYcK77YCczNrLry3xuDX8rR4fkGUkftDHdzXt/qR9+ifdU/drwQ/M5Tfv/QPKMGfH4QFkxP3zQMQSDpfzWhi7KN+hFphG9fiUyRzLZBERPbHVtUtVD2xJMDn1OPQIsTIWqfz+eBrUBk+adqvGpgrFhFCcmUSkjrYv+Z7y2tILxcHE7nvT9IevP3ko97Ndej3FGPNLAn5CuU9fl2d3/wsOMMLZjj4KbgAAAYRpQ0NQSUNDIHByb2ZpbGUAAHicfZE9SMNAHMVfU6V+VBzsINIhQ3WyIFXEUatQhAqhVmjVweTSL2jSkKS4OAquBQc/FqsOLs66OrgKguAHiKOTk6KLlPi/pNAi1oPjfry797h7Bwj1MtOsrglA020zlYiLmeyqGHhFEGH0oh8xmVnGnCQl0XF83cPH17soz+p87s8xoOYsBvhE4llmmDbxBvH0pm1w3icOsaKsEp8Tj5t0QeJHrisev3EuuCzwzJCZTs0Th4jFQhsrbcyKpkY8RRxRNZ3yhYzHKuctzlq5ypr35C8M5vSVZa7TDCOBRSxBgggFVZRQho0orTopFlK0H+/gH3H9ErkUcpXAyLGACjTIrh/8D353a+UnY15SMA50vzjOxygQ2AUaNcf5Pnacxgngfwau9Ja/UgdmPkmvtbTIETC4DVxctzRlD7jcAYafDNmUXclPU8jngfcz+qYsMHQL9K15vTX3cfoApKmr5A1wcAiMFSh7vcO7e9p7+/dMs78fgiVyrXlWzPEAABCLaVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/Pgo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJYTVAgQ29yZSA0LjQuMC1FeGl2MiI+CiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPgogIDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiCiAgICB4bWxuczppcHRjRXh0PSJodHRwOi8vaXB0Yy5vcmcvc3RkL0lwdGM0eG1wRXh0LzIwMDgtMDItMjkvIgogICAgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iCiAgICB4bWxuczpzdEV2dD0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL3NUeXBlL1Jlc291cmNlRXZlbnQjIgogICAgeG1sbnM6cGx1cz0iaHR0cDovL25zLnVzZXBsdXMub3JnL2xkZi94bXAvMS4wLyIKICAgIHhtbG5zOkdJTVA9Imh0dHA6Ly93d3cuZ2ltcC5vcmcveG1wLyIKICAgIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIKICAgIHhtbG5zOmV4aWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20vZXhpZi8xLjAvIgogICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iCiAgICB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iCiAgIHhtcE1NOkRvY3VtZW50SUQ9ImdpbXA6ZG9jaWQ6Z2ltcDpiN2RiM2E3Yy1mYzQzLTQ0ZDEtYWJlYS0zMGU2MDI4MGYwNWMiCiAgIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ZGI5NWJlNTQtYzk0ZC00YmZmLTg3ZTEtOTZkODdkMjYwOGQ3IgogICB4bXBNTTpPcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6MDZlMTU2MmEtYWNiNS00MDM2LWE3YzgtMzU0OTM3NGU4NmNhIgogICBHSU1QOkFQST0iMi4wIgogICBHSU1QOlBsYXRmb3JtPSJNYWMgT1MiCiAgIEdJTVA6VGltZVN0YW1wPSIxNjcyMjE4NzczMzg5MDU2IgogICBHSU1QOlZlcnNpb249IjIuMTAuMjIiCiAgIGRjOkZvcm1hdD0iaW1hZ2UvcG5nIgogICBleGlmOlBpeGVsWERpbWVuc2lvbj0iODAyIgogICBleGlmOlBpeGVsWURpbWVuc2lvbj0iNzcwIgogICB0aWZmOk9yaWVudGF0aW9uPSIxIgogICB4bXA6Q3JlYXRvclRvb2w9IkdJTVAgMi4xMCI+CiAgIDxpcHRjRXh0OkxvY2F0aW9uQ3JlYXRlZD4KICAgIDxyZGY6QmFnLz4KICAgPC9pcHRjRXh0OkxvY2F0aW9uQ3JlYXRlZD4KICAgPGlwdGNFeHQ6TG9jYXRpb25TaG93bj4KICAgIDxyZGY6QmFnLz4KICAgPC9pcHRjRXh0OkxvY2F0aW9uU2hvd24+CiAgIDxpcHRjRXh0OkFydHdvcmtPck9iamVjdD4KICAgIDxyZGY6QmFnLz4KICAgPC9pcHRjRXh0OkFydHdvcmtPck9iamVjdD4KICAgPGlwdGNFeHQ6UmVnaXN0cnlJZD4KICAgIDxyZGY6QmFnLz4KICAgPC9pcHRjRXh0OlJlZ2lzdHJ5SWQ+CiAgIDx4bXBNTTpIaXN0b3J5PgogICAgPHJkZjpTZXE+CiAgICAgPHJkZjpsaQogICAgICBzdEV2dDphY3Rpb249InNhdmVkIgogICAgICBzdEV2dDpjaGFuZ2VkPSIvIgogICAgICBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOjI3ZDU2NjZhLWVmMDMtNGI1NC04NDliLWEwYmFiMDg5NGI1MCIKICAgICAgc3RFdnQ6c29mdHdhcmVBZ2VudD0iR2ltcCAyLjEwIChNYWMgT1MpIgogICAgICBzdEV2dDp3aGVuPSIyMDIyLTEyLTI4VDEwOjEyOjUzKzAxOjAwIi8+CiAgICA8L3JkZjpTZXE+CiAgIDwveG1wTU06SGlzdG9yeT4KICAgPHBsdXM6SW1hZ2VTdXBwbGllcj4KICAgIDxyZGY6U2VxLz4KICAgPC9wbHVzOkltYWdlU3VwcGxpZXI+CiAgIDxwbHVzOkltYWdlQ3JlYXRvcj4KICAgIDxyZGY6U2VxLz4KICAgPC9wbHVzOkltYWdlQ3JlYXRvcj4KICAgPHBsdXM6Q29weXJpZ2h0T3duZXI+CiAgICA8cmRmOlNlcS8+CiAgIDwvcGx1czpDb3B5cmlnaHRPd25lcj4KICAgPHBsdXM6TGljZW5zb3I+CiAgICA8cmRmOlNlcS8+CiAgIDwvcGx1czpMaWNlbnNvcj4KICAgPGV4aWY6VXNlckNvbW1lbnQ+CiAgICA8cmRmOkFsdD4KICAgICA8cmRmOmxpIHhtbDpsYW5nPSJ4LWRlZmF1bHQiPlNjcmVlbnNob3Q8L3JkZjpsaT4KICAgIDwvcmRmOkFsdD4KICAgPC9leGlmOlVzZXJDb21tZW50PgogIDwvcmRmOkRlc2NyaXB0aW9uPgogPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgIAo8P3hwYWNrZXQgZW5kPSJ3Ij8+HlQazAAAAAZiS0dEAP8A/wD/oL2nkwAAAAlwSFlzAAAWJQAAFiUBSVIk8AAAAAd0SU1FB+YMHAkMNSYh57kAACAASURBVHja7N15dFT1/f/x570zk3WyEbKQkJCwBZIAsgiyKIu0uCEFFxBXKmW1COoXqBYVa1u1Ki6UXaigooLggv3VCggosoiUsAQSErIQSMgesk5m5t7fH+lME7KQhABB3o9zciCZe2fu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8g05lzqzYXFxMefOnWswpJYtW8aCBQvQNI29e/fy1ltvOR+32Wy8//77LFy4EE9PT1JTU5k6dSrbtm1zTi61atUqXn/9dfz9/UlOTmbKlCkcOXIETdNYt24d8+fPR9d1Tp06xYwZM/juu+9kalshWpm4uDgee+wxHn74YefPggULnBPWLV++nMWLF/PNN98QHx/P3//+d/7+9783eBFbXefOnXF3d2f+/Pm88847PP/885SWll5CSeQ6SPXPPvsMVVUZMWJEq73yTk1N5dNPP2XBggWMGjUKTdOIjIzk008/BapmVly1ahWLFi1i4MCB2O122rVrx1tvvcWAAQNITk7m448/ZunSpfTs2ROr1Yrdbufrr7+mW7dufP3114wePZrp06c7J+tKTk5m+PDhUhoRopVUQQ0ZMoRNmzbVeswx66jBYKBbt25omlZrllQPD49GTY8bGhrKypUr2bVrF35+frzxxhucOXPGOd9Rk+cTuR7YbDY2btyIqqoMGzasVZ40MzMzMRqNziomg8FAp06dajzu6+tLv379nLMWDhgwgNWrV5Oenk5ubi6+vr5ER0ejqiqurq7MmTMHi8WC0Wjk9ttvZ82aNfj7+9OrVy8mTpyIl5eXBIgQrShEoqOjiY6OrncZDw8Phg8f3uDz3HzzzTV+b9euHe3atavxOrGxsURHRzvbVjt37ux8XJUAqZvVamXz5s2kpaW1yu2z2+0YjcY6u+Dpuk5lZaXzasTB1dUVXdcpKyujrKys1uP+/v7O9qBJkybxxhtvkJ2dzcKFC5k0aRLHjx+X6iwhrlOqqtZZ4JA2kXqYTCbGjh3baqeoNZvNlJeXk56eXiP4HFcO/v7+FBYWkpubW6N0AhAQEICfnx+FhYXOxnhd1zl69Cj79++nqKiIPXv20LFjR5577jnWr1+Pn58f7733XosP3iaEuMbDRXZBbUajkXHjxrXaqiyAbt260alTJ95//30OHz7M3r17WbJkifPx2NhYAgICnPeqHDx4kCVLljB27FjCw8Pp3r07np6erF27luTkZA4ePMj//d//cfbsWVxcXHj33XdZs2YNx48fJz09HVVVcXd3l6pPIUTN86XsgtpFtnvuuYeRI0deUoBc7mofT09Pnn/+ef70pz/x1FNPYTab6dGjB8nJySiKgp+fH6+88gqvv/46s2bNwm63c8sttzB1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)"
      ],
      "metadata": {
        "id": "YMCXxoX4-uVp"
      }
    },
    {
      "cell_type": "markdown",
      "source": [
        "If you use your mouse pointer on the \"hacktribe\" folder, you will notice three small vertical dots appearing right to it. Clicking on those dots brings you a context menu you will need to upload your  ```.e2sallpat``` file with the firmware later on.  \n",
        "\n",
        "**What to do next:** Prepare our virtual machine to run the Hacktribe scripts. \n",
        "\n",
        "## Step 3: Prepare this Notebook for running the code. \n",
        "\n",
        "Once again, just click RUN. "
      ],
      "metadata": {
        "id": "tQZjelT_BXO7"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "# Python libraries you will need to run the scripts\n",
        "!pip install argparse bsdiff4 "
      ],
      "metadata": {
        "id": "sEe2YX7n9G-O"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "The virtual machine might ask you to \"restart the runtime\" - never mind: just click on the small but friendly \"RESTART RUNTIME\" button and move on. \n",
        "\n",
        "**What to do next:** Get the firmware for patching. \n",
        "\n",
        "## Step 4: Download original firmware file from Korg. \n",
        "\n",
        "When you click RUN, the book gets the ```SYSTEM.VSB``` file containing Korg's most recent V2.02 firmware. "
      ],
      "metadata": {
        "id": "Q4tMptE7KGbJ"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "# Get Sampler firmware update from Korg server\n",
        "!wget https://cdn.korg.com/us/support/download/files/0b87bcd3112fbb8c0ad7b0f55e618837.zip\n",
        "# Unpack and copy to our Hacktribe directory\n",
        "!unzip -o \"0b87bcd3112fbb8c0ad7b0f55e618837.zip\"\n",
        "!cp /content/electribe_sampler_system_v202/SYSTEM.VSB /content/hacktribe/SYSTEM.VSB"
      ],
      "metadata": {
        "id": "oPYnLP-_-VYl"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "**What you have just done:** Made the virtual machine download and unpack the original Sampler firmware. (If you look at the folders to the left and click the \"Reload\" ![Bildschirm­foto 2022-12-28 um 11.08.21.png](data:image/png;base64,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)symbol - the small folder with a circular arrow - you will see the SYSTEM.VSB sitting on the bottom of your hacktribe folder.\n",
        "\n",
        "**What's next: Patch the firmware.** Use the Notebook to read the SYSTEM.VSB file and create the HackTribe firmware file from it. \n",
        "\n",
        "## Step 5: Creating the HackTribe firmware file\n",
        "\n",
        "Click RUN, and get a new firmware file called ```hacked-SYSTEM.VSB``` for you to download to your E2S. "
      ],
      "metadata": {
        "id": "qmmVrjEWH8YJ"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "import os\n",
        "\n",
        "# Use Python to change directory, otherwise the script won't find it\n",
        "os.chdir(\"/content/hacktribe\")\n",
        "# Execute patch script\n",
        "!python scripts/e2-firmware-patch.py\n",
        "# Copy patched firmware to a new folder for download\n",
        "!mkdir /content/hacktribe-output\n",
        "!cp /content/hacktribe/hacked-SYSTEM.VSB /content/hacktribe-output/SYSTEM.VSB\n",
        "\n",
        "# Download the SYSTEM.VSB file to computer's download directory\n",
        "from google.colab import files\n",
        "files.download(\"/content/hacktribe-output/SYSTEM.VSB\")\n"
      ],
      "metadata": {
        "id": "krLwF1lAJ3_g"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "**What you have just done:** You told your virtual machine to run bangcorrupt's Python script that creates a patched version of the firmware, and downloaded it as SYSTEM.VSB to the download folder of your computer. \n",
        "\n",
        "### *IT'S YOUR TURN: Copy that file to ```KORG/electribe sampler/System/SYSTEM.VSB```*\n",
        "\n",
        "This is where the Electribe's standard firmware will go looking for updates. (If you already had a copy of SYSTEM.VSB in your computer's download folder, it may have been renamed to SYSTEM(1).VSB or something like that; please be sure that the file on the SD card is really named ```SYSTEM.VSB```.)\n",
        "\n",
        "You could now take that SD card, insert it in your RedTribe, and select FIRMWARE UPDATE from the DATA UTILS menu. But hang on a bit longer - let's prepare additional data. \n",
        "\n",
        "**What's next:** Create a version of the factory samples to work with the HackTribe. \n",
        "\n",
        "## Step 6: Transform your existing material to work with the Hacktribe\n",
        "\n",
        "In the factory version of a RedTribe, oscillators 1-18 are the base synthesizer models, and oscillators from 19-421  are the factory samples. In the Hacktribe, oscillators from 19-274 are the extended synth models: Multiwave, Crossmod (FM), and VPM models in lots of variations; the factory sample memory may no longer be used for, well, samples. But there is still the user memory.\n",
        "\n",
        "The factory samples have to move - the Hacktribe firmware can cope with anything that is loaded to the user sample slots 501-999. \n",
        "\n",
        "We will run a script that **moves the factory samples from 19-421 to the user sample slots 519-921** (leaving the first 18 slots unused/for user samples, but making it easier to look the samples up), and **fills the remaining sample slots** with as much user samples as possible or necessary. \n",
        "\n",
        "Hold on, there's a problem: Your old patterns and parts don't know about this. They still go looking for the HIPPY kick drum as oscillator 019, not as It would be a hassle if you had to change all your existing patterns. The script does that for you: It modifies your all-pattern dump to **change all the parts in all the patterns to work with the new sample locations**. \n",
        "\n",
        "Before we can do that, we will have to get the sample and patch data from your Electribe - remember that you exported it to the SD card before we started. \n",
        "\n",
        "### IT'S YOUR TURN: Upload the files to the Notebook.\n",
        "\n",
        "Click RUN on the next code box and select the ```e2sSample.all``` file from your SD card. \n"
      ],
      "metadata": {
        "id": "vDvX-xLiLWQ0"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "from google.colab import files\n",
        "files.upload()\n",
        "\n",
        "# Move it to hacktribe directory\n",
        "# \"/content/hacktribe/e2sSample.all\"\n",
        "!mv ./e2sSample.all /content/hacktribe-output/e2sSample.all\n",
        "!mv ./es"
      ],
      "metadata": {
        "id": "cIHrhSeyb754"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "Great! Now upload the ```electribe_sampler_allpattern.e2sallpat``` file from your card. "
      ],
      "metadata": {
        "id": "Qv_BjCMbc2wS"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "from google.colab import files\n",
        "files.upload()\n",
        "\n",
        "# Move to hacktribe directory\n",
        "!mv ./electribe_sampler_allpattern.e2sallpat /content/hacktribe/electribe_sampler_allpattern.e2sallpat"
      ],
      "metadata": {
        "id": "mZJAApUOc47L"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "**What you have just done:** You have given the notebook your work files so that it can rework them for you to use them with the Hacktribe. \n",
        "\n",
        "Once again, click RUN on the next code box. "
      ],
      "metadata": {
        "id": "UJcwvv69b9G8"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "# Script processing the sample bank and the pattern bank files for use with the HackTribe. \n",
        "import os\n",
        "os.chdir(\"/content/hacktribe\")\n",
        "# Reorder sample bank and pattern memory, generating two files\n",
        "!python scripts/e2_recode_sample_pat.py -o /content/hacktribe-output\n",
        "\n",
        "# If you want to start with as little sample memory as possible, add \"--minimal\" flag above: \n",
        "#  !python scripts/e2_recode_sample_pat.py --minimal\n"
      ],
      "metadata": {
        "id": "Cd5oPI7mfePv"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "## This Step Is Optional: Generate .WAV files for all samples\n",
        "\n",
        "The last step may have removed samples from your library for the HackTribe - this code generates a directory of individual .WAV files, one for each sample, which you might copy to your SD card and import as needed. \n",
        "\n",
        "WAV files are stored in the ```output``` directory. Unfortunately, Colab does not allow you to download whole folders, so the Notebook creates a ZIP archive file from them for you to download. \n",
        "\n",
        "The files in the ZIP archive look like Windows WAV files - and may be played with VLC or any media player - but they contain a metadata block for the Electribe, so if you edit them, you will lose all metadata - e.g. start, end, and loop points, and the slicing data. Better not edit them."
      ],
      "metadata": {
        "id": "E5rEFjNnoEZt"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "import os\n",
        "\n",
        "# Use Python to change directory, otherwise the script won't find it\n",
        "os.chdir(\"/content/hacktribe\")\n",
        "# Execute script to generate individual .WAV files for each sample in ./output directory\n",
        "!python scripts/e2_sample_all_to_wav.py -o /content/hacktribe-output/wavefiles\n",
        "!zip -r /content/hacktribe-output/wavefiles/ /content/hacktribe-output/wavefiles.zip\n",
        "\n",
        "from google.colab import files\n",
        "files.download(\"/content/hacktribe-output/wavefiles.zip\")"
      ],
      "metadata": {
        "id": "carUmzHQnfCZ"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "**What you have just done:** Created and downloaded an archive of individual WAV sample files for you to import into your Electribe as needed. \n",
        "\n",
        "## Step 7: Copy the new files to your SD card. \n",
        "\n",
        "It's time to download the generated files to the SD card, and convert your Electribe into a HackTribe with it. The files are in the folder ```hacktribe-output``` now; the code box will just download it to the download folder on your system.  "
      ],
      "metadata": {
        "id": "qmn9MCPefeux"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "!mv /content/hacktribe-output/hacktribeSample.all /content/hacktribe-output/e2sSample.all\n",
        "\n",
        "from google.colab import files\n",
        "files.download(\"/content/hacktribe-output/SYSTEM.VSB\")\n",
        "files.download(\"/content/hacktribe-output/e2sSample.all\")\n",
        "files.download(\"/content/hacktribe-output/hacktribe.e2sallpat\")"
      ],
      "metadata": {
        "id": "atKgPYsgddEK"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "### *IT'S YOUR TURN: Copy the files to the SD card - to the right locations. \n",
        "\n",
        "The files are in the download directory of your computer - from there, move or copy them to the SD card: \n",
        "\n",
        "- You have already copied the  ```SYSTEM.VSB``` file to the ```KORG/electribe sampler/``` folder.\n",
        "\n",
        "Now, copy the modified sample and pattern data to the SD card: \n",
        "- For the ```e2sSample.all``` file, you need to create a directory on the SD card called ```KORG/hacktribe/Sample/``` and move it there - the HackTribe firmware will automatically load it from there on boot. \n",
        "- ```hacktribe.e2sallpat``` may live anywhere on your SD card where you can find it - I'd propose to copy it into the ```KORG/hacktribe```  directory.\n",
        "\n",
        "**What you have just done:** Prepared everything for the final step. \n",
        "\n",
        "## Final Step: Install the HackTribe firmware\n",
        "\n",
        "Insert the SD card in your e2s. Navigate to the DATA UTILITY menu and select FIRMWARE UPDATE. (This needs a SYSTEM.VSB file in the ```KORG/electribe sampler/System``` directory.) \n",
        "\n",
        "Take a deep breath. This is customary.\n",
        "\n",
        "Press OK. \n",
        "\n",
        "When rebooting, the screen will show \"HackTribe\" now, and the firmware will start loading the samples automatically. **Congratulations: You succeeded!**\n",
        "\n",
        "### Update patterns\n",
        "\n",
        "* Go to the "
      ],
      "metadata": {
        "id": "OGnTCNqNdcBr"
      }
    },
    {
      "cell_type": "markdown",
      "source": [
        "# Going back to the standard firmware\n",
        "\n",
        "To reverse the hack, take your SD card. There is only one more file you will have to copy: The original ```SYSTEM.VSB``` has to go to the ```KORG/hacktribe/System/``` folder, because this is where the HackTribe firmware will go looking for updates when you select the DATA UTILITY/UPDATE menu. \n",
        "\n",
        "### RUN this code box to download the original firmware once more. "
      ],
      "metadata": {
        "id": "GeGt9yHFBHvb"
      }
    },
    {
      "cell_type": "code",
      "source": [
        "# Do it again, as connection to VM may have been lost\n",
        "# Get Sampler firmware update from Korg server\n",
        "!wget https://cdn.korg.com/us/support/download/files/0b87bcd3112fbb8c0ad7b0f55e618837.zip\n",
        "# Unpack and copy to our Hacktribe directory, overwriting old files\n",
        "!unzip -o \"0b87bcd3112fbb8c0ad7b0f55e618837.zip\"\n",
        "\n",
        "from google.colab import files\n",
        "files.download(\"/content/electribe_sampler_system_v202/SYSTEM.VSB\")\n"
      ],
      "metadata": {
        "id": "AX-wxXDpMHTM"
      },
      "execution_count": null,
      "outputs": []
    },
    {
      "cell_type": "markdown",
      "source": [
        "**What you have just done:** You have downloaded another copy of ```SYSTEM.VSB``` - but this time it does not contain the HackTribe firmware but the original firmware. \n",
        "\n",
        "### *It's your turn: Copy this file to ```KORG/hacktribe/System/SYSTEM.VSB``` on your SD card.*\n",
        "\n",
        "Now, you have got two ```SYSTEM.VSB``` firmware files on your SD card, which is really handy if you wish to switch between a HackTribe and a factory Electribe persona: \n",
        "\n",
        "* The Hacktribe firmware is in the ```KORG/electribe\\ sampler/System/SYSTEM.VSB```file - this is where the original firmware goes looking for updates. \n",
        "* Th original firmware is in the ```KORG/hacktribe/System/SYSTEM.VSB``` file - this is where the HackTribe firmware goes looking for updates. \n",
        "\n",
        "## Insert the SD card and revert the update:\n",
        "\n",
        "* Go to DATA UTILITY, select UPDATE, take the customary deep breath, and press OK. \n",
        "* On rebooting, your Electribe will load your last sample dump from the ```KORG/electribe\\ sampler/Sample/e2sSample.all``` file. These are the samples before that one script moved them. \n",
        "* Go to DATA UTILITY, select IMPORT ALL PATTERNS, and select the ```electribe_sampler_allpattern``` file. \n",
        "\n",
        "Done! "
      ],
      "metadata": {
        "id": "77tvnsfYMfc7"
      }
    }
  ]
}