Skip to main content

Interacting with gimp in python3.

Project description

pgimp

Build Status Docs

Interacting with gimp in python3.

Use Cases:

  • Autocompletion for writing gimp scripts.
  • Batch creation or update of gimp files or data extraction from gimp files.
  • Workflows where machine learning data has to be annotated. Raw data can be converted to gimp files where the annotation process can happen (gimp's thresholding tools etc. make it easy to do annotation for pixelwise segmentation). After the masks are created, they can be converted back to e.g. numpy files.

Read the documentation for details on what pgimp can do for you and how it is achieved. Every single public method comes with a short working example!

Skeletons for autocompleting gimp scripts

On setup, the GimpDocumentationGenerator will generate python skeletons for the methods that gimp exposes to the interpreter through the procedural database (pdb). This enables autocompletion in your IDE.

Run a python script within gimp

Running python code within gimp is performed by the GimpScriptRunner. Have a look at the corresponding test GimpScriptRunnerTest to see how this works.

You may import convenience functions from pgimp.gimp in your gimp python scripts. See pgimp.GimpScriptRunnerTest.test_import_from_pgimp_library.

Installation

The package manager pip and the python setuptools are required. As gimp uses a python2 interpreter, the pip packages numpy and typing for python2 need to be installed.

Operating system dependent infos

Linux

On Linux, install the gimp package, e.g. sudo apt-get install gimp for Debian/Ubuntu.

Mac OS

Install gimp from gimp.org or via homebrew.

Windows

Windows is not supported.

Using pip

pip3 install pgimp

Using conda

Using a conda environment.yml file:

name: <NAME_OF_THE_ENV>
channels:
  - defaults
dependencies:
  - python=<3.6+>
  - pip:
    - pgimp

From github

Using pip:

pip3 install git+https://github.com/mabu-github/pgimp

Using a conda environment.yml file:

name: <NAME_OF_THE_ENV>
channels:
  - defaults
dependencies:
  - python=<3.6+>
  - pip:
    - "git+https://github.com/mabu-github/pgimp"

Local

Install using symlink to checked out code (for development):

pip3 install -e .

Contributing and Publishing

See CONTRIBUTING.md.

License

This project is licensed under the MIT license. See the LICENSE file for more info.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
pgimp-1.0.0a3.tar.gz (32.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page