{"id":16569946,"url":"https://github.com/imagingbook/imagingbook-public","last_synced_at":"2025-10-29T01:30:21.555Z","repository":{"id":37444750,"uuid":"483930820","full_name":"imagingbook/imagingbook-public","owner":"imagingbook","description":"Image processing software for textbooks by W. Burger \u0026 M. Burge","archived":false,"fork":false,"pushed_at":"2023-05-11T14:00:27.000Z","size":84391,"stargazers_count":18,"open_issues_count":0,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T20:51:09.733Z","etag":null,"topics":["burger-burge","digital-image-processing","imagej","imagej-plugins","imagingbook","java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imagingbook.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-21T06:21:19.000Z","updated_at":"2025-01-24T08:00:11.000Z","dependencies_parsed_at":"2023-02-09T02:30:33.203Z","dependency_job_id":null,"html_url":"https://github.com/imagingbook/imagingbook-public","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagingbook%2Fimagingbook-public","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagingbook%2Fimagingbook-public/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagingbook%2Fimagingbook-public/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagingbook%2Fimagingbook-public/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imagingbook","download_url":"https://codeload.github.com/imagingbook/imagingbook-public/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238751696,"owners_count":19524619,"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":["burger-burge","digital-image-processing","imagej","imagej-plugins","imagingbook","java"],"created_at":"2024-10-11T21:15:59.004Z","updated_at":"2025-10-29T01:30:21.534Z","avatar_url":"https://github.com/imagingbook.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![frankenburg-1918-960x200k.png](docs/img/443892583-frankenburg-1918-960x200k.png)\n\n# `imagingbook` - Main Source Code Repository\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.imagingbook/imagingbook-public/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.imagingbook/imagingbook-public)\n\nThis repository contains the **Java source code** accompanying the \n**Digital Image Processing** textbooks by **W. Burger and M. J. Burge**, \npublished by Springer. This software is based on **[ImageJ](http://rsbweb.nih.gov/ij/index.html)**.\nPlease visit our main website **[imagingbook.com](https://imagingbook.com/)** for more information.\n\n**Index terms:** digital image processing, computer algorithms, Java, ImageJ, textbook support.\n\n## Repository Structure\n\nThe source code is built as a modular Maven project, which includes the following modules:\n\n### Library and Data Modules\n\nThese \"library-only\" modules are packaged as `JAR` files and typically imported as Maven\ndependencies. They may also be copied manually to ImageJ's `jars/` directory \n(see \u003ca href=\"#use-without-maven\"\u003eUse Without Maven\u003c/a\u003e below):\n\n* **[imagingbook-common](imagingbook-common/)** \u003cbr\u003e \n    This is the main `imagingbook` library with implementions of image processing algorithms,\n    associated data structures and utility code. Users interested in applying `imagingbook`\n    functionality in their own programs only need to import this module (artefact) as a Maven\n    dependency.\n* **[imagingbook-spectral](imagingbook-spectral/)** \u003cbr\u003e\n    Library code related to spectral image processing (Fourier transforms etc.),\n    separated from the main `imagingbook` library to minimize third-party dependencies.\n* **[imagingbook-pdf](imagingbook-pdf/)**\u003cbr\u003e\n    PDF-related library code, separated from the main `imagingbook` library to minimize \n    third-party dependencies.\n* **[imagingbook-sample-images](imagingbook-sample-images/)** \u003cbr\u003e\n    Provides a set of (JAR-packaged) sample images accessible as \"named resources\", mainly used for demos and testing.\n* **[imagingbook-core](imagingbook-core/)** \u003cbr\u003e\n    Minimal (bootstrap) infrastructure required for building the main `imagingbook` library modules.\n    Includes code for basic file handling, managing resources and automatically compiling \n    `plugins.config` files for ImageJ plugin sets. \n\n### ImageJ Plugin Modules\n\nThese packages contain sets of `ImageJ` plugins that make use of the `imagingbook` library.\nEach plugin set is packaged as a `JAR` file and may be imported as a Maven dependency\nor copied manually to ImageJ's `plugins/` directory:\n\n* **[imagingbook_plugins_book](imagingbook_plugins_book/)** \u003cbr\u003e\n    A collection of `ImageJ` plugins related to individual book chapters (including \n    materials from previous editions) and tools for working with `ImageJ` (e.g., exact\n    zooming and PDF-export).\n* **[imagingbook_plugins_demos](imagingbook_plugins_demos/)** \u003cbr\u003e\n    Plugins demonstrating the use of various technical concepts in `ImageJ` and the\n    `imagingbook` library.\n\n\u003c!-- [**Change Log**](CHANGES.md) --\u003e\n\n### API Documentation\n\n* [**imagingbook-public**](https://imagingbook.github.io/imagingbook-public/apidocs)\n  (aggregated JavaDoc for latest build)\n\n\n### Where to Report Problems\n\nThis software is mainly intended for educational purposes and comes as is, with no\nguarantees whatsoever. API changes that make the code incompatible with previous versions\nmay happen at any time. Users are encouraged to report any enountered problems here: \n\n* **https://github.com/imagingbook/imagingbook-public/issues**\n\n\n## Use With Maven\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.imagingbook/imagingbook-public/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.imagingbook/imagingbook-public)\n\n### Using Libraries Only\n\nEach of the above modules is available as a \n[Maven artifact on Maven Central](https://search.maven.org/search?q=g:com.imagingbook).\nFor example, to use the `imagingbook-common` library, simply include the following in your\nproject's `pom.xml`file:\n```\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.imagingbook\u003c/groupId\u003e\n  \u003cartifactId\u003eimagingbook-common\u003c/artifactId\u003e\n  \u003cversion\u003e7.2.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\nReplace the number in `\u003cversion\u003e...\u003c/version\u003e` by the most current release version found on \n[Maven Central](https://mvnrepository.com/artifact/com.imagingbook/imagingbook-common).\n\n### Preconfigured Maven Projects\n\nThe following preconfigured projects are available on GitHub for getting started:\n\n* **[imagingbook-plugins-all](https://github.com/imagingbook/imagingbook-plugins-all)** \u003cbr\u003e \n    This is a ready-to-go Maven project that includes the `imagingbook` library, all plugin sets listed above, \n    packaged in a complete `ImageJ` runtime setup.\n* **[imagingbook-maven-demo-project](https://github.com/imagingbook/imagingbook-maven-demo-project)** \u003cbr\u003e This is\n    a minimal Maven setup for using the `imagingbook` library with `ImageJ`. It includes some sample Java code\n    to get started.\n\nThese projects are set up to develop and run `ImageJ` user plugins out of the box. \nThey are based on a special Maven profile in \n([**imagingbook-parent-pom**](https://github.com/imagingbook/imagingbook-public/tree/master/imagingbook-parent-pom)),\nwhich takes care of ImageJ's particular directory structure during the Maven build.\nTo use, clone any of these repositories and import it as a Maven project in your favorite IDE.\nIf necessary, perform Maven `clean` and `install` to update all dependencies and the runtime setup.\nThese projects may also be used as a good starting point when working without Maven (see below).\n\n\n## \u003ca id=\"WithoutMaven\"\u003e\u003c/a\u003eUse Without Maven\n\nTo use the `imagingbook` library in an existing (non-Maven based) `ImageJ` environment you need to manually copy all necessary JAR files\ne.g., from [imagingbook-plugins-all](https://github.com/imagingbook/imagingbook-plugins-all/tree/master/ImageJ):\n\n* `ImageJ/jars/*.jar` \u0026rarr; `ImageJ/jars`\n* `ImageJ/plugins/*.jar` \u0026rarr;  `ImageJ/plugins`\n\nThen restart `ImageJ`. Libraries and plugins should be loaded automatically. The JAR files in \n[imagingbook-plugins-all](https://github.com/imagingbook/imagingbook-plugins-all/tree/master/ImageJ)\nare typically from the most recent stable (\"release\") build.\n\n## Related Projects\n\nOther projects using the `imagingbook` library include:\n\n* **[imagingbook-calibrate](https://github.com/imagingbook/imagingbook-calibrate)**: Implementation of Zhang's camera calibration scheme.\n* **[imagingbook-violajones](https://github.com/imagingbook/imagingbook-violajones)**: Implementation of Viola-Jones face detection.\n\n\n\n\u003c!-- [Markdown tests](docs/markdown-test.md) --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagingbook%2Fimagingbook-public","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimagingbook%2Fimagingbook-public","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagingbook%2Fimagingbook-public/lists"}