MCCNN

MCCNN neural network for stereo matching cost.

Overview • Install • Usage • Pretrained Weights for MCCNN networks • Related • References

Overview

Pytorch implementation of [MCCNN] neural network which computes a similarity measure on pair of small image patches.

Install from Pypi

MCCNN is available on Pypi and can be installed by:

pip install MCCNN

Developer install

After cloning source code from repository, do a local pip install in a virtualenv through MCCNN Makefile:

make install

PyTorch is an optional dependency. If your work requires it (e.g. training or running neural networks, or loading .pt weight files), install the torch extras group:

make install-torch

or

pip install .[torch]

Note: If you do not need PyTorch, the base make install is sufficient.

Usage

Documentation explains how to train and use MCCNN convolutional neural network. To generate it, please execute the following commands:

make docs

Let's see pandora_plugin_mccnn for real life example.

Pretrained Weights for MCCNN networks

Download weights files

Pretrained weights for mc-cnn fast and mc-cnn accurate neural networks are available in the weights directory :

  • mc_cnn_fast_mb_weights.pt and mc_cnn_accurate_mb_weights.pt are the PyTorch weights of the pretrained networks on the Middlebury dataset [Middlebury]
  • mc_cnn_fast_data_fusion_contest.pt and mc_cnn_accurate_data_fusion_contest.pt are the PyTorch weights of the pretrained networks on the Data Fusion Contest dataset [DFC]
  • mc_cnn_fast_int8_excl_01.onnx and mc_cnn_fast_dw.onnx are the ONNX weights of the pretrained networks on the Middlebury dataset [Middlebury]

To download the pretrained weights:

wget https://raw.githubusercontent.com/CNES/Pandora_MCCNN/master/src/mc_cnn/weights/mc_cnn_fast_mb_weights.pt
wget https://raw.githubusercontent.com/CNES/Pandora_MCCNN/master/src/mc_cnn/weights/mc_cnn_fast_data_fusion_contest.pt
wget https://raw.githubusercontent.com/CNES/Pandora_MCCNN/master/src/mc_cnn/weights/mc_cnn_accurate_mb_weights.pt
wget https://raw.githubusercontent.com/CNES/Pandora_MCCNN/master/src/mc_cnn/weights/mc_cnn_accurate_data_fusion_contest.pt
wget https://raw.githubusercontent.com/CNES/Pandora_MCCNN/master/src/mc_cnn/weights/mc_cnn_fast_int8_excl_01.onnx
wget https://raw.githubusercontent.com/CNES/Pandora_MCCNN/master/src/mc_cnn/weights/mc_cnn_fast_dw.onnx

Access weights from pip package

Pretrained weights are stored into the pip package and downloaded for any installation of mc_cnn pip package. To access it, use the weights submodule :

from mc_cnn.weights import get_weights, get_onnx
mc_cnn_fast_mb_weights_path = get_weights(arch="fast", training_dataset="middlebury")
mc_cnn_fast_data_fusion_contest_path = get_weights(arch="fast", training_dataset="dfc")
mc_cnn_accurate_mb_weights_path = get_weights(arch="accurate", training_dataset="middlebury")
mc_cnn_accurate_data_fusion_contest = get_weights(arch="accurate", training_dataset="dfc")
onnx_mc_cnn_fast_int_8_mb_weights_path = get_onnx(arch="onnx_fast_int8", training_dataset="middlebury")
onnx_mc_cnn_fast_dw_mb_weights_path = get_onnx(arch="onnx_fast_dw", training_dataset="middlebury")

References

Please cite the following paper when using MCCNN:

Defonte, V., Dumas, L., Cournet, M., & Sarrazin, E. (2021, July). Evaluation of MC-CNN Based Stereo Matching Pipeline for the CO3D Earth Observation Program. In 2021 IEEE International Geoscience and Remote Sensing Symposium IGARSS (pp. 7670-7673). IEEE.

Cournet, M., Sarrazin, E., Dumas, L., Michel, J., Guinet, J., Youssefi, D., Defonte, V., Fardet, Q., 2020. Ground-truth generation and disparity estimation for optical satellite imagery. ISPRS - International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences.

[MCCNN] Zbontar, J., & LeCun, Y. (2016). Stereo matching by training a convolutional neural network to compare image patches. J. Mach. Learn. Res., 17(1), 2287-2318.

[Middlebury] Scharstein, D., Hirschmüller, H., Kitajima, Y., Krathwohl, G., Nešić, N., Wang, X., & Westling, P. (2014, September). High-resolution stereo datasets with subpixel-accurate ground truth. In German conference on pattern recognition (pp. 31-42). Springer, Cham.

[DFC] Bosch, M., Foster, K., Christie, G., Wang, S., Hager, G. D., & Brown, M. (2019, January). Semantic stereo for incidental satellite images. In 2019 IEEE Winter Conference on Applications of Computer Vision (WACV) (pp. 1524-1532). IEEE.

Project links

Data verified by PyPI on Aug 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

6 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for alexandre-constantin from gravatar.com alexandre-constantin Avatar for cars-cnes from gravatar.com cars-cnes Avatar for duboise from gravatar.com duboise
+3 more Avatar for esarrazin from gravatar.com esarrazin Avatar for mleconte from gravatar.com mleconte Avatar for qfardet from gravatar.com qfardet

Credits

Author: CNES

GitHub Statistics

Data verified by PyPI on Aug 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache License

Requires

Python >=3.10

Provides Extra

dev test docs torch

Tags

3D IA DEM pandora correlation cars photogrammetry

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mccnn-1.4.1.tar.gz (30.3 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

mccnn-1.4.1-cp313-cp313-win_amd64.whl (16.0 MB view details)

Uploaded CPython 3.13Windows x86-64

mccnn-1.4.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (15.1 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mccnn-1.4.1-cp312-cp312-win_amd64.whl (16.0 MB view details)

Uploaded CPython 3.12Windows x86-64

mccnn-1.4.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (15.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mccnn-1.4.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (15.1 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mccnn-1.4.1-cp310-cp310-win_amd64.whl (16.0 MB view details)

Uploaded CPython 3.10Windows x86-64

mccnn-1.4.1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (15.1 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

File details

Details for the file mccnn-1.4.1.tar.gz.

File metadata

  • Download URL: mccnn-1.4.1.tar.gz
  • Upload date:
  • Size: 30.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mccnn-1.4.1.tar.gz
Algorithm Hash digest
SHA256 e697974b6e0cc1b298b2e67d8db11e24672f500026ea1b49241da49127e1de23
MD5 a06be92f393b31de94a8f5747db27ed5
BLAKE2b-256 07f55faef1f1ac49f625fe708ff712cdb5ef268c164ef049f2a7cbbd8ba183be

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1.tar.gz:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: mccnn-1.4.1-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 16.0 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mccnn-1.4.1-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 a55475373e32f99849f0639da828044f2671e3ce84fb102effd54efdec832bdb
MD5 844b01518a468fcdd90c1973758508ff
BLAKE2b-256 f19fb0bb6da7242b9c0f264ec0afcea94f7e664d2c3750f4b3d4bcf953a7c306

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp313-cp313-win_amd64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mccnn-1.4.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 ee339ea19edd2b18cc3d80f83298df9f5058b34c40ed9195f136b87a55beb9ae
MD5 12907fd9effda3ccc92f2513fa8bb872
BLAKE2b-256 2f53f139b8c2a8e68b9b7456f4cf34653df07b8ea47e7a079f7be4749b4bbb36

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: mccnn-1.4.1-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 16.0 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mccnn-1.4.1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 66ab7b535e541a0bf7eba4c39cceceab6db342062729b31d15412486960868d5
MD5 2864b6800210ece0b21792d513b30e5c
BLAKE2b-256 488bcd88e2ead36ca267c22bef1b13fe83cfd50c7523e3cb8c35a551d5f12098

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp312-cp312-win_amd64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mccnn-1.4.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 b3e530a26b8951d66fb2d45314f5eddf4c4174d33ac3415e552ea12c6a4d4ad0
MD5 d56ff81f3fe405392b0c3ae3b8acc28e
BLAKE2b-256 9d726619bde2a718fb0ea977a8dab023a2a943529fc29ca55878ccb829b553f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mccnn-1.4.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 bb4de5d72256c8d3e72f75db6bd215bbcea39bef57472da6914f030b1e50a658
MD5 c387076bcc71ffc1b259ce556fe9be51
BLAKE2b-256 6cfa1777b3acdaf71b749237093f161e0a52ed0d57eba4ff650660040351340d

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: mccnn-1.4.1-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 16.0 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mccnn-1.4.1-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 81b61bd83365b0e51887261c51cb5a5a6461a1d49e2712eb6b5b0743b2bf7798
MD5 7cc0382943f38ec51c66227c55f32c67
BLAKE2b-256 1abcaa3c3465a62e31f76a599aab35628c8edb78d7cff2e32683a17a506b03cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp310-cp310-win_amd64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccnn-1.4.1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mccnn-1.4.1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 876c64d41002e17c3137616a0b4fca2e9a826fe2dfd024e44f509b6e25e45c85
MD5 c37e4964d484d18f974d3d1ca279b1ee
BLAKE2b-256 7482fe4d0379b0c40f08d2e867967c8f932725bb02e783e964a3ac34f6a73f83

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccnn-1.4.1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: mccnn_ci.yml on CNES/Pandora_MCCNN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.4.1 This release

8 files

Pre-release

1.4.1a1

3 files

1.4.0

5 files

Pre-release

1.4.0a1

3 files

1.3.0

1 file

Pre-release

1.3.0a1

1 file

1.2.5

1 file

Pre-release

1.2.5a1

1 file

1.2.4

1 file

Pre-release

1.2.4a1

1 file

1.2.3

1 file

Pre-release

1.2.3a1

1 file

1.2.2

1 file

1.2.1

1 file

1.2.0

1 file

1.1.0

1 file

1.0.1

1 file

1.0.0

1 file

0.0.0

1 file

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