{"id":15048034,"url":"https://github.com/diplib/diplib","last_synced_at":"2025-05-15T09:00:38.439Z","repository":{"id":37735633,"uuid":"85657877","full_name":"DIPlib/diplib","owner":"DIPlib","description":"Quantitative Image Analysis in C++, MATLAB and Python","archived":false,"fork":false,"pushed_at":"2025-03-16T03:24:55.000Z","size":31481,"stargazers_count":239,"open_issues_count":19,"forks_count":53,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-04-07T04:09:40.236Z","etag":null,"topics":["bio-formats","cpp","cpp14","dipimage","diplib","filtering","image-analysis","image-processing","image-viewer","mathematical-morphology","matlab","python","python3","quantification","quantitative-image-analysis"],"latest_commit_sha":null,"homepage":"https://diplib.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DIPlib.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs/dipimage_3.0.0.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"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}},"created_at":"2017-03-21T04:07:31.000Z","updated_at":"2025-04-02T10:04:04.000Z","dependencies_parsed_at":"2023-10-03T07:53:27.647Z","dependency_job_id":"a8c278bb-0e7f-459a-893a-7938d9d954f2","html_url":"https://github.com/DIPlib/diplib","commit_stats":{"total_commits":2632,"total_committers":20,"mean_commits":131.6,"dds":"0.17439209726443772","last_synced_commit":"b4d3d158b1897f5da579f189a3251761aac80c79"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DIPlib%2Fdiplib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DIPlib%2Fdiplib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DIPlib%2Fdiplib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DIPlib%2Fdiplib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DIPlib","download_url":"https://codeload.github.com/DIPlib/diplib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248890474,"owners_count":21178436,"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":["bio-formats","cpp","cpp14","dipimage","diplib","filtering","image-analysis","image-processing","image-viewer","mathematical-morphology","matlab","python","python3","quantification","quantitative-image-analysis"],"created_at":"2024-09-24T21:07:13.568Z","updated_at":"2025-04-14T13:45:25.224Z","avatar_url":"https://github.com/DIPlib.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# *DIPlib 3*\n\n[![Build Status](https://github.com/DIPlib/diplib/actions/workflows/cmake.yml/badge.svg?branch=master)](https://github.com/DIPlib/diplib/actions/workflows/cmake.yml)\n[![CodeQL](https://github.com/DIPlib/diplib/actions/workflows/codeql.yml/badge.svg?branch=master)](https://github.com/DIPlib/diplib/security/code-scanning)\n\nThe *DIPlib* project contains:\n\n- **[*DIPlib*](https://diplib.org/diplib-docs/)**, a C++ library for quantitative image analysis.\nIt has been in development at Delft University of Technology in The Netherlands since 1995.\nThe 3.0 release of *DIPlib* represented a complete rewrite in modern C++ of the library infrastructure,\nwith most of the image processing and analysis algorithms ported from the previous version,\nand some of them improved significantly.\nRead [the *DIPlib* documentation](https://diplib.org/diplib-docs/).\n\n- **[*DIPimage*](https://diplib.org/DIPimage.html)**, a *MATLAB* toolbox for quantitative\nimage analysis. It has been in development at Delft University of Technology in The Netherlands since 1999.\nRead [the *DIPimage* User Manual](https://diplib.org/diplib-docs/dipimage_user_manual.html).\n\n- **[*PyDIP*](https://diplib.org/PyDIP.html)**, *Python* bindings to *DIPlib*.\nThis is currently a thin wrapper that exposes the C++ functionality with little change.\nRead [the *PyDIP* User Manual](https://diplib.org/diplib-docs/pydip_user_manual.html).\n\n- ***DIPviewer***, an interactive image display utility. It is usable from C++, *Python* and *MATLAB* programs.\nWithin *DIPimage* this is an optional alternative to the default *MATLAB*-native interactive display utility.\nRead [the *DIPviewer* documentation](https://diplib.org/diplib-docs/dipviewer.html).\n\n- ***DIPjavaio***, an interface to\n[*OME Bio-Formats*](https://www.openmicroscopy.org/bio-formats/), a Java-based library that reads\nhundreds of image file formats. This module is usable from C++ and *Python* (*DIPimage* interfaces\nto *Bio-Formats* natively).\nRead [the *DIPjavaio* documentation](https://diplib.org/diplib-docs/dipjavaio.html)\n\nSee [the *DIPlib* website](https://diplib.org/) for more information.\n\n\n## Building and using the project\n\nTo build the library you will need a C++14 compliant compiler and *CMake*.\nSee [Building the *DIPlib* library](https://diplib.org/diplib-docs/building_diplib.html) for detailed instructions.\n\nWhen linking against the *DIPlib* library without using *CMake*, it is important to set a few preprocessor\nmacros. See [Linking against the *DIPlib* library](https://diplib.org/diplib-docs/building_diplib.html#linking_diplib)\nfor details.\n\n\n## Contributing\n\n### Reporting a bug\n\nWe use the [issue tracker on GitHub](https://github.com/DIPlib/diplib/issues) to manage bug reports.\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md) for instructions on how to report a bug.\n\n### Bug fixes, algorithm improvements, new algorithms\n\nFeel free to submit a [pull request on GitHub](https://github.com/DIPlib/diplib/pulls). Please follow\nour [style guide](https://diplib.org/diplib-docs/styleguide.html) and make sure to read\n[`CONTRIBUTING.md`](CONTRIBUTING.md) first.\n\n### Documentation, tutorials\n\nDocumentation can always be improved (also, *PyDIP* has hardly any at all!). If you want to help write documentation,\nor create tutorials for how to use the library, read [`CONTRIBUTING.md`](CONTRIBUTING.md), then submit a\n[pull request on GitHub](https://github.com/DIPlib/diplib/pulls).\n\nIf you found an error in the documentation, we consider this a bug. See above how to report it.\n\n\n## License\n\nCopyright 2014-2024 Cris Luengo and contributors  \nCopyright 1995-2014 Delft University of Technology\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this library except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0  \n   (or see the [`LICENSE.txt`](LICENSE.txt) file in this distribution)\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n*DIPlib* includes the following libraries / external code:\n\n- *Eigen 3*  \n  Copyright 2008 Gael Guennebaud  \n  Copyright 2007-2011 Benoit Jacob  \n  Mozilla Public License Version 2.0  \n  see [`dependencies/eigen3/LICENSE.txt`](dependencies/eigen3/LICENSE.txt)  \n  (we do not use any of the components with more restrictive licenses)\n\n- *DocTest* (its use can be disabled)  \n  Copyright 2016-2023 Viktor Kirilov  \n  MIT License  \n  see [`dependencies/doctest/LICENSE.txt`](dependencies/doctest/LICENSE.txt)\n\n- *PocketFFT*  \n  Copyright 2010-2021 Max-Planck-Society  \n  Copyright 2019-2020 Peter Bell  \n  3-Clause BSD License  \n  see [`dependencies/pocketfft/LICENSE.md`](dependencies/pocketfft/LICENSE.md)\n\n- *PCG Random Number Generation for C++*  \n  Copyright 2014-2022 Melissa O'Neill and the PCG Project contributors  \n  Apache 2.0 License, or The MIT License, at your option  \n  see [`include/diplib/private/pcg_*.hpp`](include/diplib/private/pcg_random.hpp)\n\n- *robin-map*, a fast hash map and hash set  \n  Copyright 2017 Thibaut Goetghebuer-Planchon  \n  MIT License  \n  see [`include/diplib/private/robin_*.h`](include/diplib/private/robin_map.h)\n\n- A fast 2D labeling algorithm out of *YACCLAB*  \n  Copyright 2016-2017 Costantino Grana, Federico Bolelli, Lorenzo Baraldi and Roberto Vezzani  \n  3-Clause BSD License  \n  see [`src/regions/labelingGrana2016.h`](src/regions/labelingGrana2016.h)\n\n- A few color maps from *colorcet*  \n  Copyright 2017 Peter Kovesi  \n  1-Clause BSD-like License  \n  see [`src/display/colormap.cpp`](src/display/colormap.cpp) (about half-way down the file)\n\n- Glyph images obtained by rendering the *Open Sans* font  \n  Unknown copyright, designed by Steve Matteson  \n  Apache 2.0 License  \n  see [`src/generation/draw_text_builtin.cpp`](src/generation/draw_text_builtin.cpp) or [Google Fonts](https://fonts.google.com/specimen/Open+Sans#about)\n \n- *libics* (its use can be disabled)  \n  Copyright 2015-2017 Scientific Volume Imaging Holding B.V.  \n  Copyright 2000-2013 Cris Luengo and others  \n  GNU Lesser General Public License, Version 2.1  \n  see [`dependencies/libics/GNU_LICENSE`](dependencies/libics/GNU_LICENSE)\n\n- *LibTIFF* (its use can be disabled)  \n  Copyright 1988-1997 Sam Leffler  \n  Copyright 1991-1997 Silicon Graphics, Inc.  \n  2-Clause BSD-like Licence  \n  see [`dependencies/libtiff/COPYRIGHT`](dependencies/libtiff/COPYRIGHT)\n\n- *libjpeg* (its use can be disabled)  \n  Copyright 1991-2018, Thomas G. Lane, Guido Vollbeding  \n  Custom BSD-like Licence  \n  see [`dependencies/libjpeg/README`](dependencies/libjpeg/README)\n\n- *libspng* (its use can be disabled)  \n  Copyright 2018-2023, Randy  \n  2-Clause BSD-like Licence  \n  see [`dependencies/libspng/LICENSE`](dependencies/libspng/LICENSE)\n\n- *zlib* (used by *libics*, *LibTIFF* and *libspng*, its use can be disabled)  \n  Copyright 1995-2022 Jean-loup Gailly and Mark Adler  \n  zlib Licence  \n  see [`dependencies/zlib/LICENSE`](dependencies/zlib/LICENSE)\n\n- *pybind11* (only used in the *Python* bindings)  \n  Copyright 2016 Wenzel Jakob  \n  3-Clause BSD License  \n  see [`dependencies/pybind11/LICENSE`](dependencies/pybind11/LICENSE)\n\n- *python-javabridge* (only used in the *Python* bindings)  \n  Copyright 2003-2009 Massachusetts Institute of Technology  \n  Copyright 2009-2013 Broad Institute  \n  3-Clause BSD License  \n  see [`pydip/src/loadjvm.py`](pydip/src/loadjvm.py)\n\n- A few *MATLAB* scripts from *OME Bio-Formats* (used in *DIPimage*)  \n  Copyright 2012-2021 Open Microscopy Environment  \n  2-Clause BSD License  \n  see [`dipimage/private/bf*.m`](dipimage/private/bfGetReader.m)  \n  (the full *Bio-Formats* library needs to be installed for these to be useful)\n\n- A few Java files from *OME Bio-Formats* (used only to resolve references during the build\n  process of *DIPjavaio*, not used otherwise)  \n  Copyright (C) 2005 - 2017 Open Microscopy Environment  \n  2-Clause BSD License  \n  see [`javaio/java/bioformats/readme.md`](javaio/java/bioformats/readme.md)  \n  (the full *Bio-Formats* library needs to be installed to use *DIPjavaio*)\n\n- Modified HTML templates and CSS files from *dox++*, which originally came from *m.css* (for documentation)  \n  Copyright 2020-2021, Cris Luengo  \n  Copyright 2017-2020 Vladimír Vondruš  \n  MIT License\n\nNote that all of these have permissive open-source licenses similar in spirit\nto the Apache License.\n\n*DIPlib* also optionally links against:\n\n- *FFTW3* (as installed on your system, not used by default)  \n  Copyright 2003, 2007-14 Matteo Frigo  \n  Copyright 2003, 2007-14 Massachusetts Institute of Technology  \n  GNU General Public License, Version 2 (**not compatible with the Apache License**)\n\n- *FreeType 2* (as installed on your system, not used by default)  \n  Copyright 1996-2021 David Turner, Robert Wilhelm, and Werner Lemberg  \n  FreeType License (BSD style)\n\n*DIPviewer* links against the following libraries:\n\n- *FreeGLUT* (as installed on your system, alternative to *GLFW*)  \n  Copyright 1999-2000 Pawel W. Olszta  \n  X-Consortium license\n\n- *GLFW* (as installed on your system, alternative to *FreeGLUT*)  \n  Copyright 2002-2006 Marcus Geelnard  \n  Copyright 2006-2011 Camilla Berglund  \n  BSD-like license\n\n- *OpenGL* (as installed on your system)  \n  (free from licensing requirements)\n\n*DIPjavaio* links against:\n\n- *JDK 8* (as installed on your system)  \n  Copyright, probably Sun and/or Oracle  \n  GNU General Public License, Version 2 (**not compatible with the Apache License**)\n\n- *OME Bio-Formats* (optional, as installed on your system)  \n  Copyright 2012-2017 Open Microscopy Environment  \n  GNU General Public License, Version 2 (**not compatible with the Apache License**)\n\nNote that [*OME Bio-Formats*](https://www.openmicroscopy.org/bio-formats/) is optional,\nbut *DIPjavaio* is currently useless without it.\nThe *DIPjavaio* sources provided with this project are shared under the same licence\nas the rest of the project (Apache 2.0), but by linking with *Bio-Formats*, your\nwhole program will become GPL. This module is not suitable for use in commercial,\nclosed-source software.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiplib%2Fdiplib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiplib%2Fdiplib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiplib%2Fdiplib/lists"}