ENH: Notebook now runs on Google Colab.

Install python3-openslide.
Add tensorflow<2.7 dependency.
Add advice that Google Colab may require 'Runtime->Restart runtime'.
Add GitHub badge to README.md.

Author: Lee Newberg

README.md

@@ -7,14 +7,16 @@ The goal of this project is to create a whole-slide image file reader for machin
 ## Installation for Python
 
 [![PyPI Version](https://img.shields.io/pypi/v/histomics_stream.svg)](https://pypi.python.org/pypi/histomics_stream)
-[![Open In CoLab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DigitalSlideArchive/histomics_stream/blob/master/example/tensorflow_stream.ipynb?authuser=1)
+[![GitHub repository](https://img.shields.io/badge/Powered%20by-histomics__stream-blue.svg)](https://github.com/DigitalSlideArchive/histomics_stream)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DigitalSlideArchive/histomics_stream/blob/master/example/tensorflow_stream.ipynb?authuser=1)
 
 histomics_stream can be easily installed with Python wheels.  If you do not want the installation to be to your current Python environment, you should first create and activate a [Python virtual environment (venv)](https://docs.python.org/3/tutorial/venv.html) to work in.  Then, run the following from the command line:
 
 ```shell-script
-pip uninstall -y large_image tensorflow histomics_stream
-pip install 'large_image[all]' --find-links https://girder.github.io/large_image_wheels
-pip install histomics_stream
+apt update
+apt install -y python3-openslide openslide-tools
+pip uninstall -y histomics_stream large_image tensorflow
+pip install histomics_stream 'large_image[all]' --find-links https://girder.github.io/large_image_wheels
 ```
 
 Launch `python3`, import the histomics_stream package, and use it

example/tensorflow_stream.ipynb

@@ -29,9 +29,13 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "!pip uninstall -y large_image tensorflow histomics_stream\n",
-    "!pip install 'large_image[all]' --find-links https://girder.github.io/large_image_wheels\n",
-    "!pip install histomics_stream"
+    "!apt update\n",
+    "!apt install -y python3-openslide openslide-tools\n",
+    "!pip uninstall -y histomics_stream large_image tensorflow\n",
+    "!pip install histomics_stream 'large_image[all]' --find-links https://girder.github.io/large_image_wheels\n",
+    "print(\n",
+    "    \"NOTE!: On Google Colab you may need to choose 'Runtime->Restart runtime' for these updates to take effect.\"\n",
+    ")"
    ]
   },
   {
@@ -69,6 +73,7 @@
     "mask_filename = os.path.splitext(local_filename)[0] + \"-mask.png\"\n",
     "if not os.path.exists(mask_filename):\n",
     "    import large_image\n",
+    "\n",
     "    print(f\"Creating {mask_filename} ...\")\n",
     "    ts = large_image.open(local_filename)\n",
     "    import numpy as np\n",

setup.py

@@ -17,9 +17,7 @@
         "histomics_stream": "histomics_stream",
     },
     install_requires=[
-        # tensorflow is not listed as a requirement because the user
-        # will likely want to specify the version for compatibility
-        # with the CUDA libraries, etc.
+        "tensorflow>=2.6.0,<2.7",
         "itk",
         "pillow",
         "imagecodecs",