mergechannels 0.1.0__cp311-cp311-macosx_11_0_arm64.whl

mergechannels/__init__.py

@@ -0,0 +1,13 @@
+# Import Rust functions
+from .mergechannels import (  # type: ignore
+	apply_color_map,
+	apply_colors_and_merge_nc,
+)  
+
+from ._internal import merge
+
+__all__ = [
+	"apply_color_map",
+	"apply_colors_and_merge_nc",
+	"merge",
+]

mergechannels/__init__.pyi

@@ -0,0 +1,21 @@
+from typing import Sequence, Literal
+
+import numpy as np
+
+from ._luts import COLORMAPS
+from ._blending import BLENDING_OPTIONS
+
+def merge(
+	arrs: Sequence[np.ndarray],
+	colors: Sequence[COLORMAPS] = (),
+	blending: Literal[BLENDING_OPTIONS] = 'max',
+) -> np.ndarray:
+    ...
+
+def apply_color_map(arr: np.ndarray, cmap_name: COLORMAPS) -> np.ndarray: ...
+
+def apply_colors_and_merge_nc(
+    arrs: Sequence[np.ndarray],
+    colors: Sequence[COLORMAPS] = (),
+    blending: Literal[BLENDING_OPTIONS] = 'max',
+) -> np.ndarray: ...

mergechannels/_blending.py

@@ -0,0 +1,3 @@
+from typing import Literal
+
+BLENDING_OPTIONS = Literal['max', 'sum', 'mean', 'min']

mergechannels/_internal.py

@@ -0,0 +1,56 @@
+from typing import Sequence
+
+import numpy as np
+
+from mergechannels import (
+	apply_color_map,
+	apply_colors_and_merge_nc,
+)
+from ._luts import COLORMAPS
+from ._blending import BLENDING_OPTIONS
+
+def merge(
+	arrs: Sequence[np.ndarray],
+	colors: Sequence[COLORMAPS] = (),
+	blending: BLENDING_OPTIONS = 'max',
+) -> np.ndarray:
+	'''
+	apply cmaps to arrays and blend the colors
+	'''
+	n_arrs = len(arrs)
+	n_colors = len(colors)
+	if n_arrs > 0 and n_colors == 0:
+		arr_shapes = [arr.shape for arr in arrs]
+		if not all([len(arr_shape) == 3 for arr_shape in arr_shapes]):
+			raise ValueError(
+				'Expected a sequence of pre-colorized arrays, '
+				f'got {n_arrs} arrays of shapes {arr_shapes}'
+			)
+		# call merge rgb arrs here
+		return np.zeros((3,3))
+	if not n_arrs == n_colors:
+		raise ValueError(
+			'Expected an equal number of arrays to colorize and colormap names to apply. '
+			f'Got {n_arrs} arrays and {n_colors} colors'
+		)
+	arr_shapes = [arr.shape for arr in arrs]
+	if not len(set(arr_shapes)) == 1:
+		raise ValueError(
+			f'Expected every array to have the same shape, got {arr_shapes}'
+		)
+	# call apply and merge rgb arrs here
+	match n_arrs:
+		case 1:
+			return apply_color_map(arr=arrs[0], cmap_name=colors[0])
+		case _:
+			return apply_colors_and_merge_nc(arrs, colors, blending)
+
+
+
+
+
+
+
+
+
+

mergechannels/_luts.py

@@ -0,0 +1,81 @@
+from typing import Literal
+
+COLORMAPS = Literal[
+	'Rainbow RGB',
+	'3color-RMB',
+	'Red Hot',
+	'Yellow',
+	'betterRed',
+	'blue_orange_icb',
+	'mpl-inferno',
+	'I Blue',
+	'BOP purple',
+	'betterOrange',
+	'Blue',
+	'6_shades',
+	'OIMB3',
+	'Red/Green',
+	'Turbo',
+	'mpl-viridis',
+	'smart',
+	'Thermal',
+	'OIMB2',
+	'glow',
+	'OPF orange',
+	'physics',
+	'OIMB1',
+	'betterCyan',
+	'mpl-magma',
+	'edges',
+	'OPF purple',
+	'I Yellow',
+	'16_colors',
+	'sepia',
+	'ICA2',
+	'I Forest',
+	'ICA3',
+	'BOP orange',
+	'I Red',
+	'3color-CGY',
+	'I Green',
+	'Fire',
+	'Magenta Hot',
+	'Orange Hot',
+	'unionjack',
+	'I Cyan',
+	'Cyan Hot',
+	'I Magenta',
+	'Grays',
+	'Cyan',
+	'phase',
+	'gem',
+	'OPF fresh',
+	'betterGreen',
+	'3color-BMR',
+	'betterBlue',
+	'Magenta',
+	'Red',
+	'I Bordeaux',
+	'glasbey',
+	'glasbey_on_dark',
+	'mpl-plasma',
+	'3color-YGC',
+	'Green',
+	'ICA',
+	'Yellow Hot',
+	'thallium',
+	'Spectrum',
+	'royal',
+	'glasbey_inverted',
+	'betterYellow',
+	'HiLo',
+	'cool',
+	'Green Fire Blue',
+	'BOP blue',
+	'thal',
+	'Ice',
+	'brgbcmyw',
+	'I Purple',
+	'3-3-2 RGB',
+	'5_ramps',
+]

mergechannels-0.1.0.dist-info/METADATA

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: mergechannels
+Version: 0.1.0
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Dist: numpy>=1.24.4
+License-File: LICENSE
+Requires-Python: >=3.8, <3.13
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# mergechannels
+
+This project was originally conceived because I often find myself wanting to apply and blend colormaps to images while working from Python, and for historical reasons many of my favorite colormaps are distributed as [FIJI](https://imagej.net/software/fiji/) lookup tables. I also care about things likes speed and memory usage (e.g., not casting large arrays to floating point dtypes), so I was interested in seeing if I could at least match matplotlib's colormapping performance with my own hand-rolled colorizer in Rust.
+
+There are other great colormapping libraries available (e.g., [microfilm](https://github.com/guiwitz/microfilm), [cmap](https://github.com/pyapp-kit/cmap)) that are more feature-rich than this projecting on your needs, but which don't address the my goals. My hope is that this project can fill and un-met niche and otherwise maintain full compatibility with these and similar libraries.
+
+## Installation
+
+Install pre-compiled binaries from [PyPI](https://pypi.org/project/mergechannels/):
+```bash
+pip install mergechannels
+```
+
+Build from source on your own machine:
+```bash
+pip install git+https://github.com/zacswider/mergechannels.git
+```
+
+## Usage
+*NOTE*: scikit-image is not a dependency of this project, but is used in the examples below to fetch images.
+
+### colorize a single image
+
+```python
+from skimage import data
+import matplotlib.pyplot as plt
+import mergechannels as mc
+
+img = data.camera()
+fig, ax = plt.subplots()
+ax.imshow(mc.apply_colormap(img, 'Orange Hot'))
+```
+
+### apply a different colormap to each channel
+```python
+from skimage import data
+import matplotlib.pyplot as plt
+import mergechannels as mc
+
+cells, nuclei = data.cells3d().max(axis=0)
+cells = to_uint8(cells / cells.max())       <- broken until normalization is handled
+nuclei = to_uint8(nuclei / nuclei.max())    <- broken until normalization is handled
+fig, (a, b, c) = plt.subplots(1, 3)
+a.imshow(cells, cmap='gray')
+b.imshow(nuclei, cmap='gray')
+
+import mergechannels as mc
+c.imshow(mc.merge([cells, nuclei], ['Orange Hot', 'Cyan Hot']))
+```
+
+## Acknowledgements
+This project incorporates a number of colormaps that were hand-crafted by Christophe Leterrier and were originally distributed here under the MIT license: https://github.com/cleterrier/ChrisLUTs

mergechannels-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+mergechannels-0.1.0.dist-info/METADATA,sha256=tK_250ZwpjXLerJFVfX5GcLBgbLRcwCGpExsDb9ebtg,2677
+mergechannels-0.1.0.dist-info/WHEEL,sha256=wsVBlw9xyAuHecZeOYqJ_tA7emUKfXYOn-_180uZRi4,104
+mergechannels-0.1.0.dist-info/licenses/LICENSE,sha256=R5es2fadg5bQoUJCJlcU36nDOAG6Te2XtsfysfTT_xY,1070
+mergechannels/_internal.py,sha256=UrR1K-JYbg8BS7wbmtxcOLWnWuoxmKJztlWT3TQ-Pyk,1300
+mergechannels/__init__.pyi,sha256=Z4dmA6TQydClHHVU_wje6X4CD0xh8l_b9D2imN4pLzI,524
+mergechannels/__init__.py,sha256=Tj-1QoMYkvDi-Bew6N2kbKrOhtgo4kq61_vmnHacp3o,224
+mergechannels/_luts.py,sha256=DxwCMBnAAJc1ZX-D4cq8HabW-sLuBQpUqOWMWXqt_84,1035
+mergechannels/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mergechannels/_blending.py,sha256=mE5Cr9wvVJRcwfymg_UUZUjdIKx2mldfLU8QJT95bVM,84
+mergechannels/mergechannels.cpython-311-darwin.so,sha256=GKUfHavebuAc_qSI3Kayol7aT8y2rP625kWw9fLq_ZY,711560
+mergechannels-0.1.0.dist-info/RECORD,,

mergechannels-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.8.3)
+Root-Is-Purelib: false
+Tag: cp311-cp311-macosx_11_0_arm64

mergechannels-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zachary Swider
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.