1 Colour - Datasets¶
It is open source and freely available under the New BSD License terms.
Table of Contents
Colour - Datasets was created to overcome issues encountered frequently when trying to access or use colour science datasets:
No straightforward ingestion path for dataset content.
No simple loading mechanism for dataset content.
Unavailability of the dataset, e.g. download url is down, dataset content is passed directly from hand to hand.
No information regarding the definitive origination of the dataset.
Colour - Datasets offers all the above: it allows users to ingest and load colour science datasets with a single function call. The datasets information is hosted on Zenodo where the record for a dataset typically contain:
An urls.txt file describing the urls to source the dataset files from.
A copy of those files in the eventuality where the source files are not available or the content has changed without notice.
Information about the authors, content and licensing.
When no explicit licensing information is available, the dataset adopts the Other (Not Open) licensing scheme, implying that assessing usage conditions is at the sole discretion of the users.
1.3.1 Primary Dependencies¶
Colour - Datasets requires various dependencies in order to run:
Once the dependencies satisfied, Colour - Datasets can be installed from the Python Package Index by issuing this command in a shell:
pip install colour-datasets
The tests suite dependencies are installed as follows:
pip install 'colour-datasets[tests]'
The documentation building dependencies are installed as follows:
pip install 'colour-datasets[docs]'
The overall development dependencies are installed as follows:
pip install 'colour-datasets[development]'
The main reference for Colour - Datasets is the manual:
Most of the objects are available from the
>>> import colour_datasets
The available datasets are listed with the
colour-science-datasets ======================= Datasets : 16 Synced : 1 URL : https://zenodo.org/communities/colour-science-datasets/ Datasets -------- [ ] 3269926 : Agfa IT8.7/2 Set [ ] 3245883 : Camera Spectral Sensitivity Database [ ] 3367463 : Constant Hue Loci Data [ ] 3362536 : Constant Perceived-Hue Data [ ] 3270903 : Corresponding-Colour Datasets [ ] 3269920 : Forest Colors [x] 3245875 : Labsphere SRS-99-020 [ ] 3269924 : Lumber Spectra [ ] 3269918 : Munsell Colors Glossy (All) (Spectrofotometer Measured) [ ] 3269916 : Munsell Colors Glossy (Spectrofotometer Measured) [ ] 3269914 : Munsell Colors Matt (AOTF Measured) [ ] 3269912 : Munsell Colors Matt (Spectrofotometer Measured) [ ] 3245895 : New Color Specifications for ColorChecker SG and Classic Charts [ ] 3252742 : Observer Function Database [ ] 3269922 : Paper Spectra [ ] 3372171 : RAW to ACES Utility Data
A ticked checkbox means that the particular dataset has been synced locally. A dataset is loaded by using its unique number: 3245895:
Pulling "New Color Specifications for ColorChecker SG and Classic Charts" record content... Downloading "urls.txt" file: 8.19kB [00:01, 5.05kB/s] Downloading "ColorChecker24_After_Nov2014.zip" file: 8.19kB [00:01, 6.52kB/s] Downloading "ColorChecker24_Before_Nov2014.zip" file: 8.19kB [00:01, 7.66kB/s] Downloading "ColorCheckerSG_After_Nov2014.zip" file: 8.19kB [00:01, 7.62kB/s] Downloading "ColorCheckerSG_Before_Nov2014.zip" file: 8.19kB [00:00, 9.39kB/s] Unpacking "/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorCheckerSG_Before_Nov2014.zip" archive... Unpacking "/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorCheckerSG_After_Nov2014.zip" archive... Unpacking "/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorChecker24_After_Nov2014.zip" archive... Unpacking "/Users/kelsolaar/.colour-science/colour-datasets/3245895/dataset/ColorChecker24_Before_Nov2014.zip" archive... odict_keys(['ColorChecker24 - After November 2014', 'ColorChecker24 - Before November 2014', 'ColorCheckerSG - After November 2014', 'ColorCheckerSG - Before November 2014'])
Alternatively, a dataset can be loaded by using its full title: New Color Specifications for ColorChecker SG and Classic Charts
>>> print(colour_datasets.load('3245895').keys()) odict_keys(['ColorChecker24 - After November 2014', 'ColorChecker24 - Before November 2014', 'ColorCheckerSG - After November 2014', 'ColorCheckerSG - Before November 2014'])