Skip to main content

DeadLeaves

An open-source Python package for creating dead leaves images in a systematic, yet flexible way.

Tests Py versions PyPI version Documentation Status

Core functionalities

  • generating dead leaves images with properties (e.g. sizes, orientations, colors) drawn from a wide range of distributions (e.g. uniform, normal, Poisson, power-law, constant) or directly from an image.
  • picking from various leaf shapes (circles, ellipsoids, rectangles, regular polygons).
  • sampling in different color spaces (RGB, HSV, Gray-scale).
  • applying different noise or image textures, either to the entire image or per-leaf.
  • varying the image area covered by leaves, i.e. choosing between sparser or denser sampling and position mask.
  • creating arbitrarily complex leaf configurations by adding dependencies between leaf features (e.g. space-dependent color gradients).

Installation

You may install deadleaves from PyPI using pip:

pip install deadleaves

OR (for developers), install from source:

  1. Clone the repository from GitHub:
git clone git@github.com:ag-perception-wallis-lab/deadleaves.git
  1. Install deadleaves to your local python library using pip, by running from the top-level directory:
pip install .

To install in developer/editable mode run pip install -e . at the root directory. This makes changes to files immediately usable, rather than having to reinstall the package after every change.

Dependencies

The package requires using a Python version 3.12 or newer. The dependencies should be automatically installed (at least using pip). deadleavess required dependencies are:

Download files

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

Source Distribution

deadleaves-1.1.0.tar.gz (36.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

deadleaves-1.1.0-py3-none-any.whl (29.0 kB view details)

Uploaded Python 3

File details

Details for the file deadleaves-1.1.0.tar.gz.

File metadata

  • Download URL: deadleaves-1.1.0.tar.gz
  • Upload date:
  • Size: 36.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for deadleaves-1.1.0.tar.gz
Algorithm Hash digest
SHA256 184d4312662835a55018aa464938bae543376e7a2dfce84570c2b4e6d3f40ae4
MD5 ce3a898ad6817b95a91604cbbe684dee
BLAKE2b-256 39486e68d2c61f365f36f4a6e806c0fa2f3599eb0d4b3edc42f6b2bb6c17d187

See more details on using hashes here.

Provenance

The following attestation bundles were made for deadleaves-1.1.0.tar.gz:

Publisher: release.yml on ag-perception-wallis-lab/deadleaves

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file deadleaves-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: deadleaves-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 29.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for deadleaves-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fdb116b5a1d462fb808056bf41625f4876ef40ec77a2f8f061ec0205acdfd6ed
MD5 648c69f0b51f8309b5f79e7f2ff08860
BLAKE2b-256 a1c4f6b75934c93b0cafa09e62c9fd378611ba6974424260fc18645e5eb50ec9

See more details on using hashes here.

Provenance

The following attestation bundles were made for deadleaves-1.1.0-py3-none-any.whl:

Publisher: release.yml on ag-perception-wallis-lab/deadleaves

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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