trimap_tutorial.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### December 30, 2018 ###\n",
    "\n",
    "**1. Single Input Image** <br />\n",
    "Online Interactive Tutorial with Jupyter <br />\n",
    "Generate a trimap from an input of mask image"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "%matplotlib inline\n",
    "from trimap_module import trimap\n",
    "import cv2, os, sys\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### First, load the input image ####"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAQEAAAD8CAYAAAB3lxGOAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4xLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvDW2N/gAAEPlJREFUeJzt3VtT21YXxvFHsi2fMIck5DTJTJvpXb7/N+l9O02aAjkUgxGWLUvvhWdttoTpG1IMadb/N5MJMQaMIz3ah7W3krquBcCv9KFfAICHRQgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4133oFyBJSZJQtghsWV3XyabHaQkAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4RwgAzhECgHOEAOAcIQA4Rwg40ev1JEmDwUCDwUBpmipNr/77x+OxJCnLMmVZ1vg4yzKNRqPwXPt8/O/4sU6n0/i5g8Hg7n8h3BlCAHAuqev6oV+DkiR5+BfhQLfbVVVVkqQkSbRarRqfz7JMi8VCkjSZTHR+ft74vF3Ri6KQJNmxY60A+9okSbS/vy9J+vvvv7fxq+Ab1HWdbHqcEHBiMBio0+no4uIiPDYej0MoXF5eNp6fJEk4yXu9nkajkc7OziStT/5erxe6ExYKMet+LJdLjcfjxs/FwyAEIEna2dmRJM1mM/X7/XAC93o9dTodzedzSetWQ1mWkq5aCDYuUFVVeJ7Z3d0NLYdHjx7p8+fP4XNxoODh3BQCjAkAztEScMKu+tZMr6qqMSbQ6/W0XC5Dv38+n2s4HEpaN/+zLAvdgbadnR3NZrNbfw7366aWQPe+XwgehoX9crmUJI1GI+V5rt3dXUkKzfu4mR+PE8SP9/t9lWUZBgRtSjAeB+h214cWAfD9ozsAOEd3wJHhcBgG+5bL5bVpwE6no36/L0m6uLgIg3uPHz9ufJ9erxe+j9nf39fp6akkKU3T0CooioIuwXeC2QHn0jRVVVVKkvVxMBwOdXx8HPr9nU5HZVmG7oI9Lq27BXGAWFPfTKdT7e3tharDPM/D5zqdzrV6BDwMQuAHFRf4SFcDfNJ6HMBOwLiU967YmMFwOAxBIK1bGdYSODs706tXr8Jzy7L8x0KkeOwhy7LGYGVRFKqqKoQNtQe3wxQhgI1oCfyHtSvx9vb2dHx8HK6me3t7Nzbh79rp6WkoFZbU+LlnZ2dhFuLDhw968+ZNmK1YLBaNcuaqqjSZTCQptBasMrGqqkYRE5WIt0N34AdmA3e//vqrnj9/Hh5vn5h3zaoNsywLYw1ts9lMOzs74SRP0zQ8Jq27DvEKxN3d3VCPMBwOG12abrery8vLa2sV8HUIgR+UDehJ0mq1Ul3Xjav+NscE2q2MT58+SVrPFNhjeZ6r2+02TvS6rhuhsVgsQpDNZjMdHBxIur746PHjxyqKIsw0bBpbwM0YEwCwES2B/7B+v6+jo6Mwem5/v3//XpL06tWre3kd7dZGVVWh+W8tAvv3fD5XlmWhnz+dTnVwcBCa9k+fPtV0OpV0tfDIvkdZlup0OqFVsVwur9Ur4GZ0B35QdV2HE0xSY7cg6aps1/rg21CWZVhebKyZPplMNJ1Ow7ReOxTiQT9pHRJPnz6VtO5KPH36VMfHx5LWqxO/fPkSfobVPuDrEAI/oLquled5Y+uvv/76S8+ePZO0PqHiz23TYrFoDODFgVBVVRjs29/f13K5DLMDdrW3AqN4IDNJEh0cHDTGBjqdTvhaAuB2GBMAsBEtgf+wPM/DNJq07pu36wHsCruNFkG7q7GpJiGeDpTWI/42+i+tr+ZxF2Y+n4f1C0mShD/SegwkriikJPl26A48oPbBast4petlv7ZMd9PBnSSJRqNRWNhjJ8uPyuocLCTa4w5WHm3inZKk5u5I8cde0R0AsBEtgXtiTeR+v3+t1HUwGISrmrUAbIR8Pp83NvgsiuKHbwG0xUua+/1+aDnZEuW4uCjuisRXfloCdAceVJZl4QC05bw3ve/j8Vjz+TyEQVVVITT+qe/9I7Emfb/f1+fPnxv7GcRjBP/v2I2nEAkBQuC7cXh4qI8fP4ZFMovFQnVdh6tbVVUqyzIcvO2r/rt37/T69ev7fdEPpB0A7X0Ner1eYxzgxYsXYWOToihU13UYT2AAkTEBADegJXAPdnZ2wtXK+v5W4vvlyxetVquvquibz+cu7usXb4qaZVn4d1mWjdkBad09aC89jlmJcZqm1+6V4A3dge/Ipvc8roKbTqchFOIpxG63q+Vy+cMPDN608vHDhw96+fJl47F4F6NerxfGC5IkYalxCyHwgOLSV1sfbwf4+fm5BoPBtSucsbp8aX2Qf/r0SU+ePLmfF/4dOD4+DmXQJi45lq62JBuNRtcCNl585B1jAgA2oiVwz+z9bpfcxnf6tWa/1Nz1d7FYKMuycOX7UccH/qnUOV4wVde1+v1+mEmJy6btyh/fe9E7ugN3bFPderxjbpqm4QTO8zyc/HVdh6Kf+Gu2uQPQf018+/R4B6KyLDUYDMJ7xY1Ob4fbkN2xNE3DGvmiKMJ22NL66t3r9Rr37rOD1RbQxCd/kiSc/HgwjAkAztES+EbL5bJR2itdVfedn5/r8vIyVLv9/vvvjS22JYUdch49etT4Hu2dgYBtY0zgG/X7/TCtN5vNNBwOw112kiTRkydP9Mcff0ha9/vjaa2yLMMA1mq10mKxCN/rR10PcBuMCWwHU4QANqIlcEeyLGtcoVarVZjmOzs7a+ymI6mxMcjOzk5jY07vaAlsB1OEW2B9/ul02qhIs62x435+3FWIbxgyHA7D/D/WCIHtYIpwC+xqLq37/XaiS2r0+8/PzxtX+KqqwhhAWZbKsuxetgYHNmFMAHCOlsA3iisGR6ORTk9PGzv+xKW/k8kkTA32er3GFmHdbvfajrzAfWJM4I7E76PtgEMp8L9jy4TjsZV4jMCmZa3blWVZWHcwHo/Drk3G+0pCpgjvWJqm4U9d1zo5OQn34LPBvvbAFm7Hxk1svcXR0ZF++umn8PnLy0uNx2OVZamyLJXnuQ4PD3V4eKiLi4twr0L7g80IAcA5ugN3wHYQvukxWgO3Y7Ms/X7/2k5KX758CUuJB4NB473d29sLsyyr1Urj8TiUYW/aeswb6gS2wA7AxWKhbrcb1vmnadrYG48Q+HdsTKAoisb+CubTp0+SpDdv3oRxGBsbML1e79odi7yhTgD/OTaLYldz+9v2YsjzXAcHB2G7tZOTkxAStszbgpktx2/GmADgHN2BO8CYwHZYObWN7LdvSCpd34jVKjNtbOBr71bkAd2BOxav+0+SRCcnJ6FZmqZpo2yYELgda7pnWaaqqhrLq+0OTSZeczGbza7d59G6BWVZur/vwE3oDgDO0R24I1QM3h0rsc6yTGdnZ9rd3ZW0fo/jlYPtDVriFtd4PL7WKvCOisEtmEwmoQ8aH4BJkmi5XG6sGLQD/OzsLGxE2q5msykxqTmq3Z72ug270/FisWjcmWc2m4X+c/xzt8V+xk0/N34v8jwPASBdjfTb+2pTs/Y7xWF7cXHR6CrcdHMXMCbwr7T7mDfd7SbP80Z9u6TGwd3tdkMg7O7u6uLiIhTExAe2PfYty47bW5vPZjNVVdV4HdtsFcZ7KlZV1fhZRVGE1xX/TqvVSnVdh993MplouVw29nRMkkS//PJLeL59fXvdgPcagX9CSwBwjjGBb5SmabgijUYj5Xmu/f19SdLp6akkhT5pfCcdK4CxJvn5+XnYocjEzeMkScL3KYpCjx8/btyg9GvN5/ONd/R5//69JOn58+dh555ta++kFN9U9Pz8PBT8dLvdRp8/z3M9efKk0S1ov1ft4zluSXkvGKJs+I7ZASpdL0lNkkS9Xi+crJeXl+Hkury8VKfTCSeBDSJad8Dq4eOdh+KTPR4ou42iKJRlWRijODs7a9zWe9u3Pbcm/XK51MHBgabTqaR1QPZ6vRBGr169CifydDrV/v6+Pn78KEk6PDwMqzalddfq2bNnevfunaTrg4Hxvo/eA0AiBLbCFrYURaFnz57p+Pg4fM769tL6AIyfG9+GrN/v67ffftPPP/8cvjYugFmtViEw0jTVYrEINQq3qT9oz1BUVaU0TcMWabu7u/cyeNYurGr/DhaK0rrFEC8estaXBdemRUH2XtV1raqqOPkjzA4A2IiWwDeaTCbXrkR2FbJugF2x49LXsizV7/cbdySKm7Gr1apRjWhTjdK6C/Lhwwe9fPnym15zvI2ZtTbiq/9qtdpaTUNcM9HeTi0eE5CuWgcvXrzQyclJo4IwTdNrszLPnz+XJB0dHYXX324BZFnWmBr1iO7AFthJPxgMdH5+Hk7sR48ehSmxtr29vdAfNvF+he3xhfjuRKenp9rf3/+mMmT7Ge1bddtr/taxhq8V/07xeIn12+Mp1Pi27HmeN7o/7duP27Jt6epu0PZcKybCGiFwx+KT1Ual48Uq8dV9MBg0rl7x1/b7fRVFEQ5e247c/l9sHEC62lPPnnub/7u6rq8FUPy62i2QbVkul0rTNFyx7T2Lx0ziFtXBwUGYbanrunFFt0FCex+63W6YLbC/7XuVZXkvxVDfM8YEAGxES8AJa320xy3sipzn+bW7IMX9+PgGKlaiG1+B41H9eLqx3f9fLBYajUaNPnt8dWcHoO2hJeCcnVjWfM6yTDs7O1qtVlqtVnr79q2SJGmsaeh0OiEkJpNJ2E05y7JwK7WyLHV0dKThcBjWAwwGA+V5Hnb/7XQ6oY/+9u3bMDaxs7PT2IYtfp24P4QA4BzdASdumjpr77xzeHgoSaFKz8QzC9b0t689ODjQn3/+GboAtrrPPm6jvPdhsLOQc1YD0B4TsPUEFxcXev36dSjBHY1GjefEJ+nh4aE+f/4cRtttibM9x7oN9thqtdLr168lSe/evdNoNKK89ztCS8AZO1Htll5fW0CzaZOOeFrvtijvvX8MDALYiBBwwq68NhuwXC4bV18rvbVRfOsCxFOINqIvrTf/KIpCRVGEx4bDoYbD4VeVHt/0OtrTlNg+ugPO2ICdTRVa330wGGixWFzry7c/lq5W8+3t7UlSqEK0OoG4qrFdpWdVipT33j/Khp1L0zTsxxc/ZidjWZZKkqSx6MnuCWiDhHai7u7uhloCaV3gEy9/jvdaMPEsBOW9D4MxAQAb0RIAnKAlAGAjQgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnCMEAOcIAcA5QgBwjhAAnEvqun7o1wDgAdESAJwjBADnCAHAOUIAcI4QAJwjBADnCAHAOUIAcI4QAJwjBADnCAHAOUIAcI4QAJwjBADnCAHAOUIAcI4QAJwjBADnCAHAOUIAcI4QAJwjBADnCAHAuf8BMka2P/xYGE4AAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "name    = \"./images/practices/binary_0.png\";\n",
    "image     = cv2.imread(name, cv2.IMREAD_GRAYSCALE)\n",
    "plt.imshow(image,cmap='gray');\n",
    "plt.axis('off');"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Next, plug all arguments to the trimap function**"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [],
   "source": [
    "size = 10;         # Unknown Region Thickness\n",
    "number = name[-5]; # Obtain The Image Number (in case more than one image)\n",
    "title = \"binary_dilated\"\n",
    "\n",
    "height, width = image.shape[:2]\n",
    "trimap(image, title, size, number)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Check The Trimap Result**"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAQEAAAD8CAYAAAB3lxGOAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4xLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvDW2N/gAABS5JREFUeJzt3ctu4koUQFH7qv8b8uXuyY3UQhAF8KPMXmuYHrRDqO1TBSTzsiwT0PXf0RcAHEsEIE4EIE4EIE4EIE4EIE4EIE4EIE4EIO7P0RcwTdM0z7O3LcLGlmWZ733dJABxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxIgBxf46+ALZ1uVyOvoRpmqbp6+vr6EvggXlZlqOvYZrn+fiL+BCjLPpnCMQ+lmWZ733ddgDiTAIncMa7+ztMBtt4NAk4E2A4t9EThW2ZBAZVu/s/QxRe40wAuMskMBgTwO+ZCJ5jEuDjCOY6HAwOwhOao5gEIM6ZwABMAetxTvCYMwESLpeLqD5JBCDOwSB3Xa/Xl/5tFJfLxdbgl5wJHGCUcXXtxTxyHATBZweS9l6Uj/6/keOAMwHIsx3YyV5bgDPcdY+6xvqW4NF2QAQ2cNSe/wwBuOeI6y4GQQQ28KkHfEcwHWzPm4WAu0TgRaaAdV2v14/5Xs5GBBiKEOxPBE7sUxeMqWBfIgBxIvCCUc4DPp1pYB8icEKlcbnyfR5JBCDOB4iecPQ2oHpX/Pf7rj4GWxKBwXnSszUR+IU9JwCL/memgvU5E4A4k8ADPvo7vtKrJFsSgQN44q7H9uB9InBj6wnAE5XROBOAOJPAP45+HwDPM1m9TwQ4FYt+fSKwE09eRuVMAOJEYAemAEZmO7Ahi39834fBpd86fMskAHEiAHG2AxuwDeBMRGBFFj9nZDsAcSKwElMAZyUCECcCKzAFcGYiAHFeHeBUbqcuU9j7RIBT8+vF3mc7wMcQgdeIAMSJAMSJAMSJAMSJwAocSI3Bz+E1IrAST0DOyvsEVvQdAkHYj8f6fSYBiDMJbMBEsB2P6fpMAhvyp7M5A5PADnzo5XUeq+2ZBCDOJHCAn+5u7nweg72JwGB+s3VYc5GMsuBGuY4iERjc1ovj6FcyLP7jOROAOJMAuxvp7l/+Q6Tf5mVZjr6GaZ7n4y/if99/pbZq7QU60oK/pxSBZVnme1+3HYA4k8AD9Yng1ie++7E0BUzT40lABH4gBJ+rFoBpEoFViMJ5FRf9LWcCwF0i8ISvry93FD6O7cAbbA/GI9KPORM4gEjsSwB+5kwAuMsksDPTwXrc+Z9jOxDy6aGx+F/zKAI+QMTwLPptOROAONuBD3e2rYG7/nacCUCclwiBu0QA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4kQA4uZlWY6+BuBAJgGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGIEwGI+wvFA2XXfbLe+AAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "name  = \"./images/results/10px_binary_dilated_0.png\";\n",
    "result = cv2.imread(name, cv2.IMREAD_GRAYSCALE)\n",
    "plt.imshow(result,cmap='gray');\n",
    "plt.axis('off');"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### January 06, 2019 ###\n",
    "\n",
    "**2. More Than Single Input Images**"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "size  = 10; # dilation size\n",
    "for i in range(0,4):\n",
    "    name   = \"./images/practices/binary_{}.png\".format(i); # Specify the image path\n",
    "    number = i;\n",
    "    title  = \"trimap\";\n",
    "    image  = cv2.imread(name, cv2.IMREAD_GRAYSCALE);\n",
    "    trimap(image, title, size, number, erosion = False);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### February 12, 2019 ###\n",
    "\n",
    "**3. Error Handler** <br />\n",
    "**Case I:** Return an error, if any of the following four images is detected: RGB, grayscale, white-only, black-only (to be continues) <br />"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAQEAAAD8CAYAAAB3lxGOAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4xLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvDW2N/gAAAyhJREFUeJzt2rENxDAMBEHx4f5bphv41FCwM6GiixYMNLt7gK7f7QHAXSIAcSIAcSIAcSIAcSIAcSIAcSIAcSIAcc/tAeecMzO+LcLHdnf+vbsEIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIE4EIG529/YG4CKXAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMSJAMS9440L8/tqMqAAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "name  = \"./images/test_images/test_image_1.png\"; # ONLY test_image_0.png shall succeed\n",
    "image = cv2.imread(name, cv2.IMREAD_GRAYSCALE)\n",
    "plt.imshow(image,cmap='gray');\n",
    "plt.axis('off');"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "ERROR: non-binary image (all black)\n"
     ]
    },
    {
     "ename": "SystemExit",
     "evalue": "",
     "output_type": "error",
     "traceback": [
      "An exception has occurred, use %tb to see the full traceback.\n",
      "\u001b[1;31mSystemExit\u001b[0m\n"
     ]
    }
   ],
   "source": [
    "size = 10;         # Unknown Region Thickness\n",
    "number = name[-5]; # Obtain The Image Number (in case more than one image)\n",
    "title = \"test_image\"\n",
    "\n",
    "trimap(image, title, size, number, erosion=False)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Case II:** Return an error if the erosion has entirely wiped out the foreground"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "name  = \"./images/test_images/test_image_0.png\";\n",
    "image = cv2.imread(name, cv2.IMREAD_GRAYSCALE)\n",
    "plt.imshow(image,cmap='gray');\n",
    "plt.axis('off');"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "ERROR: foreground has been entirely eroded\n"
     ]
    },
    {
     "ename": "SystemExit",
     "evalue": "",
     "output_type": "error",
     "traceback": [
      "An exception has occurred, use %tb to see the full traceback.\n",
      "\u001b[1;31mSystemExit\u001b[0m\n"
     ]
    }
   ],
   "source": [
    "size = 10;         # Unknown Region Thickness\n",
    "number = name[-5]; # Obtain The Image Number (in case more than one image)\n",
    "title = \"test_image\"\n",
    "\n",
    "trimap(image, title, size, number, erosion=50)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.7"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}