Skip to main content

DICOM-QR

This program allows you to query and retrieve images from a DICOM node.

This needs a settings.json file with the following data:

{
  // Specify either 'dimse' or 'dicom_web' but not both.
  "dimse": {
    "server_ae_title": "SOMETHING",
    "server_ae_ip": "SOMETHING",
    "server_ae_port": SOMETHING,
    "client_ae_title": "SOMETHING",
    "client_ae_port": SOMETHING,
    "transfer_method": "move" // or "get", depending on the capabilities of the server.
  },
  "dicom_web": {
    "url": "http://localhost:8042/dicom-web",
    "username": "SOME USER",  // or environment variable, see below.
    "password": "SOME PWD"
  },
  "base_folder": "dumpdir",
  "folder_template": "${PatientID}/${StudyDate}/${StudyDescription}/${Modality}/${FolderUID}_${SeriesDescription}",
  "study_columns": [
    {"name": "Index"},
    {"name": "PatientID"},
    {"name": "StudyDate"},
    {"name": "StudyDescription", "justify": "left"}
  ],
  "series_columns": [
    {"name": "Index"},
    {"name": "SeriesInstanceUID", "justify": "left", "no_wrap":  true},
    {"name": "Modality"},
    {"name": "SeriesNumber"},
    {"name": "SeriesDescription", "justify": "left"}
  ]
}

Search strategy for settings file:

  1. 'DICOM_QR_SETTINGS' environment value
  2. 'settings.json' in current directory
  3. ~/.config/dicom_qr/settings.json

If the username and/or password for a DICOM Web server starts and ends with a $, the value between that is interpreted as an environment variable and a lookup is performed.
i.e. $DICOM_WEB_USERNAME$ is replaced by the contents of environment variable DICOM_WEB_USERNAME

Template

Folder template can contain any of the following items:

  • PatientName
  • PatientID
  • StudyDescription
  • StudyDate
  • StudyTime
  • Modality
  • SeriesDescription
  • SeriesNumber
  • SeriesInstanceUID
  • FolderUID (Uses the uid_mapping provided to RetrievePacs class)
  • StudyInstanceUID
  • AccessionNumber

study columns:

names:

  • StudyInstanceUID
  • PatientID
  • PatientName
  • PatientSex
  • PatientBirthDate
  • StudyID
  • StudyDate
  • StudyDescription
  • StudyTime
  • AccessionNumber

justify

  • default
  • left
  • center
  • right
  • full

no_wrap

  • true
  • false

Metadata

Release files for dicom_qr 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for dicom_qr 0.1.2
File Interpreter ABI Platform
dicom_qr-0.1.2-py3-none-any.whl Python 3 none any Details

Release files / dicom_qr-0.1.2-py3-none-any.whl

Download URL dicom_qr-0.1.2-py3-none-any.whl
Size 59.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a589d513668e6178aef7d389b494b6cee77a77962c9f7c71f1403a46fccb7612
BLAKE2b-256 checksum
How to use checksums
63248ed9ddeb4c7fd2d3ec04066be1e5a21a1a2ab34cac040a58ca03d9a1cff0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

0.2.6

1 release file

0.2.5

1 release file

0.2.4

1 release file

0.2.3

1 release file

0.2.2

1 release file

0.2.1

1 release file

0.1.3

1 release file

This release

0.1.2 This release

1 release file

0.1.1

1 release file

0.1.0

1 release file

0.0.14

1 release file

0.0.13

1 release file

0.0.12

1 release file

0.0.11

1 release file

0.0.10

1 release file

0.0.9

1 release file

0.0.8

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page