CDC - Color Distance Calculator
CDC can be a useful tool if you want to locate objects in an image / orthomosaic with a certain color. The tool can be used to go from this input image
To this output image
To learn more about the tool, take a look at the tutorial.
Table of contents:
Installation
CDC is a python package and can be installed with pip.
pip install CDC
For more advanced installation, please visit the Documentation for more information.
Usage
For a tutorial of how to use CDC on a test dataset, please see Tutorial.
How to make a reference image and mask
The easiest way to make a reference image is to use your preferred GIS image tool (like QGIS) to extract a small region from the orthomosaic. To make the mask open the reference image in an image editor and use the pen tool to mark all the desired pixels with red ((255, 0, 0) in RGB).
Run CDC
To run CDC on an orthomosaic, run the following in a terminal window:
CDC path/to/orthomosaic path/to/reference_image path/to/mask_image
Run CDC --help for more information or see the Documentation.
Documentation
For a full list of command line arguments see CLI. For a reference manual, please visit Reference Manual
Contributing
For contribution guidelines, please see the Documentation.
License
The software is licensed under the BSD-3-Clause license, see License.
Acknowledgement
the CDC tool was developed by SDU UAS Center as part of the project Præcisionsfrøavl, that was supported by the Green Development and Demonstration Programme (GUDP) and Frøafgiftsfonden both from Denmark.
Metadata
Release files for CDC 1.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cdc-1.1.4.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cdc-1.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.2 MB
Release files / cdc-1.1.4.tar.gz
| Download URL | cdc-1.1.4.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3204b47d00a7f23b1a3b9a30bdc56d6f9bcbef69754afe620dd25bfd7e4a902a
|
|
BLAKE2b-256 checksum How to use checksums |
d33feae2e267b03a482baa4246a9d6335a571798b71ebcd7888c5a1b76e88118
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 4, 2026.
Transparency logRelease files / cdc-1.1.4-py3-none-any.whl
| Download URL | cdc-1.1.4-py3-none-any.whl |
|---|---|
| Size | 16.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
11d473f0ff7b7e5301870fa9cf7874c71899cd2af6185159316c3bfe558d1655
|
|
BLAKE2b-256 checksum How to use checksums |
f3377105edbee109e0a54b3854a4a4ee2a8f1c050533f95fc90c2a552c01588c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 4, 2026.
Transparency log