PYCON_WITH_OP.ipynb

{
 "metadata": {
  "name": "",
  "signature": "sha256:5e6876649a5354a6fa11451b6c77c1905f88ec21927007b15395f250404f6c8b"
 },
 "nbformat": 3,
 "nbformat_minor": 0,
 "worksheets": [
  {
   "cells": [
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Imports\n",
      "from BinPy import *"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 1
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Logic Gates Example - 2 Input / Multi Input Logic Gates\n",
      "\n",
      "BinPy has basic logic gates like AND, OR, XOR, XNOR, NAND and NOR which accepts both numeric inputs as well as connector inputs."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# XOR GATE in BinPy\n",
      "\n",
      "# Create a gate instance\n",
      "xor1 = XOR(1, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1)\n",
      "\n",
      "xor1.output()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 2,
       "text": [
        "0"
       ]
      }
     ],
     "prompt_number": 2
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Using a Connector in BinPy\n",
      "\n",
      "A = Connector(1) # input 1\n",
      "B = Connector(0) # input 2\n",
      "C = Connector()  # output\n",
      "\n",
      "xor1.set_inputs(A, B)  # Overrides previous inputs\n",
      "xor1.set_output(C)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 3
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "C.get_logic() # or use C.state"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 4,
       "text": [
        "1"
       ]
      }
     ],
     "prompt_number": 4
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "A.set_logic(0);\n",
      "C.get_logic()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 5,
       "text": [
        "0"
       ]
      }
     ],
     "prompt_number": 5
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Usage of Bus object in BinPy"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Using Bus in BinPy"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 6
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Initiating the Bus with connectors\n",
      "\n",
      "bit_1 = Connector(0)\n",
      "bit_2 = Connector(1)\n",
      "bit_3 = Connector(0)\n",
      "bit_4 = Connector(0)\n",
      "\n",
      "bus_a = Bus(bit_1, bit_2, bit_3, bit_4)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 7
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Probing the logic of the Bus\n",
      "\n",
      "bus_a.get_logic_all(as_list=False)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 8,
       "text": [
        "'0b0100'"
       ]
      }
     ],
     "prompt_number": 8
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Probing the voltage of the Bus -- The logic states can be represented by a 5v logic\n",
      "# To get another logic family edit the binpy.config file to set the desired logic HIGH and logic LOW parameters\n",
      "\n",
      "bus_a.get_voltage_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 9,
       "text": [
        "[0.0, 5.0, 0.0, 0.0]"
       ]
      }
     ],
     "prompt_number": 9
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Creating another Bus from an existing Bus\n",
      "\n",
      "bus_b = Bus(bus_a)\n",
      "\n",
      "bus_b.get_voltage_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 10,
       "text": [
        "[0.0, 5.0, 0.0, 0.0]"
       ]
      }
     ],
     "prompt_number": 10
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Concatenating the two Bus-es\n",
      "\n",
      "bus_c = bus_a + bus_b\n",
      "\n",
      "bus_c"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 11,
       "text": [
        "[0, 1, 0, 0, 0, 1, 0, 0]"
       ]
      }
     ],
     "prompt_number": 11
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Copying values between buses\n",
      "\n",
      "bus_d = Bus(8) # 8 indicates the length of the Bus. By default all busses will be digital in type\n",
      "\n",
      "print (bus_d)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[None, None, None, None, None, None, None, None]\n"
       ]
      }
     ],
     "prompt_number": 12
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "bus_d.copy_values_from(bus_c)\n",
      "print (bus_d)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[0, 1, 0, 0, 0, 1, 0, 0]\n"
       ]
      }
     ],
     "prompt_number": 13
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Iterating through a bus and setting names ( TAG's ) for connectors\n",
      "i = 7\n",
      "for connector in bus_d:\n",
      "    connector.set_name(\"B\"+str(i))\n",
      "    print ( connector )\n",
      "    i -= 1"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "Connector; Name: B7; Index: 41; State: 0\n",
        "Connector; Name: B6; Index: 42; State: 1\n",
        "Connector; Name: B5; Index: 43; State: 0\n",
        "Connector; Name: B4; Index: 44; State: 0\n",
        "Connector; Name: B3; Index: 45; State: 0\n",
        "Connector; Name: B2; Index: 46; State: 1\n",
        "Connector; Name: B1; Index: 47; State: 0\n",
        "Connector; Name: B0; Index: 48; State: 0\n"
       ]
      }
     ],
     "prompt_number": 14
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Probing the connector tags of each bus\n",
      "    \n",
      "print (\" \".join( [ connector.name for connector in bus_d ]))"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "B7 B6 B5 B4 B3 B2 B1 B0\n"
       ]
      }
     ],
     "prompt_number": 15
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Analog Bus\n",
      "\n",
      "PWR = Bus(Connector(voltage=5.2), Connector(voltage=0))\n",
      "\n",
      "print (PWR)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 16
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Bus is an abstraction over the python lists, so you can do all list operations on it\n",
      "\n",
      "# Slicing Bus-es\n",
      "\n",
      "bus_e = Bus(bus_d[:-4])\n",
      "\n",
      "print (bus_e == bus_b)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "True\n"
       ]
      }
     ],
     "prompt_number": 17
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Circulary rotating the bits of the Bus-es\n",
      "\n",
      "print (\"Before rotation, bus_e : \", bus_e)\n",
      "\n",
      "print (\"After circularly rotating right by 3 positions, bits of bus_e: \", bus_e >> 3) \n",
      "\n",
      "# Note that this returns a list of the Connectors and not a bus object. Use Bus(bus_e>>2) to return a Bus object\n",
      "\n",
      "print (\"After circularly rotating left by 3 positions, bits of bus_e: \", bus_e << 3)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "('Before rotation, bus_e : ', [0, 1, 0, 0])\n",
        "('After circularly rotating right by 3 positions, bits of bus_e: ', [1, 0, 0, 0])\n",
        "('After circularly rotating left by 3 positions, bits of bus_e: ', [0, 0, 1, 0])\n"
       ]
      }
     ],
     "prompt_number": 18
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Linker Module Example \n",
      "\n",
      "BinPy's linker modules stores all the connection in a NetworkX Graph data structure and traverses trought it iteratively in the background to reflect changes to the outputs / inputs of the ports.\n",
      "\n",
      "Simulating the below connection ( drawn using KiCAD ) using BinPy's Linker module.\n",
      "\n",
      "<img src=\"BUS_EX1.png\" />"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Using the linker module to connect two Bus-es\n",
      "CNTRL_V = Bus(4)\n",
      "\n",
      "CNTRL_V.set_voltage_all(5.0,5.0,2.0,2.5)\n",
      "\n",
      "VCC = Bus(Connector(voltage = 5.2), Connector(voltage=0))"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 19
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "SLAVE0, SLAVE1 = Bus(4), Bus(4)\n",
      "\n",
      "SLAVE0.set_type(analog = True)\n",
      "SLAVE1.set_type(analog = True)\n",
      "\n",
      "# Connecting the first two bits of CNTRL_V to the middle two bits of SLAVE0\n",
      "AutoUpdater.add_link(CNTRL_V[:2], SLAVE0[1:-1])\n",
      "\n",
      "# Connecting the last two bits of CNTRL_V to the middle two bits of SLAVE1\n",
      "AutoUpdater.add_link(CNTRL_V[-2:], SLAVE1[1:-1])\n",
      "\n",
      "# Impressing 5v and 0v on the SLAVE0 Bus\n",
      "AutoUpdater.add_link(VCC[0], SLAVE0[0])\n",
      "AutoUpdater.add_link(VCC[1], SLAVE0[-1])\n",
      "\n",
      "# Impressing 5v and 0v on the SLAVE1 Bus\n",
      "AutoUpdater.add_link(VCC[0], SLAVE1[0])\n",
      "AutoUpdater.add_link(VCC[1], SLAVE1[-1])"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 20
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print (SLAVE0.get_voltage_all())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 5.0, 5.0, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 21
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print (SLAVE1.get_voltage_all())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 2.0, 2.5, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 22
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "CNTRL_V.set_voltage_all(5.0, 6.0, 2.0, 1.1)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 23
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# The Slave Bus-es have been updated with the updated voltage in CNTRL_V\n",
      "\n",
      "print (SLAVE0.get_voltage_all())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 5.0, 6.0, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 24
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print (SLAVE1.get_voltage_all())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 2.0, 1.1, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 25
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Unlinking the SLAVE0 from CNTRL_V\n",
      "\n",
      "AutoUpdater.remove_link(SLAVE0[1:-1]) # Only the middle 2 ports are connected to CNTRL_V\n",
      "# VCC is still connected to SLAVE0"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 26
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "CNTRL_V.set_voltage_all(3.0, 2, 1, 6.2)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 27
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# SLAVE0 Retains the last held value\n",
      "\n",
      "print (SLAVE0.get_voltage_all())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 5.0, 6.0, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 28
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# SLAVE1 however is updated\n",
      "\n",
      "print (SLAVE1.get_voltage_all())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[5.2, 1.0, 6.2, 0.0]\n"
       ]
      }
     ],
     "prompt_number": 29
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Change in VCC is reflected to both SLAVE0 and SLAVE1\n",
      "\n",
      "VCC[0].set_voltage(5.5)\n",
      "\n",
      "print (SLAVE0[0].get_voltage())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "5.2\n"
       ]
      }
     ],
     "prompt_number": 30
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print (SLAVE1[0].get_voltage())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "5.5\n"
       ]
      }
     ],
     "prompt_number": 31
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Example to illustrate the usage of bittools"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "`BinPyBits` is a class inheriting from the `bitstring.BitArray` class. It will be used for efficient manipulation / handling of Bit vectors."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "from BinPy import *\n",
      "\n",
      "# Initializing a BinPyBits object\n",
      "\n",
      "bit_vector = BinPyBits(5)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 32
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# By default all BinPyBits objects are not signed\n",
      "\n",
      "bit_vector.signed"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 33,
       "text": [
        "False"
       ]
      }
     ],
     "prompt_number": 33
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Getting the decimal value\n",
      "\n",
      "bit_vector.uint"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 34,
       "text": [
        "5"
       ]
      }
     ],
     "prompt_number": 34
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Getting the binary string\n",
      "\n",
      "bit_vector.bin"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 35,
       "text": [
        "'101'"
       ]
      }
     ],
     "prompt_number": 35
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Do not use int with unsigned BinPyBits objects\n",
      "\n",
      "bit_vector.int"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 36,
       "text": [
        "-3"
       ]
      }
     ],
     "prompt_number": 36
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# This returns -3 since '101' ==> -3 ( 2's Complement representation )\n",
      "\n",
      "# You could use :\n",
      "\n",
      "int_value = bit_vector.int if bit_vector.signed else bit_vector.uint\n",
      "\n",
      "print int_value"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "5\n"
       ]
      }
     ],
     "prompt_number": 37
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Creating a BinPyBits object using binary string\n",
      "\n",
      "bit_vector = BinPyBits('1111', signed=False)\n",
      "\n",
      "# Converting to decimal\n",
      "\n",
      "int_value = bit_vector.int if bit_vector.signed else bit_vector.uint\n",
      "\n",
      "print int_value"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "15\n"
       ]
      }
     ],
     "prompt_number": 38
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Creating a signed BinPyBits\n",
      "\n",
      "bit_vector = BinPyBits('1111', signed=True)\n",
      "\n",
      "# Converting to decimal\n",
      "\n",
      "int_value = bit_vector.int if bit_vector.signed else bit_vector.uint\n",
      "\n",
      "print int_value"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "-1\n"
       ]
      }
     ],
     "prompt_number": 39
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Converting to hex\n",
      "\n",
      "bit_vector.hex"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 40,
       "text": [
        "'f'"
       ]
      }
     ],
     "prompt_number": 40
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Refer [the documentation of bittstring](https://pypi.python.org/pypi/bitstring/3.1.3) to discover additional functionality."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# The speciality of BinPyBits lies in the fact that it can be initialized from various types of inputs\n",
      "# Except for the initialization, the rest of the functionalities remain similar to that of the bitstring.BitArray\n",
      "\n",
      "# Initializing a signed value using - sign\n",
      "\n",
      "bit_vector = BinPyBits('-1111', signed=True)\n",
      "\n",
      "print bit_vector.int"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "-15\n"
       ]
      }
     ],
     "prompt_number": 41
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Multiplication algorithms in BinPy"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "####Roberson's Multiplication algorithm"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "product = robertsons_multiply('111111', '111111', 7)\n",
      "print product"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "00111110000001\n"
       ]
      }
     ],
     "prompt_number": 42
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "to_unsigned_int(product)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 43,
       "text": [
        "3969"
       ]
      }
     ],
     "prompt_number": 43
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "product = robertsons_multiply('111111', '000001', 7, signed=True)\n",
      "print product"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "11111111111111\n"
       ]
      }
     ],
     "prompt_number": 44
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "to_signed_int(product)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 45,
       "text": [
        "-1"
       ]
      }
     ],
     "prompt_number": 45
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "####Booth's Multiplication alogrithm"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "product = booths_multiply('110011', '111001')\n",
      "print product"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "000001011011\n"
       ]
      }
     ],
     "prompt_number": 46
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "to_unsigned_int(product)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 47,
       "text": [
        "91"
       ]
      }
     ],
     "prompt_number": 47
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "product = booths_multiply(bin(-5), bin(-5), signed=True)\n",
      "print product"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "00011001\n"
       ]
      }
     ],
     "prompt_number": 48
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "to_signed_int(product)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 49,
       "text": [
        "25"
       ]
      }
     ],
     "prompt_number": 49
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "####Karatsuba's Multiplication algorithm"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "product = karatsuba_multiply('1010', '1001')\n",
      "print product"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "01011010\n"
       ]
      }
     ],
     "prompt_number": 50
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print  to_unsigned_int(product)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "90\n"
       ]
      }
     ],
     "prompt_number": 51
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "product = karatsuba_multiply('1010', '1001', signed=True) # --6  *  -7  = 42\n",
      "print product"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "00101010\n"
       ]
      }
     ],
     "prompt_number": 52
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print to_unsigned_int(product)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "42\n"
       ]
      }
     ],
     "prompt_number": 53
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### IC's - Using Integrated Circuits in BinPy"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Usage of IC 7400:\n",
      "\n",
      "ic1 = IC_7400()\n",
      "\n",
      "print(ic.__doc__)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "None\n"
       ]
      }
     ],
     "prompt_number": 54
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "ic1.draw_IC()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "\n",
        "              \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25e1\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  1            14  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  2      7     13  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [Z]    \u2500\u2500\u2524  3      4     12  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  4      0     11  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  5      0     10  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [Z]    \u2500\u2500\u2524  6             9  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  7             8  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518  \n"
       ]
      }
     ],
     "prompt_number": 55
    },
    {
     "cell_type": "code",
     "collapsed": true,
     "input": [
      "pin_dict = {1: 1, 2: 0, 4: 0, 5: 0, 7: 0, 9: 1, 10: 1, 12: 0, 13: 0, 14: 1}\n",
      "ic1.set_IC(pin_dict)\n",
      "ic1.run()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 56,
       "text": [
        "{3: 1, 6: 1, 8: 0, 11: 1}"
       ]
      }
     ],
     "prompt_number": 56
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "ic1.draw_IC()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "\n",
        "              \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25e1\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  1            14  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  2      7     13  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  3      4     12  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  4      0     11  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  5      0     10  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  6             9  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  7             8  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518  \n"
       ]
      }
     ],
     "prompt_number": 57
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "alu = IC_74181()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 58
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print alu.__doc__"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "This is a 4-bit Arithmetic Logic Unit which performs 16 diff functions.\n",
        "    It has two modes active high input mode and active low input mode(Active high mode is used here)\n",
        "\n",
        "    Pin Number  Description\n",
        "        1       Input - B0\n",
        "        2       Input - A0\n",
        "        3       Input - Select Line - S3\n",
        "        4       Input - Select Line - S2\n",
        "        5       Input - Select Line - S1\n",
        "        6       Input - Select Line - S0\n",
        "        7       Input - Carry\n",
        "        8       Input - Mode Input(M)\n",
        "        9       Output- F0\n",
        "        10      Output- F1\n",
        "        11      Output- F2\n",
        "        12      Ground\n",
        "        13      Output- F3\n",
        "        14      Output- A=B\n",
        "        15      Output- P\n",
        "        16      Output- NOT(C(n+4))\n",
        "        17      Output- G\n",
        "        18      Input - B3\n",
        "        19      Input - A3\n",
        "        20      Input - B2\n",
        "        21      Input - A2\n",
        "        22      Input - B1\n",
        "        23      Input - A1\n",
        "        24      VCC\n",
        "\n",
        "        Mode and Select Lines are used to select the function to be performed by the ALU on\n",
        "        the two 4-bit input data A3 A2 A1 A0 & B3 B2 B1 B0(Inputs A0-A3 and\n",
        "        B0-B3 have to be complemented and given).\n",
        "    \n"
       ]
      }
     ],
     "prompt_number": 59
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "alu.draw_IC()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "\n",
        "              \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25e1\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  1            24  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  2      7     23  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  3      4     22  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  4      1     21  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  5      8     20  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  6      1     19  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  7            18  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  8            17  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [Z]    \u2500\u2500\u2524  9            16  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [Z]    \u2500\u2500\u2524 10            15  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [Z]    \u2500\u2500\u2524 11            14  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524 12            13  \u251c\u2500\u2500    [Z]    \n",
        "              \u2502                   \u2502\n",
        "              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518  \n"
       ]
      }
     ],
     "prompt_number": 60
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Complementing A Bus and B Bus\n",
      "#_ = [ ( NOT(A[i]).set_output(A_Compl[i]), NOT(B[i]).set_output(B_Compl[i]) ) for i in range(4) ]"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 61
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Input Bus A and B\n",
      "A, B = Bus(4), Bus(4)\n",
      "\n",
      "# Power supply of VCC 5v / GND 0v\n",
      "PWR = Bus(Connector(voltage=0), Connector(voltage=5.0))\n",
      "\n",
      "MOD = 1\n",
      "SEL = list(reversed([1, 1, 1, 0]))\n",
      "CAR = 1"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 62
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "A.set_logic_all('1000') # 8\n",
      "B.set_logic_all('0001') # 1\n",
      "\n",
      "A_ = A.get_logic_all() # I might as well store A_ directly as a list of logic bits ...\n",
      "B_ = B.get_logic_all()\n",
      "\n",
      "alu.set_IC({   1:B_[0],\n",
      "               2:A_[0],\n",
      "               3:SEL[3],\n",
      "               4:SEL[2],\n",
      "               5:SEL[1],\n",
      "               6:SEL[0],\n",
      "               7:CAR,\n",
      "               8:MOD,\n",
      "               12:int(PWR[0]),\n",
      "               18:B_[3],\n",
      "               19:A_[3],\n",
      "               20:B_[2],\n",
      "               21:A_[2],\n",
      "               22:B_[1],\n",
      "               23:A_[1],\n",
      "               24:int(PWR[1])\n",
      "            })\n",
      "\n",
      "alu.run()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 63,
       "text": [
        "{9: 1, 10: 0, 11: 0, 13: 1, 14: 0, 15: 1, 16: 1, 17: 0}"
       ]
      }
     ],
     "prompt_number": 63
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "alu.draw_IC()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "\n",
        "              \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25e1\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  1            24  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  2      7     23  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  3      4     22  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  4      1     21  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  5      8     20  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524  6      1     19  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  7            18  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  8            17  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [1]    \u2500\u2500\u2524  9            16  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524 10            15  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524 11            14  \u251c\u2500\u2500    [0]    \n",
        "              \u2502                   \u2502\n",
        "              \u2502                   \u2502\n",
        "     [0]    \u2500\u2500\u2524 12            13  \u251c\u2500\u2500    [1]    \n",
        "              \u2502                   \u2502\n",
        "              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518  \n"
       ]
      }
     ],
     "prompt_number": 64
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### Verify with the function table of IC74181 ( Taken from google images )\n",
      "\n",
      "<img src=\"ALU74181.gif\" />"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### Combinational circuits"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "####DEMUX"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Initializing the DEMUX class\n",
      "\n",
      "# Must be a single input\n",
      "\n",
      "demux = DEMUX(1)\n",
      "\n",
      "# Put select lines\n",
      "\n",
      "# Select Lines must be power of 2\n",
      "\n",
      "demux.select_lines(0, 1) # a, b\n",
      "\n",
      "# Output of demux\n",
      "\n",
      "print (demux.output())  # D0, D1, D2, D3"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[0, 1, 0, 0]\n"
       ]
      }
     ],
     "prompt_number": 65
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Demux Block ( from google images )\n",
      "<img src=\"DEMUX.gif\" />"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Full Adder - Using Connectors in Combinational blocks"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print(FullAdder.__doc__)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "This Class implements Full Adder, Arithmetic sum of three bits and\n",
        "    return its Sum and Carry\n",
        "    Output: [CARRY, SUM]\n",
        "    Example:\n",
        "        >>> from BinPy import *\n",
        "        >>> fa = FullAdder(0, 1, 1)\n",
        "        >>> fa.output()\n",
        "        [1, 0]\n",
        "    \n"
       ]
      }
     ],
     "prompt_number": 66
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "a, b, ci, s, co = Connector(1), Connector(0), Connector(1), Connector(), Connector()\n",
      "\n",
      "# Initializing full adder using connectors\n",
      "fa = FullAdder(a, b, ci)\n",
      "\n",
      "# Connect outputs\n",
      "fa.set_output(0, co)\n",
      "fa.set_output(1, s)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 67
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print (co.get_logic(), s.get_logic())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "(1, 0)\n"
       ]
      }
     ],
     "prompt_number": 68
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###MUX"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Initializing the MUX class\n",
      "\n",
      "mux = MUX(0, 1, 1, 0)\n",
      "\n",
      "# Put select lines\n",
      "\n",
      "mux.select_lines(0, 0)\n",
      "\n",
      "# Output of mux\n",
      "\n",
      "print (mux.output())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "0\n"
       ]
      }
     ],
     "prompt_number": 69
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Sequential Circuits - Introducing the clock object."
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "####JK Flip Flop and the The ASCII Art based Oscilloscope of BinPy"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "j, k, p, q = Connector(1), Connector(0), Connector(0), Connector(1)\n",
      "\n",
      "# A clock of 4 hertz frequency initialized to 1\n",
      "clock = Clock(0, 4)\n",
      "\n",
      "jkff = JKFlipFlop(j, k, Connector(1), clock.A, clear=Connector(1))\n",
      "\n",
      "# To connect outputs use s.set_outputs(op1,op2)\n",
      "jkff.set_outputs(A=p, B=q)\n",
      "\n",
      "# Initiating the oscilloscope\n",
      "o = Oscilloscope((clock.A, 'CLK'), (j, 'J'), (\n",
      "    k, 'k'), (p, 'OUT'), (q, 'OUT!'), (Connector(1), 'ENABLE'))\n",
      "\n",
      "o.start()\n",
      "o.set_scale(0.02)  # Set scale by trial and error.\n",
      "o.set_width(100)\n",
      "o.unhold()\n",
      "\n",
      "\n",
      "# For each j,k in 0,0 / 0,1 / 1,0 / 1,1 Trigger ( Send a Falling edge clock pulse to the jkff module )\n",
      "\n",
      "from time import sleep\n",
      "\n",
      "for j.state, k.state in zip([0, 0, 1, 0, 1], [0, 0, 0, 1, 1]):\n",
      "    \n",
      "    print \"j,k = \", ( j.state, k.state )\n",
      "    # Sending One Clock Pulse \n",
      "\n",
      "    # The same thing can also be done by --> jkff.setInputs(j = 1, k = 0)\n",
      "    while True:\n",
      "        if clock.A.state == 0:\n",
      "            # Falling edge will trigger the FF\n",
      "            jkff.trigger()\n",
      "            break\n",
      "    print (jkff.state())\n",
      "\n",
      "    # Sending a positive edge to jkff\n",
      "    while True:\n",
      "        if clock.A.state == 1:\n",
      "            # Falling edge will trigger the FF\n",
      "            jkff.trigger()\n",
      "            break\n",
      "            \n",
      "\n",
      "o.display()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\u001b[0m\n",
        "\u001b[0m\n",
        "j,k =  (0, 0)\n",
        "[0, 1]\n",
        "j,k = "
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        " (0, 0)\n",
        "[0, 1]"
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "j,k = "
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        " (1, 0)\n",
        "[1, 0]"
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "j,k = "
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        " (0, 1)\n",
        "[0, 1]"
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "j,k = "
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        " (1, 1)\n",
        "[1, 0]"
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n",
        "\u001b[0m===================================================================================================================\n",
        "BinPy - Oscilloscope\n",
        "===================================================================================================================\n",
        "                                                                               SCALE - X-AXIS : 1 UNIT WIDTH = 0.02\n",
        "===================================================================================================================\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502          \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510          \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510          \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510           \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510           \n",
        "     CLK  \u2502          \u2502          \u2502          \u2502           \u2502          \u2502          \u2502           \u2502          \u2502           \n",
        "          \u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518           \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502                                \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510                      \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "       J  \u2502                                \u2502                      \u2502                      \u2502                     \u2502\n",
        "          \u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                     \u2514\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502                                                       \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "       k  \u2502                                                       \u2502                                            \u2502\n",
        "          \u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                                            \u2514\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502                                            \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510                     \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "     OUT  \u2502                                            \u2502                      \u2502                     \u2502          \u2502\n",
        "          \u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518          \u2514\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510                      \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510           \n",
        "    OUT!  \u2502 \u2502                                          \u2502                      \u2502                     \u2502           \n",
        "          \u2500 \u2518                                          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n",
        "   ENABL  \u2502 \u2502                                                                                                  \u2502\n",
        "          \u2500 \u2518                                                                                                  \u2514\n",
        "          \u2502\n",
        "          \u2502\n",
        "\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\n",
        "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n",
        "\u001b[0m"
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n"
       ]
      }
     ],
     "prompt_number": 70
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Multivibrator"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# MODE selects the mode of operation of the multivibrator.\n",
      "\n",
      "# Mode No. :  Description\n",
      "#   1          Monostable\n",
      "#   2          Astable\n",
      "#   3          Bistable\n",
      "\n",
      "out = Connector()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 71
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "#### Multivibrator in mode 1 - Monostable mode"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Initialize mutivibrator in MODE 1\n",
      "\n",
      "m = Multivibrator(0, mode=1, time_period=1)\n",
      "m.set_output(out)\n",
      "\n",
      "# Initialize the oscilloscope \n",
      "o = Oscilloscope((out, 'OUT'))\n",
      "o.set_scale(0.005)  # Set scale by trial and error.\n",
      "o.set_width(100)\n",
      "o.unhold()\n",
      "time.sleep(0.1)\n",
      "m.trigger()  # Also works with m()\n",
      "time.sleep(0.1)\n",
      "\n",
      "# Display the oscilloscope\n",
      "o.display()\n",
      "m.kill()\n",
      "o.kill()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\u001b[0m\n",
        "\u001b[0m\n",
        "\u001b[0m===================================================================================================================\n",
        "BinPy - Oscilloscope\n",
        "===================================================================================================================\n",
        "                                                                              SCALE - X-AXIS : 1 UNIT WIDTH = 0.005\n",
        "===================================================================================================================\n",
        "          \u2502\n",
        "          \u2502\n",
        "          \u2502                      \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510                                                            \n",
        "     OUT  \u2502                      \u2502                 \u2502                                                            \n",
        "          \u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n",
        "          \u2502\n",
        "          \u2502\n",
        "\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\u2502\n",
        "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n",
        "\u001b[0m"
       ]
      },
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "\n"
       ]
      }
     ],
     "prompt_number": 72
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Analog Buffer"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Source Bus\n",
      "a = Bus(4)\n",
      "a.set_type(analog=True)\n",
      "a.set_voltage_all(3.5, 6.7, 2.2, 1.1)\n",
      "\n",
      "# Ouput Bus\n",
      "b = Bus(4)\n",
      "b.set_type(analog=True)\n",
      "\n",
      "# Enable input\n",
      "e = Bus(1)\n",
      "e.set_logic_all(1)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 73
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Initializing an analog Buffer\n",
      "buff1 = AnalogBuffer(a, b, e, 0.8) # With an attenuation of 0.8, relay the input to the output"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 74
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print b.get_voltage_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[3.1920379377456842, 6.110472623684595, 2.0064238465830018, 1.0032119232915009]\n"
       ]
      }
     ],
     "prompt_number": 75
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# BinPy automatically converts the voltage to logic state based on 5v-0v logic\n",
      "print b.get_logic_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[1, 1, 0, 0]\n"
       ]
      }
     ],
     "prompt_number": 76
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print b.get_voltage_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "[3.1920379377456842, 6.110472623684595, 2.0064238465830018, 1.0032119232915009]\n"
       ]
      }
     ],
     "prompt_number": 77
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Changing the input\n",
      "\n",
      "a.set_voltage_all(1,1,1,1)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 78
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "b.get_voltage_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 79,
       "text": [
        "[0.9120108393559098,\n",
        " 0.9120108393559098,\n",
        " 0.9120108393559098,\n",
        " 0.9120108393559098]"
       ]
      }
     ],
     "prompt_number": 79
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# Changing the attenuation level\n",
      "\n",
      "buff1.set_attenuation(0)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 80
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "b.get_voltage_all()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 81,
       "text": [
        "[1.0, 1.0, 1.0, 1.0]"
       ]
      }
     ],
     "prompt_number": 81
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###<a href=\"http://localhost:8888/notebooks/Analog%20Converters.ipynb\">Analog Converters</a>"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### Analog Signal Generator - Amplitude Modulation using 2 Analog Signal Generators"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "# AM Signal generation using 2 intances of Signal Generator modules.\n",
      "\n",
      "import numpy as np\n",
      "%matplotlib inline\n",
      "import matplotlib.pyplot as plt\n",
      "import math, time\n",
      "\n",
      "# Message sine signal generator of frequency 10 Hz and 1 Vpp amplitude\n",
      "m_t = SignalGenerator(typ = 0, freq = 10, ampl = 1)\n",
      "m_t.set_offset(-0.5)\n",
      "\n",
      "# Carrier sine signal generator of frequency 100 Hz and 10 Vpp amplitude\n",
      "c_t = SignalGenerator(typ = 0, freq = 100, ampl = 10)\n",
      "c_t.set_offset(-5) # To make the range as [-5, 5]\n",
      "c_t.set_modulation_input(m_t.outputs)\n",
      "c_t.set_modulation_type(1)\n",
      "\n",
      "time.sleep(0.5) # To allow setup time\n",
      "\n",
      "c_t.last_updated_time, (c_t.outputs[0].voltage - c_t.outputs[1].voltage)\n",
      "\n",
      "# Populate the plot points to data array\n",
      "\n",
      "data = np.zeros(shape = (2, math.ceil(m_t.time_period / c_t.sampling_time_interval)))\n",
      "\n",
      "for i in range(data.shape[1]):\n",
      "    data[0][i] = m_t.last_updated_time + m_t.time_period * i\n",
      "    data[1][i] = c_t.outputs[0].voltage\n",
      "    time.sleep(c_t.sampling_time_interval)\n",
      "\n",
      "# Plot the modulated signal for the given timeframe\n",
      "fig, ax = plt.subplots()\n",
      "ax.plot(data[0], data[1])\n",
      "plt.show()\n",
      "\n",
      "# Kill the signal generator threads after use\n",
      "m_t.kill()\n",
      "c_t.kill()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "display_data",
       "png": "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\nRU5ErkJggg==\n",
       "text": [
        "<matplotlib.figure.Figure at 0x7f8c4a44f350>"
       ]
      }
     ],
     "prompt_number": 82
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "###Boolean Expression parsing / manipulation features of BinPy\n",
      "####Currently the features are spread across 3 different classes<br>\n",
      "####<a href=\"make_bool_QM.ipynb\">Make Boolean - An application of Quine Mclusky logic minimization algorithm</a><br>\n",
      "####<a href=\"Expr.ipynb\">Expression Class with Truth table generation</a><br>\n",
      "####<a href=\"exp_conv.ipynb\">Second Expression convert module with NAND only / NOR only output support</a><br>"
     ]
    }
   ],
   "metadata": {}
  }
 ]
}