thelabbingproject / django_dicom

A reusable django app to manage DICOM files.

django-dicom

A django app to manage DICOM files.

This app creates the basic models for DICOM data abstraction: Study, Patient, Series, and Image. The models are complemented with some utility methods to facilitate data access.

Quick start

1. Add "django_dicom" to your INSTALLED_APPS setting:

    INSTALLED_APPS = [
        ...
        'django_dicom',
    ]

2. Include the dicom URLconf in your project urls.py:

    path('dicom/', include('django_dicom.urls')),

3. Run python manage.py migrate to create the dicom models.

4. Start the development server and visit http://127.0.0.1:8000/admin/.

5. Visit http://127.0.0.1:8000/dicom/.

Documentation

The full documentation can be found here.

django_dicom's Issues

Integrate isort

Publish to pypi

Refactor DICOM logic to use the `dicom_parser` package

I refactored a lot of the DICOM management logic out to a separate package called dicom_parser. We should refactor the app to use it.

Create a view to return a zipped DICOM series instance

This should be the basis for more versatile zipping in the future (through the Scan, Study, and Subject models).

Could not install on windows 10

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

Incorrect SCU logic

Seems like the IP of the SCU is not required. Instead, an SCP server needs to be started on localhost.

Upload documentation to ReadTheDocs

Refactor to_zip view to work without saving temp file to filesystem

Allow specifying a globbing pattern in file import

Currently, the Image.objects.import_path method simply runs over .dcm files, it would be better to allow for the user to specify the globbing pattern.

Create properties to check storage SCU association status

Migrate CI to GitHub Actions

Endpoint to return a ZIP of series by listed IDs

IntegrityError raised for tag (0028,0106)

The issue is raised for subject 06QLHG4P's data in our lab database.

Examining existing tags reveals the tag indeed already exists:

The problem is most probably caused by a difference in the description of the data element.
I propose we change the logic in the DataElementDefintionManager from its current state which causes the error to try and return by tag and keyword alone and create only on ObjectDoesNotExist.

I'll create a PR soon.

Import fails for headers with no PatientName

When the DICOM header's PatientName data element is missing, the Patient model's update_patient_name() method tried to iterate None's items(), which raises an exception.

This does not work with python 9. shows errror

Exception: Cython-generated file 'pandas_libs/algos.c' not found.
Cython is required to compile pandas from a development branch.
Please install Cython or download a release package of pandas.

  pandas._libs.algos: -> [['pandas\\_libs/algos.c']]
  [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
Rolling back uninstall of pandas
Moving to d:\pagoda\tmmc\dicom\venv\lib\site-packages\pandas-1.4.1.dist-info
from D:\pagoda\tmmc\dicom\venv\Lib\site-packages~andas-1.4.1.dist-info
Moving to d:\pagoda\tmmc\dicom\venv\lib\site-packages\pandas
from D:\pagoda\tmmc\dicom\venv\Lib\site-packages~andas
error: legacy-install-failure

× Encountered error while trying to install package.
╰─> pandas

CI Integration

Change license to Apache 2.0

Starting shell or running server with unreachable SCU raises OSError

Update tests

Tests should be updated to pass with maximal coverage.

Show exception information on image import failure

Currently, it's hard to tell what exactly happened on import failures.

solve LoggedIn test cases in views

Add logging to SCP functionality

Customize imported data elements

Create a new setting to specify data element tags that should be serialized to the database and change the default import mode to minimal (with the tags prioritized over it).

Flake8 shows many linting issues

fix tests after revisions

Automate data import using pynetdicom

Using pynetdicom to automate the flow of new data from a DICOM server. New data should be up for review and also anonymization if required.

Migrate to django 4