Skip to content
An interactive cropping widget for Jupyter notebooks
Python Jupyter Notebook
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
interactivecrop
static
tests
.gitignore
Examples.ipynb
Interactive_Crop_Demo.ipynb
LICENSE.txt
MANIFEST.in
README.md
requirements.txt
setup.py

README.md

Jupyter Interactive Cropping Widget

An interactive widget to rapidly crop images in Jupyter notebooks.

Widget Documentation, Examples, and Use

This widget can be found on the PyPI repository here, and can be installed via pip install interactivecrop.

Build Instructions

Install Jupyter and enable ipywidgets

After cloning this repo, you can build the widget from source and use in a jupyter lab/notebook instance. Before this widget will work properly, you will need to install and enable jupyter widgets. To enable the widgets for Jupyter Lab using pip follow the below commands:

pip install jupyterlab #installs jupyter lab and gives access to jupyter lab CLI
pip install ipywidgets
jupyter nbextension enable --py widgetsnbextension
jupyter labextension install @jupyter-widgets/jupyterlab-manager

* Feel free to run this in your default python environment or a separate kernel; If using a separate kernel make sure it has been added to the available kernels via the ipykernels package

Installing requirements for this widget

Once Jupyter has been installed and enabled, check that all requirements have been downloaded by running pip install -r requirements.txt from this directory. Then, open up a jupyter lab instance by running jupyter lab, and once inside try the below example using the images in the sample_image directory:

from interactivecrop.interactivecrop import main as crop
from interactivecrop.samples import sample_images, sample_names

crop(sample_images,image_name_list = sample_names)

For further examples of cropper use, see the Examples.ipynb (make sure to run the jupyter lab startup command from the root directory when running Examples.ipynb).

interface

You can’t perform that action at this time.