{"id":19252600,"url":"https://github.com/colour-science/colour-datasets","last_synced_at":"2025-04-06T05:15:55.697Z","repository":{"id":37024516,"uuid":"190873818","full_name":"colour-science/colour-datasets","owner":"colour-science","description":"Colour science datasets for use with Colour","archived":false,"fork":false,"pushed_at":"2024-10-29T00:33:22.000Z","size":1183,"stargazers_count":55,"open_issues_count":1,"forks_count":11,"subscribers_count":8,"default_branch":"develop","last_synced_at":"2024-10-29T21:05:41.564Z","etag":null,"topics":["color","color-science","color-space","color-spaces","colorspace","colorspaces","colour","colour-science","colour-space","colour-spaces","colourspace","colourspaces","data","dataset","datasets","python","spectral-data","spectral-dataset","spectral-datasets"],"latest_commit_sha":null,"homepage":"https://www.colour-science.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/colour-science.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":".github/funding.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":"colour-science","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2019-06-08T10:17:27.000Z","updated_at":"2024-10-21T07:12:00.000Z","dependencies_parsed_at":"2023-11-23T00:02:38.645Z","dependency_job_id":"ff7e2b1a-4bc7-405b-9861-e4d20df61f13","html_url":"https://github.com/colour-science/colour-datasets","commit_stats":{"total_commits":284,"total_committers":2,"mean_commits":142.0,"dds":0.04225352112676062,"last_synced_commit":"37c3e80e506572f984d1fea335d28b328f7c2de6"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-datasets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-datasets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-datasets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-datasets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colour-science","download_url":"https://codeload.github.com/colour-science/colour-datasets/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247436286,"owners_count":20938533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["color","color-science","color-space","color-spaces","colorspace","colorspaces","colour","colour-science","colour-space","colour-spaces","colourspace","colourspaces","data","dataset","datasets","python","spectral-data","spectral-dataset","spectral-datasets"],"created_at":"2024-11-09T18:27:38.195Z","updated_at":"2025-04-06T05:15:55.545Z","avatar_url":"https://github.com/colour-science.png","language":"Python","funding_links":["https://opencollective.com/colour-science"],"categories":["Colorimetry and Vision"],"sub_categories":["Datasets and Resources"],"readme":"Colour - Datasets\n=================\n\n.. start-badges\n\n|actions| |coveralls| |codacy| |version|\n\n.. |actions| image:: https://img.shields.io/github/actions/workflow/status/colour-science/colour-datasets/.github/workflows/continuous-integration-quality-unit-tests.yml?branch=develop\u0026style=flat-square\n    :target: https://github.com/colour-science/colour-datasets/actions\n    :alt: Develop Build Status\n.. |coveralls| image:: http://img.shields.io/coveralls/colour-science/colour-datasets/develop.svg?style=flat-square\n    :target: https://coveralls.io/r/colour-science/colour-datasets\n    :alt: Coverage Status\n.. |codacy| image:: https://img.shields.io/codacy/grade/83345fbde65545d2a4499f32e72866ed/develop.svg?style=flat-square\n    :target: https://app.codacy.com/gh/colour-science/colour-datasets\n    :alt: Code Grade\n.. |version| image:: https://img.shields.io/pypi/v/colour-datasets.svg?style=flat-square\n    :target: https://pypi.org/project/colour-datasets\n    :alt: Package Version\n\n.. end-badges\n\nColour science datasets for use with\n`Colour \u003chttps://github.com/colour-science/colour\u003e`__ or any Python package\nmanipulating colours. The datasets are hosted in `Zenodo \u003chttps://zenodo.org\u003e`__\nunder the\n`Colour Science - Datasets \u003chttps://zenodo.org/communities/colour-science-datasets\u003e`__\ncommunity.\n\nIt is open source and freely available under the\n`BSD-3-Clause \u003chttps://opensource.org/licenses/BSD-3-Clause\u003e`__ terms.\n\n.. contents:: **Table of Contents**\n    :backlinks: none\n    :depth: 2\n\n.. sectnum::\n\nFeatures\n--------\n\n**Colour - Datasets** was created to overcome issues encountered frequently\nwhen trying to access or use colour science datasets:\n\n- No straightforward ingestion path for dataset content.\n- No simple loading mechanism for dataset content.\n- Unavailability of the dataset, e.g., download url is down, dataset content is\n  passed directly from hand to hand.\n- No information regarding the definitive origination of the dataset.\n\n**Colour - Datasets** offers all the above: it allows users to ingest and load\ncolour science datasets with a single function call. The datasets information\nis hosted on `Zenodo \u003chttps://zenodo.org/communities/colour-science-datasets\u003e`__\nwhere the record for a dataset typically contain:\n\n- An *urls.txt* file describing the urls to source the dataset files from.\n- A copy of those files in the eventuality where the source files are not\n  available or the content has changed without notice.\n- Information about the authors, content and licensing.\n\nWhen no explicit licensing information is available, the dataset adopts the\n**Other (Not Open)** licensing scheme, implying that assessing usage conditions\nis at the sole discretion of the users.\n\nExamples\n^^^^^^^^\n\n**Colour - Datasets** can also be used online with\n`Google Colab \u003chttps://colab.research.google.com/notebook#fileId=1YwIfDTBVP3XUYJAyZVEDWj92DJCB0_3v\u0026offline=true\u0026sandboxMode=true\u003e`__.\n\nMost of the objects are available from the ``colour_datasets`` namespace:\n\n.. code-block:: python\n\n    import colour_datasets\n\nThe available datasets are listed with the ``colour_datasets.datasets()``\ndefinition:\n\n.. code-block:: python\n\n    print(colour_datasets.datasets())\n\n.. code-block:: text\n\n    colour-science-datasets\n    =======================\n\n    Datasets : 23\n    Synced   : 1\n    URL      : https://zenodo.org/communities/colour-science-datasets/\n\n    Datasets\n    --------\n\n    [ ] 3269926 : Agfa IT8.7/2 Set - Marszalec (n.d.)\n    [ ] 8314702 : Camera Dataset - Solomatov and Akkaynak (2023)\n    [ ] 3245883 : Camera Spectral Sensitivity Database - Jiang et al. (2013)\n    [ ] 3367463 : Constant Hue Loci Data - Hung and Berns (1995)\n    [ ] 3362536 : Constant Perceived-Hue Data - Ebner and Fairchild (1998)\n    [ ] 3270903 : Corresponding-Colour Datasets - Luo and Rhodes (1999)\n    [ ] 3269920 : Forest Colors - Jaaskelainen et al. (1994)\n    [ ] 4394536 : LUTCHI Colour Appearance Data - Luo and Rhodes (1997)\n    [x] 3245875 : Labsphere SRS-99-020 - Labsphere (2019)\n    [ ] 3269924 : Lumber Spectra - Hiltunen (n.d.)\n    [ ] 4051012 : Measured Commercial LED Spectra - Brendel (2020)\n    [ ] 3269918 : Munsell Colors Glossy (All) (Spectrofotometer Measured) - Orava (n.d.)\n    [ ] 3269916 : Munsell Colors Glossy (Spectrofotometer Measured) - Haanpalo (n.d.)\n    [ ] 3269914 : Munsell Colors Matt (AOTF Measured) - Hauta-Kasari (n.d.)\n    [ ] 3269912 : Munsell Colors Matt (Spectrofotometer Measured) - Hauta-Kasari (n.d.)\n    [ ] 3245895 : New Color Specifications for ColorChecker SG and Classic Charts - X-Rite (2016)\n    [ ] 3252742 : Observer Function Database - Asano (2015)\n    [ ] 3269922 : Paper Spectra - Haanpalo (n.d.)\n    [ ] 6590768 : Physlight - Camera Spectral Sensitivity Curves - Winquist et al. (2022)\n    [ ] 3372171 : RAW to ACES Utility Data - Dyer et al. (2017)\n    [ ] 4642271 : Spectral Database of Commonly Used Cine Lighting - Karge et al. (2015)\n    [ ] 4297288 : Spectral Sensitivity Database - Zhao et al. (2009)\n    [ ] 4050598 : Spectral Upsampling Coefficient Tables - Jakob and Hanika. (2019)\n\nA ticked checkbox means that the particular dataset has been synced locally.\nA dataset is loaded by using its unique number: *3245895*:\n\n.. code-block:: python\n\n    print(colour_datasets.load(\"3245895\").keys())\n\n::\n\n    Pulling \"New Color Specifications for ColorChecker SG and Classic Charts\" record content...\n    Downloading \"urls.txt\" file: 8.19kB [00:01, 5.05kB/s]\n    Downloading \"ColorChecker24_After_Nov2014.zip\" file: 8.19kB [00:01, 6.52kB/s]\n    Downloading \"ColorChecker24_Before_Nov2014.zip\" file: 8.19kB [00:01, 7.66kB/s]\n    Downloading \"ColorCheckerSG_After_Nov2014.zip\" file: 8.19kB [00:01, 7.62kB/s]\n    Downloading \"ColorCheckerSG_Before_Nov2014.zip\" file: 8.19kB [00:00, 9.39kB/s]\n    Unpacking \"/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorCheckerSG_Before_Nov2014.zip\" archive...\n    Unpacking \"/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorCheckerSG_After_Nov2014.zip\" archive...\n    Unpacking \"/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorChecker24_After_Nov2014.zip\" archive...\n    Unpacking \"/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorChecker24_Before_Nov2014.zip\" archive...\n    odict_keys(['ColorChecker24 - After November 2014', 'ColorChecker24 - Before November 2014', 'ColorCheckerSG - After November 2014', 'ColorCheckerSG - Before November 2014'])\n\nAlternatively, a dataset can be loaded by using its full title:\n*New Color Specifications for ColorChecker SG and Classic Chart - X-Rite (2016)s*\n\n.. code-block:: python\n\n    print(colour_datasets.load(\"3245895\").keys())\n\n.. code-block:: text\n\n    odict_keys(['ColorChecker24 - After November 2014', 'ColorChecker24 - Before November 2014', 'ColorCheckerSG - After November 2014', 'ColorCheckerSG - Before November 2014'])\n\nUser Guide\n----------\n\nInstallation\n^^^^^^^^^^^^\n\nPrimary Dependencies\n~~~~~~~~~~~~~~~~~~~~\n\n**Colour - Datasets** requires various dependencies in order to run:\n\n- `python \u003e= 3.10, \u003c 3.14 \u003chttps://www.python.org/download/releases\u003e`__\n- `cachetools \u003chttps://pypi.org/project/cachetools\u003e`__\n- `colour-science \u003e= 4.5 \u003chttps://pypi.org/project/colour-science\u003e`__\n- `imageio \u003e= 2, \u003c 3 \u003chttps://imageio.github.io\u003e`__\n- `numpy \u003e= 1.24, \u003c 3 \u003chttps://pypi.org/project/numpy\u003e`__\n- `scipy \u003e= 1.10, \u003c 2 \u003chttps://pypi.org/project/scipy\u003e`__\n- `tqdm \u003chttps://pypi.org/project/tqdm\u003e`__\n- `xlrd \u003e=1.2, \u003c2 \u003chttps://pypi.org/project/xlrd\u003e`__\n\nPypi\n~~~~\n\nOnce the dependencies are satisfied, **Colour - Datasets** can be installed from\nthe `Python Package Index \u003chttp://pypi.python.org/pypi/colour-datasets\u003e`__ by\nissuing this command in a shell::\n\n    pip install --user colour-datasets\n\nThe overall development dependencies are installed as follows::\n\n    pip install --user 'colour-datasets[development]'\n\nContributing\n^^^^^^^^^^^^\n\nIf you would like to contribute to `Colour - Datasets \u003chttps://github.com/colour-science/colour-datasets\u003e`__,\nplease refer to the following `Contributing \u003chttps://www.colour-science.org/contributing\u003e`__\nguide for `Colour \u003chttps://github.com/colour-science/colour\u003e`__.\n\nBibliography\n^^^^^^^^^^^^\n\nThe bibliography is available in the repository in\n`BibTeX \u003chttps://github.com/colour-science/colour-datasets/blob/develop/BIBLIOGRAPHY.bib\u003e`__\nformat.\n\nAPI Reference\n-------------\n\nThe main technical reference for `Colour - Datasets \u003chttps://github.com/colour-science/colour-datasets\u003e`__\nis the `API Reference \u003chttps://colour-datasets.readthedocs.io/en/latest/reference.html\u003e`__.\n\nCode of Conduct\n---------------\n\nThe *Code of Conduct*, adapted from the `Contributor Covenant 1.4 \u003chttps://www.contributor-covenant.org/version/1/4/code-of-conduct.html\u003e`__,\nis available on the `Code of Conduct \u003chttps://www.colour-science.org/code-of-conduct\u003e`__ page.\n\nContact \u0026 Social\n----------------\n\nThe *Colour Developers* can be reached via different means:\n\n- `Email \u003cmailto:colour-developers@colour-science.org\u003e`__\n- `Facebook \u003chttps://www.facebook.com/python.colour.science\u003e`__\n- `Github Discussions \u003chttps://github.com/colour-science/colour-datasets/discussions\u003e`__\n- `Gitter \u003chttps://gitter.im/colour-science/colour\u003e`__\n- `X \u003chttps://x.com/colour_science\u003e`__\n- `Bluesky \u003chttps://bsky.app/profile/colour-science.bsky.social\u003e`__\n\nAbout\n-----\n\n| **Colour - Datasets** by Colour Developers\n| Copyright 2019 Colour Developers – `colour-developers@colour-science.org \u003ccolour-developers@colour-science.org\u003e`__\n| This software is released under terms of BSD-3-Clause: https://opensource.org/licenses/BSD-3-Clause\n| `https://github.com/colour-science/colour-datasets \u003chttps://github.com/colour-science/colour-datasets\u003e`__\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolour-science%2Fcolour-datasets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolour-science%2Fcolour-datasets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolour-science%2Fcolour-datasets/lists"}