Links.md

Useful Links for Orthanc

Mobile apps

• "Mobile DICOM viewers", post by Marco Barnig testing which mobile apps for radiology are compatible with Orthanc.

Docker

• Official container, and its associated documentation in the Orthanc Book.
• Osimis container, and its associated documentation.
• Cross-architecture orthanc container and Cross-architecture orthanc-plugins container for amd64, armhf, and aarch64, and the associated source code
• Lightweight cross-architecture orthanc container and Lightweight cross-architecture orthanc-plugins container and the associated source code with images built for amd64 and armhf. Updated Debian base and images can be built for any architecture.

Kubernetes

• Korthweb is a project by Yi Lu for automated Orthanc deployment on Kubernetes platforms, with configurations for security and observability.
• fnndsc/orthanc is a Helm Chart for Orthanc optimized for Red Hat OpenShift and CRDs common to it, such as Crunchy PGO. It supports configuration of Orthanc.json as Helm YAML values and integration with oauth2-proxy.

Ansible

• The "GNU Health Automatic Deployment" Ansible playbooks by Gerald Wiese aims "to automatically deploy the hospital information system GNU Health including the HMIS node, Thalamus, the DICOM server Orthanc and a desktop environment as a client using the GNU Health HMIS node."

Vagrant

• By Chris Hafey
• By Fernando Jose Serrano Garcia

Plugins

• Orthanc-Explorer 2 provided by S. Doloris, R. Mathonet, R. Pire, P. Mertes and M. Horman (students at ULiège, Belgium)
• Mongo-DB provided by Doc-Cirrus.
• VPI Reveal provided by VPI-reveal is a plugin that stores the files on disk in a more friendly tree (Patient/Study/Series/Instance).
• orthanc-patient-list provided by FNNDSC shows a list of patients (instead of listing studies).

Node.js

• Orthanc Client by Frédéric Woelffel ("Orthanc REST API client designed for NodeJS").

Ruby and Ruby on Rails

• Ruby gem by Simon Rascovsky ("Client for the Orthanc DICOM server REST API").

Python

• beren: Orthanc REST client in Python
• orthanc-server-extensions: A simple Orthanc python plugin based framework to extend Orthanc’s feature set with testable python scripts
• Orthanc Plugin Scripts: A collection of Orthanc plugins, written in Python, to add miscellaneous functionality, by Mohannad Hussain.
• PyOrthanc: An open-source Python library that provides a comprehensive interface for interacting with Orthanc, by Gabriel Couture.

R

• orthanc for R by Matthew T. Warkentin is an R package that "provides a programmatic interface to Orthanc DICOM Servers to support medical imaging workflows for the R language."

Rust

• orthanc-cli is a command-line interface for Orthanc by Andrii Yurchuk.
• orthanc-rs is a Rust client library for the Orthanc REST API written by Andrii Yurchuk.
• orthanc_sdk is a (WIP) create for building Orthanc plugins in Rust, with focus on idiomatic code and memory safety.

PHP

• PHP API Client for Orthanc by christopher.skene.

Cloud

• OrthWeb is a project by by Yi Lu for automated Orthanc deployment on AWS. It provisions underlying cloud resources and configures Docker to host Orthanc on EC2 instance.
• Orthanc deployment on AWS using AWS CDK is a project that "aims to help you provision a ready-to-use Orthanc cluster on Amazon ECS Fargate, with support for the official S3 plugin." It is written by Tamas Santa.
• Research PACS on AWS is a project that "facilitates researchers to access medical images stored in the clinical PACS in a secure and seamless manner, after potentially identifying information is removeed, and allows medical images to be exported to Amazon S3 in order to leverage cloud capabilities for processing." It is written by Nicolas Malaval.

Tools based upon Orthanc

• DICOM tools built on Orthanc API in Java by Salim Kanoun, from the Free and Open Source PET/CT viewer project.

  • The GUI tool to edit the JSON configuration file of Orthanc that was previously a separated project is now part of the PET/CT viewer project.

• Upload and import study (files or zip file) to Orthanc by Rana Asim Wajid.

• RadioLogic by Marco Barnig. RadioLogic is a case-based learning and self-assessment tool for the Orthanc Ecosystem for Medical Imaging.

• Orthanc Paper Scanner in Apache PHP. This project is "a paper scanning portal that gives the Orthanc Pacs server the ability to interface with twain/wia scanners and insert the resulting pdf into the Orthanc database using a web interface integrated into the Orthanc web console". Check out the original announcement on the Orthanc Users discussion group.

• https://github.com/sscotti/PACS_Integration

• Longitudinal Anonymization. A collection of bash, Lua, and Python scripts to launch a constellation of Orthanc/PostGreSQL servers using docker-compose for performing longitudinal anonymization of patient/studies.

  • Studies are internally consistent in that all UID are replaced with anonymized UID, but references/links between series are retained.
  • Relative times between studies for the same patient are retained, but the dates are randomly shifted up to 365 days. One random shift is generated per patient for all their studies.

External documentations and user guides

• Swagger / OpenAPI specification for Orthanc, draft by Aditya Panchal. Link to forum.
  • 2020-12-30: This contribution is superseded by the official OpenAPI that is generated directly from the source code of Orthanc.
• Extending Orthanc with Postresql database by Ilan Tal – Salim Kanoun
• DICOM connection setup user guide by Ilan Tal – Salim Kanoun
• Orthanc setup on Synology using Ansible, by Levin Alexander.
• RadioLogic - wiki by Marco Barnig. Tons of useful info about how to use Orthanc, compile it and how to develop Orthanc plugins.