Skip to main content

# Average Pixels [![Build Status](https://travis-ci.org/liviu-/average-pixels.svg?branch=develop)](https://travis-ci.org/liviu-/average-pixels)

Command line tool which takes a bunch of images, and outputs a JPEG combining the images using a weighted average where the weights are samples drawn from the Dirichlet distribution.

`sh $ average-pixels download "party explosions boom" --offset 90 --count 30 `

![party_explosions_boom](images/party_explosions_boom.jpg)

## Installation

`sh $ python3 -m pip install average-pixels `

## Configuration The application in download mode uses [Bing Search API](https://www.microsoft.com/cognitive-services/en-us/bing-image-search-api) to search for images so it requires the user to have an API key activated for Bing’s search service. To obtain one:

Once obtained, the key may be provided through various methods:

  • When prompted by the application

  • By storing it in ~/.average_pixels_api

  • Or via the AVERAGE_PIXELS_API environment variable (e.g. $ export AVERAGE_PIXELS_API=$key)

## Example usage:

The application has 2 modes:

  • local: Combines local files and outputs the combined image

  • download: Takes keywords from the user, and combines images from Bing Image Search

`sh $ average-pixels download "black cats" `

![black_cats](images/black_cats.jpg)

`sh $ average-pixels download "green field blue sky" `

![green_field_blue_sky](images/green_field_blue_sky.jpg)

`sh $ average-pixels download "just give me some random photo" `

![just_give_me_some_random_photo](images/just_give_me_some_random_photo.jpg)

`sh $ average-pixels download "no" `

![no](images/no.jpg)

`sh $ average-pixels download "insects" --count 30 `

![insects](images/insects.jpg)

`sh $ average-pixels local /tmp/average_images --offset 40 `

![existing_dir](images/existing_dir.jpg)

`sh $ average-pixels download "turner" --count 20 `

![turner](images/turner.jpg)

`sh $ average-pixels download "jackson pollock painting" --count 10 --offset 30 `

![jackson_pollock](images/jackson_pollock_painting.jpg)

`sh $ average-pixels download "green" --count 100 `

![green](images/green.jpg)

`sh $ average-pixels local images/ `

![local_dir](images/output.jpg)

Metadata

Release files for average-pixels 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for average-pixels 1.1.0
File Size Uploaded Provenance
average-pixels-1.1.0.tar.gz 349.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for average-pixels 1.1.0
File Interpreter ABI Platform
average_pixels-1.1.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 355.3 kB

Release files / average-pixels-1.1.0.tar.gz

Download URL average-pixels-1.1.0.tar.gz
Size 349.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f22bc119b1b940e8b41389134f04c8beb29f929b2627898bcba93b9a52fb54d8
BLAKE2b-256 checksum
How to use checksums
b9a6f3de66da93a784139a7bdacb4bbf4beefc031856d8ac90e711170c45e3db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / average_pixels-1.1.0-py2.py3-none-any.whl

Download URL average_pixels-1.1.0-py2.py3-none-any.whl
Size 5.5 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
5ccc9b63daadd07e56acbef5b10978865840705801a4d13f728486889a54450d
BLAKE2b-256 checksum
How to use checksums
690dc6dc05813de8a44b82956e492cd98be020fcbcf156e71dea44a4d1f6b077
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for average-pixels 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page