|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Dicoogle||386||4 days ago||62||gpl-3.0||Java|
|Dicoogle - Open Source PACS|
|pacman viewer / gui made with Electron, React & Redux|
|Pacman React||22||2 years ago||TypeScript|
|A Pac Man game, built with React, TypeScript, MobX, styled-components, and Xstate|
|A web app to track campaign finances for the General Election (November 3, 2020) in San Jose & South Bay California|
|A location base Pac-man game made by React Native|
This is the development branch for Dicoogle 3. See here for the development line of Dicoogle 2, which is being phased out.
Dicoogle is an extensible, platform-independent and open-source PACS archive software that replaces the traditional centralized database with a more agile indexing and retrieval mechanism. It was designed to support automatic extraction, indexing and storage of all meta-data detected in medical images, including private DICOM attribute tags, without re-engineering or reconfiguration requirements.
The architecture of Dicoogle is described in the following articles:
Our official website is at https://www.dicoogle.com. A few essential plugins for Dicoogle are available to download there, as well as a built jar of the Dicoogle platform. To learn how to use Dicoogle, please see our Learning Pack. To build the core platform yourself, please see the section on Building Dicoogle below. The learning pack also has a page on Building Dicoogle.
Copy dicoogle.jar to the installation folder. For example DicoogleDir/
Create the Folder DicoogleDir/Plugins.
This folder will hold the plugins used by our instance of the Dicoogle Platform.
Next, copy the desired plugins into the DicoogleDir/Plugins Folder.
The typical setup of Dicoogle involves the deployment of an Indexing and Query Plugin. We supply an implementation of such plugin based in Apache Lucene.
Dicoogle may be run as a server:
java -jar dicoogle.jar -s
To load the server and open Dicoogle's user interface with the default browser:
java -jar dicoogle.jar
We provide a few plugins at the official website, in the Downloads page.
Lucene Index/Query Plugin - (lucene.jar)
Plugin Based on Apache Lucene to support indexing and querying of DICOM meta-data. With this plugin set, it is possible to index nearly meta-data and perform free text, keyword-based, and range-based queries.
File Storage Plugin - (filestorage.jar)
Plugin used for the storage of DICOM Files. This plugin is necessary in order to use Dicoogle as a complete DICOM Storage Provider. The core platform provides a fallback implementation which supports reading (but not storing) files from the local file system.
For storage purposes, our file storage plugin maps the DICOM hierarchical organization (Patient->Study->Series->Image) into a directory tree in the file system. Every object in the Dicoogle Platform may be traced back to its storage location by a URI, similar to file:/tmp/file. In order to support multiple providers, every Storage plugin must define a unique scheme, which maps to the protocol used to store and retrieve content.
root-dir: is the root directory where DICOM Files will be stored
scheme: Specifies the scheme/protocol of the file plugin. This value is arbitrary, but must be unique among all installed plugins. As such, avoid using well known protocol names such as http or file.
Plugin configurations are accessible via "/DicoogleDir/Plugins/settings/PluginName.xml", where PluginName stands for the name of the plugin. Upon initialization, if no configurations file is supplied, a new one with the default values is created.
In the Management Page, Services and Plugins settings, it is possible to start and/or stop currently running services in real time. Moreover, some configurations like the DICOM service ports may be set.
Index a Directory
Indexing a directory is done simply by accessing the Indexer page, on the side bar.
In this page, one can select a root directory to index. The path is a URI defined according to the storage provider, and defaults to the
In the Management pange, one may also enable the Dicoogle Directory Watcher, which creates a daemon that listens for new files in the root directory. After selecting the configurations, the "Apply Settings" button must be pressed. When the right settings are saved, the Start buttons fires the indexing process. Please note that this process may take considerable time to complete.
Using the Search Interface
The search page enables users to execute queries over the indexed meta-data. The query syntax is similar to the Lucene's Tag:Value query format, but free text searches are also supported. For inexperienced users, an advanced input module may also be used.
In the search interface, it is also possible to select which providers to query. Query providers are actually Query Plugins, that are installed either in the local instance of Dicoogle, or in remote instances if the platform is using the WAN plugin. Therefore, be careful and select exactly which providers you want to query, in order to retrieve more accurate and faster results.
After running a query, the result browser shows up, giving the user an intuitive hierarchical view of the results. On this page, there is also an Export button, which is used in order to export the query results into a CSV file. When the export button is clicked, the user has to select which tags (s)he wants to export in the CSV file. This selection is heavily assisted by the interface, on which the user may type an incomplete tag and have presented the available candidates that match the inserted term. Moreover, the text box allows users to copy a list of tags directly from another CSV file, enabling an easier generation of reports.
Let us assume that the Web Services for our instance of Dicoogle are running in https://demo.dicoogle.com/
Dicoogle provides a flexible web service for querying, under the
Search by Date Range, Access images in date 2005/03/29
"StudyDate:[20050329 TO 20050329]"
Access images in date 2005/03/29 and CT (Computer Tomography) modality
"Modality:CT AND StudyDate:[20050329 TO 20050329]"
Free text search, looking for CT keyword
Access the list of attributes of an image (by SOPInstanceUID)
Get a DICOM File
Return documents from particular query providers (useful for queries that do not follow the typical Lucene query format)
Force Dicoogle to index a given Resource. (useful when conventional notification systems (DICOM Services, DirectoryMonitoring, Human Interface) fail to start the index procedure)
A live demo was deployed at the given URL. Feel free to experiment with these services.
In order to integrate new functionalities in Dicoogle, you may create your own plugin set. A plugin set comprises plugins that are developed with the intent of supporting a given feature, and are packaged in a single jar file for deployment. See the learning pack on Plugin Development for our guide (we also have a wiki page), and our sample plugin project for a base project from which you can start making your own plugins.
Before building, please make sure that your system contains the following tools:
git clone https://github.com/bioinformatics-ua/dicoogle.git
mvn install -Dskip.installnodenpm -Dskip.npm
The open source project is maintained by UA.PT Bioinformatics and BMD Software. Your contributions to the software are also welcome. Dicoogle is sought to be useful for R&D and the industry alike. You may find our Development Guidelines in the wiki. Issues containing the
easy label should be the most suitable for first open source contributions. For tech support, please prefer contacting the maintainers instead of creating an issue.
Please contact BMD Software for professional support and consulting services.