Skip to main content

Py4J Python wrapper for BoofCV

Project description

PyBoof is Python wrapper for the computer vision library BoofCV. Since this is a Java library you will need to have java and javac installed. The former is the Java compiler. In the future the requirement for javac will be removed since a pre-compiled version of the Java code will be made available and automatically downloaded. Installing the Java JDK is platform specific, so a quick search online should tell you how to do it.

To start using the library simply install the latest stable version using pip

pip3 install pyboof

Examples

Examples are included with the source code. You can obtain them by either checkout the source code, as described above, or browsing github here. If you don't check out the source code you won't have example data and not all of the examples will work.

To run any of the examples simply invoke python on the script

  1. cd PyBoof/examples
  2. python example_blur_image.py

Code for applying a Gaussian and mean spatial filter to an image and displays the results.

import numpy as np
import pyboof as pb

original = pb.load_single_band('../data/example/outdoors01.jpg', np.uint8)

gaussian = original.createSameShape() # useful function which creates a new image of the
mean = original.createSameShape()     # same type and shape as the original

# Apply different types of blur to the image
pb.blur_gaussian(original, gaussian, radius=3)
pb.blur_mean(original, mean, radius=3)

# display the results in a single window as a list
image_list = [(original, "original"), (gaussian, "gaussian"), (mean, "mean")]
pb.swing.show_list(image_list, title="Outputs")

input("Press any key to exit")

Installing From Source

One advantage for checking out the source code and installing from source is that you also get all the example code and the example datasets.

git clone --recursive https://github.com/lessthanoptimal/PyBoof.git

If you forgot --recursive then you can checkout the data directory with the following command.

git submodule update --init --recursive

After you have the source code on your local machine you can install it and its dependencies with the following commands:

  1. cd PyBoof
  2. python3 -m venv venv
  3. source venv/bin/activate
  4. pip3 install -r requirements.txt
  5. ./setup.py build
  6. ./setup.py install

Yes you do need to do the build first. This will automatically build the Java jar and put it into the correct place. Creating a virtual environment isn't required but recommended as you can only do so much damage with it.

Supported Platforms

The code has been developed and tested on Ubuntu Linux 20.04. Should work on any other Linux variant. Might work on Mac OS and a slim chance of working on Windows.

Dependencies

PyBoof depends on the following python packages. They should be automatically installed

  • py4j
  • numpy
  • transforms3d
  • opencv (optional and for IO only)

Optional

  • opencv_python (for IO only)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyBoof-0.43.1.tar.gz (22.5 MB view details)

Uploaded Source

File details

Details for the file PyBoof-0.43.1.tar.gz.

File metadata

  • Download URL: PyBoof-0.43.1.tar.gz
  • Upload date:
  • Size: 22.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10

File hashes

Hashes for PyBoof-0.43.1.tar.gz
Algorithm Hash digest
SHA256 a9e4742882cf97acb604c9e10357bd909c1ab4e030b557cf86bc75af5e6a0fdf
MD5 ffdf9a90021179fa2e4b2ded92cd5ec9
BLAKE2b-256 07740715289421bde8dc86c18a698eeed19a319a7a778c6843493ea7e481c9ba

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page