Skip to main content

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

Image

To this output image

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)

Source distribution for CDC 1.1.4
File Size Uploaded
cdc-1.1.4.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for CDC 1.1.4
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

1.1.4 This release

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.4

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page