GitXplorerGitXplorer
E

dicoogle-class-db

public
0 stars
1 forks
0 issues

Commits

List of commits on branch master.
Verified
5e487a5cf29b27093d0ebe17324a8b632aa8466c

Update CI status badge

EEnet4 committed 3 years ago
Verified
3a892e3eee817cd6a20e2009475b5238a14459bf

Merge pull request #1 from Enet4/chore/ci/gh-actions

EEnet4 committed 3 years ago
Unverified
7f0d65a45135edf4628c5379ab36f28878da8964

Migrate CI to GitHub Actions

EEnet4 committed 3 years ago
Unverified
4c7abc832807d9d52f255fe595c26cf6fa5c1d6b

Include JDK9 in CI

EEnet4 committed 7 years ago
Unverified
07dd1164ba49005ade088ca16f5614c3029f7d6b

Add Travis CI badge

EEnet4 committed 7 years ago
Unverified
4092399ae346fceb6ecb65aca31836eff834640f

Add Travis CI

EEnet4 committed 7 years ago

README

The README file for this repository.

Dicoogle Classification Database

Java CI with Maven

This plugin integrates a database for indexing and querying classification data with Dicoogle.

Building

This is a Maven project.

mvn install

The plugin jar "class-db-1.0.0-plugin.jar" will be in the target folder.

Configuring

A configuration is required for the classification database to work. Specify as many classifier elements as there are classifiers and as many criterion elements as desired. Criteria can also include a variable number of criteria that the specific classification method depends on, often used for conditional classification. The index-path element is optional and is used for specifying the classification index' directory path. These classifiers are expected to be compliant with the Dicoogle Classification API.

Example:

<configuration>
    <index-path>/opt/dicoogle/my-predictions</index-path>
    <classifiers>
        <classifier name="my-classifier">
          <criterion id="liver" />
          <criterion id="lesionType" depends="head-neck" />
        </classifier>
        <classifier name="my-classifier-2">
          <criterion id="head-neck" />
        </classifier>
    </classifiers>
</configuration>

Usage

This plugin will register a new indexer and query provider. When an indexing procedure is issued, this indexer will take all registered classifiers, classify the files and store the results in its own embedded database.

Query Provider API

public Iterable<SearchResult> query(String query);
public Iterable<SearchResult> query(String query, Map<String, Object> options);

The query provider accepts standard Lucene syntax queries. The available fields are "classifier", "criterion", as well as the actual criteria available, or prepended by the classifier's name with a forward slash. Free keyword queries are also supported.

  • mammo/microcalcifications:true -- all predictions where the classifier mammo predicted microcalcifications as true.
  • liver:true or just liver -- all predictions where liver was predicted true
  • bodyPart:torso -- all files where criterion bodyPart was predicted torso
  • uri:file:/001.dcm -- all predictions of the given file

Web Services

GET /classification/classify?classifier={}&criterion={}

Request for a classification procedure and return the predictions. The classification database is not involved.

GET /classification/query?query={}

Query for predicted data.

License

Copyright (C) 2017 UA.PT Bioinformatics - http://bioinformatics.ua.pt

dicoogle-class-db is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

dicoogle-class-db is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.