shapeflow

A tool for extracting time-series data from video footage of microfluidic devices with complex channel geometry. Written by Yury Bondarenko with moral and QA support of the KU Leuven MeBioS Biosensors group.

Installation & usage

  1. Make sure the following software is installed on your system

  • Python 3.10

    On Windows, make sure you select the option ‘Add Python to PATH’!

  • git

  • Three options are available for SVG rendering, from fastest to slowest:

    • cairo

      On Windows, run sf.py setup-cairo after installing shapeflow.

    • ImageMagick

      To install on 64-bit Windows you can use this installer

    • Inkscape

      This is the slowest option, but can serve as a convenient fallback.

  1. Make a new folder in a convenient location

  2. Download a deployment script and save it to that folder

  3. Run the deployment script (on Windows you can just double-click it from explorer)

  4. Once the installation is done, you can start the application by running sf.py. A new browser window or tab should open with the user interface.

Dependencies