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:

Project links

Data verified by PyPI on Jul 20, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.1.0)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for lynnschmittwilken from gravatar.com lynnschmittwilken Avatar for Ticqi from gravatar.com Ticqi

Credits

Author/Maintainer: Lynn Schmittwilken

GitHub Statistics

Data verified by PyPI on Jul 20, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

EUPL-1.2
View SPDX License List

Requires

Python >=3.12

Classifiers

Report project as malware

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.0.0.tar.gz (36.3 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.0.0-py3-none-any.whl (29.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for deadleaves-1.0.0.tar.gz
Algorithm Hash digest
SHA256 5e88bebd21874914380611cc3c3fd093884cf57fc161135b47bdec8a594cdee2
MD5 dd3c0c6f1d3836893a04fc0eb6ca6b65
BLAKE2b-256 36a06156b4e5f6efaca5b89c7590fc39b07608926dbc940b97234fb67b18d90c

See more details on using hashes here.

Provenance

The following attestation bundles were made for deadleaves-1.0.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.0.0-py3-none-any.whl.

File metadata

  • Download URL: deadleaves-1.0.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.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 118ccac558ba309e4dad97423f369899f2bbd56470459af24618782698178b25
MD5 ebb67e3e31beddab8ce5aaa49f8850b2
BLAKE2b-256 b9ff2e7c7d580b8d6d3c9af94e893943a719e0edcf4b829208c66cd69123dc56

See more details on using hashes here.

Provenance

The following attestation bundles were made for deadleaves-1.0.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