Apply basic color-oriented image operations.

These details have not been verified by PyPI

Project links

Homepage

Project description

color-operations

Apply basic color-oriented image operations.

Lightweight version of rio-color but removing rasterio dependency.

Install

You can install color-operations using pip

pip install -U pip
pip install color-operations

Build from source

git checkout https://github.com/vincentsarago/color-operations.git
cd color-operations
pip install -U pip
pip install -e .

Operations

Gamma adjustment adjusts RGB values according to a power law, effectively brightening or darkening the midtones. It can be very effective in satellite imagery for reducing atmospheric haze in the blue and green bands.

Sigmoidal contrast adjustment can alter the contrast and brightness of an image in a way that matches human's non-linear visual perception. It works well to increase contrast without blowing out the very dark shadows or already-bright parts of the image.

Saturation can be thought of as the "colorfulness" of a pixel. Highly saturated colors are intense and almost cartoon-like, low saturation is more muted, closer to black and white. You can adjust saturation independently of brightness and hue but the data must be transformed into a different color space.

Ref https://github.com/mapbox/rio-color/blob/master/README.md

Examples

Sigmoidal

Contrast

sigmoidal_contrast

Bias

sigmoidal_bias

Gamma

Red

gamma_red

Green

gamma_green

Blue

gamma_blue

Saturation

saturation

Combinations of operations

combos

Ref https://github.com/mapbox/rio-color/blob/master/README.md

Python API

`color_operations.operations`

The following functions accept and return numpy ndarrays. The arrays are assumed to be scaled 0 to 1. In some cases, the input array is assumed to be in the RGB colorspace.

All arrays use rasterio ordering with the shape as (bands, columns, rows). Be aware that other image processing software may use the (columns, rows, bands) axis order.

sigmoidal(arr, contrast, bias)
gamma(arr, g)
saturation(rgb, proportion)
simple_atmo(rgb, haze, contrast, bias)

The color_operations.operations.parse_operations function takes an operations string and returns a list of python functions which can be applied to an array.

from color_operations import parse_operations

ops = "gamma b 1.85, gamma rg 1.95, sigmoidal rgb 35 0.13, saturation 1.15"

assert arr.shape[0] == 3
assert arr.min() >= 0
assert arr.max() <= 1

for func in parse_operations(ops):
    arr = func(arr)

This provides a tiny domain specific language (DSL) to allow you to compose ordered chains of image manipulations using the above operations. For more information on operation strings, see the rio color command line help.

`color_operations.colorspace`

The colorspace module provides functions for converting scalars and numpy arrays between different colorspaces.

from color_operations.colorspace import ColorSpace as cs  # enum defining available color spaces
from color_operations.colorspace import convert, convert_arr

convert_arr(array, src=cs.rgb, dst=cs.lch) # for arrays
...

convert(r, g, b, src=cs.rgb, dst=cs.lch)  # for scalars
...

dict(cs.__members__)  # can convert to/from any of these color spaces
{
    'rgb': <ColorSpace.rgb: 0>,
    'xyz': <ColorSpace.xyz: 1>,
    'lab': <ColorSpace.lab: 2>,
    'lch': <ColorSpace.lch: 3>,
    'luv': <ColorSpace.luv: 4>
}

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

0.1.6

Oct 7, 2024

This version

0.1.5

Jun 26, 2024

0.1.4

Jun 18, 2024

0.1.3

Mar 13, 2024

0.1.1

Apr 5, 2023

0.1.0

Nov 9, 2022

Download files

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

Source Distribution

color-operations-0.1.5.tar.gz (17.5 kB view details)

Uploaded Jun 26, 2024 Source

Built Distributions

color_operations-0.1.5-cp312-cp312-win_amd64.whl (133.2 kB view details)

Uploaded Jun 26, 2024 CPython 3.12 Windows x86-64

color_operations-0.1.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (198.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.12 manylinux: glibc 2.17+ ARM64

color_operations-0.1.5-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (204.4 kB view details)

Uploaded Jun 26, 2024 CPython 3.12 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

color_operations-0.1.5-cp312-cp312-macosx_11_0_arm64.whl (48.7 kB view details)

Uploaded Jun 26, 2024 CPython 3.12 macOS 11.0+ ARM64

color_operations-0.1.5-cp312-cp312-macosx_10_9_x86_64.whl (50.6 kB view details)

Uploaded Jun 26, 2024 CPython 3.12 macOS 10.9+ x86-64

color_operations-0.1.5-cp312-cp312-macosx_10_9_universal2.whl (86.0 kB view details)

Uploaded Jun 26, 2024 CPython 3.12 macOS 10.9+ universal2 (ARM64, x86-64)

color_operations-0.1.5-cp311-cp311-win_amd64.whl (133.5 kB view details)

Uploaded Jun 26, 2024 CPython 3.11 Windows x86-64

color_operations-0.1.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (188.8 kB view details)

Uploaded Jun 26, 2024 CPython 3.11 manylinux: glibc 2.17+ ARM64

color_operations-0.1.5-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (194.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.11 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

color_operations-0.1.5-cp311-cp311-macosx_11_0_arm64.whl (48.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.11 macOS 11.0+ ARM64

color_operations-0.1.5-cp311-cp311-macosx_10_9_x86_64.whl (50.8 kB view details)

Uploaded Jun 26, 2024 CPython 3.11 macOS 10.9+ x86-64

color_operations-0.1.5-cp311-cp311-macosx_10_9_universal2.whl (86.4 kB view details)

Uploaded Jun 26, 2024 CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64)

color_operations-0.1.5-cp310-cp310-win_amd64.whl (133.3 kB view details)

Uploaded Jun 26, 2024 CPython 3.10 Windows x86-64

color_operations-0.1.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (179.8 kB view details)

Uploaded Jun 26, 2024 CPython 3.10 manylinux: glibc 2.17+ ARM64

color_operations-0.1.5-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (186.2 kB view details)

Uploaded Jun 26, 2024 CPython 3.10 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

color_operations-0.1.5-cp310-cp310-macosx_11_0_arm64.whl (48.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.10 macOS 11.0+ ARM64

color_operations-0.1.5-cp310-cp310-macosx_10_9_x86_64.whl (50.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.10 macOS 10.9+ x86-64

color_operations-0.1.5-cp310-cp310-macosx_10_9_universal2.whl (86.5 kB view details)

Uploaded Jun 26, 2024 CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)

color_operations-0.1.5-cp39-cp39-win_amd64.whl (133.3 kB view details)

Uploaded Jun 26, 2024 CPython 3.9 Windows x86-64

color_operations-0.1.5-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (179.6 kB view details)

Uploaded Jun 26, 2024 CPython 3.9 manylinux: glibc 2.17+ ARM64

color_operations-0.1.5-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (186.0 kB view details)

Uploaded Jun 26, 2024 CPython 3.9 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

color_operations-0.1.5-cp39-cp39-macosx_11_0_arm64.whl (48.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.9 macOS 11.0+ ARM64

color_operations-0.1.5-cp39-cp39-macosx_10_9_x86_64.whl (50.9 kB view details)

Uploaded Jun 26, 2024 CPython 3.9 macOS 10.9+ x86-64

color_operations-0.1.5-cp39-cp39-macosx_10_9_universal2.whl (86.5 kB view details)

Uploaded Jun 26, 2024 CPython 3.9 macOS 10.9+ universal2 (ARM64, x86-64)

color_operations-0.1.5-cp38-cp38-win_amd64.whl (131.2 kB view details)

Uploaded Jun 26, 2024 CPython 3.8 Windows x86-64

color_operations-0.1.5-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (184.4 kB view details)

Uploaded Jun 26, 2024 CPython 3.8 manylinux: glibc 2.17+ ARM64

color_operations-0.1.5-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (192.0 kB view details)

Uploaded Jun 26, 2024 CPython 3.8 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

color_operations-0.1.5-cp38-cp38-macosx_11_0_arm64.whl (48.8 kB view details)

Uploaded Jun 26, 2024 CPython 3.8 macOS 11.0+ ARM64

color_operations-0.1.5-cp38-cp38-macosx_10_9_x86_64.whl (50.7 kB view details)

Uploaded Jun 26, 2024 CPython 3.8 macOS 10.9+ x86-64

color_operations-0.1.5-cp38-cp38-macosx_10_9_universal2.whl (86.2 kB view details)

Uploaded Jun 26, 2024 CPython 3.8 macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file color-operations-0.1.5.tar.gz.

File metadata

Download URL: color-operations-0.1.5.tar.gz
Upload date: Jun 26, 2024
Size: 17.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for color-operations-0.1.5.tar.gz
Algorithm	Hash digest
SHA256	`8d4479532acbd4be2b90858274a0810dcaa3146e192a785f6a4b3f8f3da6ea85`
MD5	`5b0b6d92aa6e5c4cdbb90e2583a3b06c`
BLAKE2b-256	`ef62724253f0e5bf52a0b9814b3914a217e1660f245588c26129bd65a0d409d7`

Algorithm	Hash digest
SHA256	`4456a123586711d193d5982ce89e826477f0422c84036574da66e49381bce299`
MD5	`3ed3cccbea566f812a9c0dbfb68e46e6`
BLAKE2b-256	`9f7bd065738a3c7e0d20f698c49720b32ecd5bc08ce5c55bf379fdfbcf59d211`

Algorithm	Hash digest
SHA256	`86b661572406df2ffda34e09409d3cb8dd46e513652232d469aebc3aa69654be`
MD5	`a75653a6c7934f7e300703bc33b0a452`
BLAKE2b-256	`75f675fb415224e07028e4d6b62e3f8d56b150c5593df438969146b0b46d9824`

Algorithm	Hash digest
SHA256	`f6044648d1bbd3c42e098e4c9a54886c16c44d0da4ae5c1c1b61a17760b98a4b`
MD5	`eaccf95fc1e6a9e665b13a290988caab`
BLAKE2b-256	`6b04dcf92b011ca8bcc167cc670015126266a42d1043c518294a6600579d9298`

Algorithm	Hash digest
SHA256	`2b5c71b0c5d30461244788f841984135e1d2dd057c80b9570a12d131aec286b2`
MD5	`55e27dc95529d306f89f548fb6a241b9`
BLAKE2b-256	`980e833a8dbb784111d0b87d3d565a4d6c8cdb79ce022d6975ce7a2be5e14250`

Algorithm	Hash digest
SHA256	`34e33f8f6a580b69713d3ea695a15716ccce136390f753ff9cfe13a49f723a8f`
MD5	`1018c1a28ffe631054c30e8f652304f2`
BLAKE2b-256	`aa611b601006ae6f5c7010999751899ace0690a8e27bf530c18b4c67c78120be`

Algorithm	Hash digest
SHA256	`c51875759fb6bcde97a18dfda892ca08c179636d41e3f696427fcaa834304f80`
MD5	`e8cf27048c727e8fdf70a1a84c682da6`
BLAKE2b-256	`4369d973a2b8eef971cc10c2c0626781ebcaae751953d83529c1ca4ae99d9b53`

Algorithm	Hash digest
SHA256	`38e177320b53d9ed8c3aa96fa837046a4d5f3cac98241685751afb4ab63e1912`
MD5	`76d0f366676a30b1f6d10c8c54c92ed1`
BLAKE2b-256	`95e464b18db696a8d3ba3650109aa1fc0ba4d512fc0c6029ffe223b5e2bd1af1`

Algorithm	Hash digest
SHA256	`484049262f6632a16ecf48e776e609281522ec5a9cd1a150a68084412a115c98`
MD5	`af9aa8169148ca96a4e722f093117d53`
BLAKE2b-256	`be3c4589646042ada24260112bf0928155a408c120ca665851e44c62b54297ff`

Algorithm	Hash digest
SHA256	`0fb0e507043b2ef614742fdd46b4ced80ed5f71b333a2437c168c062a36d6973`
MD5	`eab3b95c08bc1434863c15a443c60675`
BLAKE2b-256	`c32cd49d8a7b503e83433ef9c18b81cb076999e4bcdf37922b528fef5391d875`

Algorithm	Hash digest
SHA256	`238eb331ce03d4a5d2da106029e1b4fd04ba82995c9c6b58b100ab3ab909ce00`
MD5	`faf81abf65718cb34cc370a8188f859d`
BLAKE2b-256	`18a89f6fa3650dae5b9b6bfcb94f35beeb26e81c7357dd5f41a5b63d4519657c`

Algorithm	Hash digest
SHA256	`4aaec777a97768f6862d016895a6cbafd9a43b0fb1d741638b38ba579e79dd1b`
MD5	`b9cb9b6d6441b673251564128b25a0e8`
BLAKE2b-256	`7343949738ffc533241c14cf5fec95e8f86d67ccbe0f2c31b49a306b43b0fd76`

Algorithm	Hash digest
SHA256	`e70982db5304a2147b62abf2ab18c45b683e2f3c68c8a71da0622afc5fcf3a43`
MD5	`e1d3afe61cf5cbb640f1ec991bdd85c9`
BLAKE2b-256	`cefd31e16b96a0f206308010fd1f666ba6c24eff5b99e212f61fe1c2f3463b63`

Algorithm	Hash digest
SHA256	`f423ddc4ac8057894a69af4f91d6862710574e759aa6b525a0483ed8c788f11e`
MD5	`13b10f4cefb1d3da1a3557a68ca9d0d2`
BLAKE2b-256	`002412d4cb21f43490ea697cc9ff324a9edd2e0c3a4781f180048e61a2021107`

Algorithm	Hash digest
SHA256	`76e8767d91e5ee8eb259a25c2c72ff1a9fc6c1fd4ef9dfc1aba110cbb9b7397e`
MD5	`fb894f2fecfbea709a0d10cf02b442db`
BLAKE2b-256	`aa12d36c1a95ecf381d5244af20bc922472e021a93e59a6cd473f6a0953864ca`

Algorithm	Hash digest
SHA256	`3df23676c96720659f3dc934cbf6eb10d07d9f3e2560109227da3d4004ae3348`
MD5	`72fbd0696dddfdaab08a1485fabb5edd`
BLAKE2b-256	`f2b1545ac8b485c5b2ca9de42fb274923a5d6f1356b35a88a2e33192b8eac937`

Algorithm	Hash digest
SHA256	`a7c515506498fbdfdb970f2fe6a6f4dc3e41552d844568232e0b2f630d44b238`
MD5	`4f5180620d72747d83f68a5e9bfd48fb`
BLAKE2b-256	`017b74af3d2b0d447179893cb4abe03db92b3c41918eb1bfd01fb291ccfbb14f`

Algorithm	Hash digest
SHA256	`c1b37808b8f94db8bf5168543e7c08d6de6ed9723ba4c04be8a6ff53f32c00d6`
MD5	`e6a7f31c20642e55f4d68bcda832aafa`
BLAKE2b-256	`c151dbb945731fcbb71fd2497df12e5a58fd37ca57c259aa9e9a95b2621afdf6`

Algorithm	Hash digest
SHA256	`651893f735f5cb716bf60065183b337df00fd94251dac5a00fe3c6dd1d7127df`
MD5	`eb9304f1e35a6537d7495c9f6460084b`
BLAKE2b-256	`786b7d02e2fcce9f5410d4e63a9f131e64e64e792d2f7609298ac046fe4ca8a1`

Algorithm	Hash digest
SHA256	`a557ce3d8b610b5c10a5f096fdff89d3850ce549fee256aa37728472d67d628c`
MD5	`dcb95b4b238d051a10c4503fea18600f`
BLAKE2b-256	`495a674ddb3a30b2ecae3486c83dfc0924db57561284d7e7ea0d317ad3a542a0`

Algorithm	Hash digest
SHA256	`4c8352a2354178f9fdafee38df3ecacea06fcd894c511a6cce3b50590f830ef6`
MD5	`6e97c795d16bdd65e4360cc450ff9da6`
BLAKE2b-256	`a16627a722da65e68261cc4706cd221c85f2fa37da5b97138392c96f4ccb87e0`

color-operations 0.1.5

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

color-operations

Install

Operations

Examples

Sigmoidal

Gamma

Saturation

Combinations of operations

Python API

color_operations.operations

color_operations.colorspace

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

`color_operations.operations`

`color_operations.colorspace`

Algorithm	Hash digest
SHA256	`274ae1839c7f1068669d81acf8256b09cfa310a8ea0f255f9c5a04d9e2a6c59f`
MD5	`6ca648da13db191691678ba9e9ddb0c4`
BLAKE2b-256	`2113e0b6ff4e3df6b06295dcacf4edd107a4a3935786204ac50025e5c57b3a04`

Algorithm	Hash digest
SHA256	`15a73c9f2eb0045367c5d45e5931286e5cf42c5601098b4cfb66448df51d3478`
MD5	`0e88b997c08d5ba4ee1fd8ef316d18e1`
BLAKE2b-256	`02616ed19fb6856bf90db48bd0e26686fa9b4a158047d2446d4f51516b28eade`

Algorithm	Hash digest
SHA256	`581403d6114a29cefe8dd1857ee37b8794c1992a3aaf13f7ccd0267fda4f856a`
MD5	`0b8c03e8b5fdadf49d75efa7d6612668`
BLAKE2b-256	`59544a558938da8ec94054cbd02ee02ce2eeeff72ba3f493f48099c41aafdf19`

Algorithm	Hash digest
SHA256	`c452f9fb1a323c688623e245158f55236483425eb8e14a5f83347c4b35592374`
MD5	`f76d8362a0b1ee2e54da47996a5b031c`
BLAKE2b-256	`deeb1822b193ba1f15f3c61b32d29164eb0373bf0de427708d487bda2e1eaf9e`

Algorithm	Hash digest
SHA256	`78ede58b626cf7b63dd6c6a22712d65c5642e5b2d32dd3a90084ddbeee8a84b6`
MD5	`f7297ed85c44e9362691ba5c35dc2220`
BLAKE2b-256	`248b48eef81c41dc16649518ade01c818ad6f474fe35b676c02d6960b6108fc6`

Algorithm	Hash digest
SHA256	`1ddeb4ba6047704617f49bb9286a6cdd70d656e9607d8af76ad94776c645069b`
MD5	`a2313f7c66e2c04d109421f51b12df25`
BLAKE2b-256	`2edd868f88e74c4e1c69e1ddafd6ab8002fc65829757284003cc3e1743d0dbd7`

Algorithm	Hash digest
SHA256	`c485cf3e29d1377f5251d06b53dc0a99d3a3b6c3ffd246c2f60ec9558e3ce5c0`
MD5	`eac1c7112b3fb4be2190669bdf3df2f0`
BLAKE2b-256	`ad2dfdc4754f3944226316fffb188be9dd7657aff78077915995aad5b1cf6cbe`

Algorithm	Hash digest
SHA256	`38e3f49a565f1606b8d11374dd60952d40443156014c2c0eedcfa0a9f06ada32`
MD5	`48cddcf45bb00b7e5bd2c8cab2a27e4f`
BLAKE2b-256	`3bb676db7ebbe37bcd81f965050b664f1a0c43359ee84a10f062bd89b74cfb89`

Algorithm	Hash digest
SHA256	`e9586a29853991123627eb10f0da3c43aa9bf7ce3a0eb7f3a145b11d7d3c2289`
MD5	`6803a39403b7ce5cff34e84744784450`
BLAKE2b-256	`e9c3e5d9c9c9717b7fafca397515358a9576248f6bb72d0b688efe4b2bebd6e5`

Algorithm	Hash digest
SHA256	`6338fab2d186773edf5adc7b1f93aea1844c707821f2753e15f7216a36e94ce2`
MD5	`05d3df6f4912532c21b08e0da6f7dfaa`
BLAKE2b-256	`e87ed1c72267d927e74f2ee9fedcb06f8fb1891b8a0c47da557f4d75294f41f7`