daltoscope 0.1.0__tar.gz

daltoscope-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vince Gonzalez (OpticQuiz)
+
+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.

daltoscope-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: daltoscope
+Version: 0.1.0
+Summary: See a color, a palette, or a whole image as a colorblind person does — recolors for protanopia, deuteranopia, and tritanopia (Machado, Oliveira & Fernandes 2009).
+Author: Vince Gonzalez
+License: MIT
+Project-URL: Homepage, https://opticquiz.com/
+Project-URL: Source, https://github.com/vince-gonzalez/opticquiz.com
+Keywords: colorblind,color-blindness,daltonism,cvd,color-vision-deficiency,simulate,protanopia,deuteranopia,tritanopia,accessibility,a11y,image
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opticquiz-cvd>=1.1.0
+Provides-Extra: image
+Requires-Dist: pillow>=9.0; extra == "image"
+Requires-Dist: numpy>=1.21; extra == "image"
+Dynamic: license-file
+
+# daltoscope
+
+**See a color, a palette, or a whole image the way a colorblind person does.** Where `hueristic`
+*judges* whether colors are safe, `daltoscope` *shows* you — it recolors a hex, or an entire
+PNG/JPEG, as protanopia, deuteranopia, or tritanopia renders it.
+
+```bash
+pip install daltoscope          # colors only
+pip install "daltoscope[image]" # + image recoloring (Pillow, numpy)
+```
+
+```python
+import daltoscope as dalton
+
+dalton.simulate("#d7191c", "deutan")   # "#8a7b0c" — that warning red, to a deuteranope
+dalton.simulate_all("#1a9641")         # {"protan": "#988839", "deutan": "#8a7f48", "tritan": "#009383"}
+
+from PIL import Image
+sim = dalton.simulate_image(Image.open("dashboard.png"), "deutan")
+sim.save("dashboard-deutan.png")
+```
+
+## API
+
+- **`simulate(color, type, severity=1.0)`** → the color as one deficiency sees it, as hex.
+  `type` is `"protan"`, `"deutan"`, or `"tritan"`.
+- **`simulate_all(color, severity=1.0)`** → `{"protan": ..., "deutan": ..., "tritan": ...}`.
+- **`simulate_image(image, type, severity=1.0)`** → a recolored PIL `Image` (alpha preserved).
+  `image` is a PIL `Image` or a file path. `severity` (0..1) shows partial deficiency
+  (anomalous trichromacy), not only the full dichromat case.
+
+## How it works
+
+`daltoscope` is a thin lens over [`opticquiz-cvd`](https://pypi.org/project/opticquiz-cvd/): every
+pixel's transform is that engine's `simulate()`, using the Machado, Oliveira & Fernandes (2009)
+deficiency matrices. `simulate_image` passes each *distinct* color through the engine once via a
+lookup table, so a photograph is not thousands of redundant calls — and there is never a second
+copy of the colorimetry to drift. Method, open access:
+https://doi.org/10.5281/zenodo.21310578
+
+## Not a clinical tool
+
+A simulation for design and communication — it approximates how deficient color vision renders an
+image. It is not a diagnosis, and no on-screen rendering is exact for a given individual.
+
+## Licence
+
+MIT.

daltoscope-0.1.0/README.md

@@ -0,0 +1,48 @@
+# daltoscope
+
+**See a color, a palette, or a whole image the way a colorblind person does.** Where `hueristic`
+*judges* whether colors are safe, `daltoscope` *shows* you — it recolors a hex, or an entire
+PNG/JPEG, as protanopia, deuteranopia, or tritanopia renders it.
+
+```bash
+pip install daltoscope          # colors only
+pip install "daltoscope[image]" # + image recoloring (Pillow, numpy)
+```
+
+```python
+import daltoscope as dalton
+
+dalton.simulate("#d7191c", "deutan")   # "#8a7b0c" — that warning red, to a deuteranope
+dalton.simulate_all("#1a9641")         # {"protan": "#988839", "deutan": "#8a7f48", "tritan": "#009383"}
+
+from PIL import Image
+sim = dalton.simulate_image(Image.open("dashboard.png"), "deutan")
+sim.save("dashboard-deutan.png")
+```
+
+## API
+
+- **`simulate(color, type, severity=1.0)`** → the color as one deficiency sees it, as hex.
+  `type` is `"protan"`, `"deutan"`, or `"tritan"`.
+- **`simulate_all(color, severity=1.0)`** → `{"protan": ..., "deutan": ..., "tritan": ...}`.
+- **`simulate_image(image, type, severity=1.0)`** → a recolored PIL `Image` (alpha preserved).
+  `image` is a PIL `Image` or a file path. `severity` (0..1) shows partial deficiency
+  (anomalous trichromacy), not only the full dichromat case.
+
+## How it works
+
+`daltoscope` is a thin lens over [`opticquiz-cvd`](https://pypi.org/project/opticquiz-cvd/): every
+pixel's transform is that engine's `simulate()`, using the Machado, Oliveira & Fernandes (2009)
+deficiency matrices. `simulate_image` passes each *distinct* color through the engine once via a
+lookup table, so a photograph is not thousands of redundant calls — and there is never a second
+copy of the colorimetry to drift. Method, open access:
+https://doi.org/10.5281/zenodo.21310578
+
+## Not a clinical tool
+
+A simulation for design and communication — it approximates how deficient color vision renders an
+image. It is not a diagnosis, and no on-screen rendering is exact for a given individual.
+
+## Licence
+
+MIT.

daltoscope-0.1.0/daltoscope/__init__.py

@@ -0,0 +1,69 @@
+"""daltoscope — see a color, a palette, or a whole image as a colorblind person does.
+
+Named for daltonism (color blindness, after John Dalton). Where ``hueristic`` judges whether
+colors are safe, ``daltoscope`` shows what they look like through a color-vision deficiency —
+a single color, or an entire image recolored.
+
+    import daltoscope as dalton
+
+    dalton.simulate("#d7191c", "deutan")     # "#8a7b0c" — that red, to a deuteranope
+    dalton.simulate_all("#1a9641")           # {"protan": "#988839", "deutan": "#8a7f48", "tritan": "#009383"}
+
+    from PIL import Image
+    sim = dalton.simulate_image(Image.open("chart.png"), "deutan")
+    sim.save("chart-deutan.png")
+
+The per-color transform is ``opticquiz_cvd.simulate`` (Machado, Oliveira & Fernandes 2009);
+nothing about the simulation is reimplemented here.
+"""
+
+from opticquiz_cvd import simulate, TYPES
+
+__version__ = "0.1.0"
+__all__ = ["simulate", "simulate_all", "simulate_image", "TYPES"]
+
+
+def simulate_all(color, severity=1.0):
+    """The same color under all three deficiencies, for side-by-side comparison."""
+    return {t: simulate(color, t, severity) for t in TYPES}
+
+
+def _hex_to_rgb(h):
+    n = int(str(h).lstrip("#"), 16)
+    return ((n >> 16) & 255, (n >> 8) & 255, n & 255)
+
+
+def simulate_image(image, type, severity=1.0):
+    """Recolor an image as ``type`` (protan | deutan | tritan) sees it.
+
+    ``image`` is a PIL ``Image`` or a file path. Returns a PIL ``Image`` (RGB or RGBA to match
+    the input). Every distinct color is passed through the engine once via a lookup table, so a
+    photograph is not thousands of redundant calls.
+    """
+    if type not in TYPES:
+        raise ValueError('type must be one of "protan", "deutan", "tritan".')
+    try:
+        import numpy as np
+        from PIL import Image
+    except ImportError as e:  # pragma: no cover
+        raise ImportError(
+            "simulate_image needs Pillow and numpy — `pip install daltoscope[image]`."
+        ) from e
+
+    if isinstance(image, str):
+        image = Image.open(image)
+    has_alpha = image.mode in ("RGBA", "LA", "PA") or "transparency" in image.info
+    rgb = np.asarray(image.convert("RGB"), dtype=np.uint8)
+    alpha = np.asarray(image.convert("RGBA"), dtype=np.uint8)[..., 3] if has_alpha else None
+
+    flat = rgb.reshape(-1, 3)
+    uniq, inverse = np.unique(flat, axis=0, return_inverse=True)
+    mapped = np.empty_like(uniq)
+    for i, (r, g, b) in enumerate(uniq):
+        mapped[i] = _hex_to_rgb(simulate("#%02x%02x%02x" % (r, g, b), type, severity))
+    out = mapped[inverse].reshape(rgb.shape).astype(np.uint8)
+
+    if alpha is not None:
+        out = np.dstack([out, alpha])
+        return Image.fromarray(out, "RGBA")
+    return Image.fromarray(out, "RGB")

daltoscope-0.1.0/daltoscope.egg-info/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: daltoscope
+Version: 0.1.0
+Summary: See a color, a palette, or a whole image as a colorblind person does — recolors for protanopia, deuteranopia, and tritanopia (Machado, Oliveira & Fernandes 2009).
+Author: Vince Gonzalez
+License: MIT
+Project-URL: Homepage, https://opticquiz.com/
+Project-URL: Source, https://github.com/vince-gonzalez/opticquiz.com
+Keywords: colorblind,color-blindness,daltonism,cvd,color-vision-deficiency,simulate,protanopia,deuteranopia,tritanopia,accessibility,a11y,image
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opticquiz-cvd>=1.1.0
+Provides-Extra: image
+Requires-Dist: pillow>=9.0; extra == "image"
+Requires-Dist: numpy>=1.21; extra == "image"
+Dynamic: license-file
+
+# daltoscope
+
+**See a color, a palette, or a whole image the way a colorblind person does.** Where `hueristic`
+*judges* whether colors are safe, `daltoscope` *shows* you — it recolors a hex, or an entire
+PNG/JPEG, as protanopia, deuteranopia, or tritanopia renders it.
+
+```bash
+pip install daltoscope          # colors only
+pip install "daltoscope[image]" # + image recoloring (Pillow, numpy)
+```
+
+```python
+import daltoscope as dalton
+
+dalton.simulate("#d7191c", "deutan")   # "#8a7b0c" — that warning red, to a deuteranope
+dalton.simulate_all("#1a9641")         # {"protan": "#988839", "deutan": "#8a7f48", "tritan": "#009383"}
+
+from PIL import Image
+sim = dalton.simulate_image(Image.open("dashboard.png"), "deutan")
+sim.save("dashboard-deutan.png")
+```
+
+## API
+
+- **`simulate(color, type, severity=1.0)`** → the color as one deficiency sees it, as hex.
+  `type` is `"protan"`, `"deutan"`, or `"tritan"`.
+- **`simulate_all(color, severity=1.0)`** → `{"protan": ..., "deutan": ..., "tritan": ...}`.
+- **`simulate_image(image, type, severity=1.0)`** → a recolored PIL `Image` (alpha preserved).
+  `image` is a PIL `Image` or a file path. `severity` (0..1) shows partial deficiency
+  (anomalous trichromacy), not only the full dichromat case.
+
+## How it works
+
+`daltoscope` is a thin lens over [`opticquiz-cvd`](https://pypi.org/project/opticquiz-cvd/): every
+pixel's transform is that engine's `simulate()`, using the Machado, Oliveira & Fernandes (2009)
+deficiency matrices. `simulate_image` passes each *distinct* color through the engine once via a
+lookup table, so a photograph is not thousands of redundant calls — and there is never a second
+copy of the colorimetry to drift. Method, open access:
+https://doi.org/10.5281/zenodo.21310578
+
+## Not a clinical tool
+
+A simulation for design and communication — it approximates how deficient color vision renders an
+image. It is not a diagnosis, and no on-screen rendering is exact for a given individual.
+
+## Licence
+
+MIT.

daltoscope-0.1.0/daltoscope.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+daltoscope/__init__.py
+daltoscope.egg-info/PKG-INFO
+daltoscope.egg-info/SOURCES.txt
+daltoscope.egg-info/dependency_links.txt
+daltoscope.egg-info/requires.txt
+daltoscope.egg-info/top_level.txt

daltoscope-0.1.0/daltoscope.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

daltoscope-0.1.0/daltoscope.egg-info/requires.txt

@@ -0,0 +1,5 @@
+opticquiz-cvd>=1.1.0
+
+[image]
+pillow>=9.0
+numpy>=1.21

daltoscope-0.1.0/daltoscope.egg-info/top_level.txt

@@ -0,0 +1 @@
+daltoscope

daltoscope-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "daltoscope"
+version = "0.1.0"
+description = "See a color, a palette, or a whole image as a colorblind person does — recolors for protanopia, deuteranopia, and tritanopia (Machado, Oliveira & Fernandes 2009)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Vince Gonzalez" }]
+keywords = [
+    "colorblind", "color-blindness", "daltonism", "cvd", "color-vision-deficiency",
+    "simulate", "protanopia", "deuteranopia", "tritanopia", "accessibility", "a11y", "image",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+dependencies = ["opticquiz-cvd>=1.1.0"]
+
+[project.optional-dependencies]
+image = ["pillow>=9.0", "numpy>=1.21"]
+
+[project.urls]
+Homepage = "https://opticquiz.com/"
+Source = "https://github.com/vince-gonzalez/opticquiz.com"
+
+[tool.setuptools]
+packages = ["daltoscope"]

daltoscope-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+