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.2.5

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.2.5
File Interpreter ABI Platform
dicom_qr-0.2.5-py3-none-any.whl Python 3 none any Details

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

Download URL dicom_qr-0.2.5-py3-none-any.whl
Size 62.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4d4864db597fcb11ce2c58a1f97537ce982cf4935644b7a63559e9ab8d70f094
BLAKE2b-256 checksum
How to use checksums
f1a7afbb51e76f14e5ead87453a1298e22af0f4310c346a777afbe8ec3d7e516
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

This release

0.2.5 This release

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

0.1.2

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