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

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

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

Download URL dicom_qr-0.1.3-py3-none-any.whl
Size 60.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7fdc8ec72a7f45df2e3e34531d7675554ef982475fffb1f4e9f6f0c599532227
BLAKE2b-256 checksum
How to use checksums
df8367926c6f2b60b76afef32a9f855610f3dba1134e2dcad078ea5dd3aaf1ab
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

This release

0.1.3 This release

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