Giter VIP home page Giter VIP logo

dicomanonymizer's Introduction

Welcome to DICOM Anonymizer Page

Date: Dec. 24th, 2021


Description

DICOM Anonymizer v1.0, a CLI/GUI toolbox to structure and anonymize DICOM files.

Developped by Beijing Intelligent Brain Cloud, Inc., Beijing, China.

License

DICOM Anonymizer use GPLv3 license.

Standalone Release

Standalone version have been released at DICOM Anonymizer Release

Dependency

We developed DICOM Anonymizer based on the following library, however older version should also work.

  • Python 3.6.9
  • numpy >= 1.20.2
  • pydicom >= 2.2.1

If you would like to use GUI version of DICOM Anonymizer

  • PyQt5 >= 5.10.1

NOTE: If you would package DICOM Anonymizer by yourself, please visit FBS

Usage

Input

  • DICOM Working Directory: The source path for unstructured DICOM files which have sensitive information (e.g. PatientName) included in header.
  • Anonymized Dicom Output Directory: The output path for structed & anonymized DICOM files.
  • Prefix of Anonymized DICOM Sub-Folders: User can set the prefix of all anonymized DICOM folders, e.g., if you set prefix to "patient", the anonymized DICOM folders would be timestamp_patient_0001, timestamp_patient_0002, ...
  • Starting Number of Anonymized Dicom Sub-Folders: User can set the starting number of all anonymized DICOM folders, e.g., if you set starting number to 10, the anonymized DICOM folders would be timestamp_patient_0010, timestamp_patient_0011, ...

CLI Usage

User can easily call Dicom Anonymizer in the Python3 environment:

from coreFunction import DicomAnonymizer

# Init Dicom Anonymizer
da=DicomAnonymizer()

# Set All Input
da.SetDcmWorkDir("./test")
da.SetDcmOutDir("./sort")
da.SetDcmAnonyPrefix("Patient")
da.SetDcmAnonyStartP(1)

# Parse All DICOM Files and Build Output Folder Structure
da.ParseDicom()

# Anonymize All DICOM Files and Copy Them to Output Directory
da.AnonyDicom()

GUI Usage

User can directly use GUI version of DICOM Anonymizer:

  • 1 - Set All Input
  • 2 - Click 'Export' Button and Execute

Output

  • Structured DICOM folders: the output DICOM files, with timestamp_prefix_starting_number.
  • Anonymized Subjects Mapping Table: the mapping table between raw Patient_ID to anonymized ones.
  • Invalid DICOM files: all invalid files absolute path would be save in this list.

File Lists

Package

  • coreFunction.py: codes to generate structured & anonymized DICOM files.
  • mainWindow.py: codes build GUI application.
  • main.py: codes for packaging interface.

Icons

  • Icons of Beijing Intelligent Brain Cloud, Inc., Beijing, China.

Customized Packaging with FBS

Before packaging, please ensure you have installed FBS, and run:

mkdir Dist/
cd Dist
fbs startproject
cp ../Package/* src/main/python/
cp ../Icons/* src/main/icons/
fbs freeze

Then, you could acquire the freezed toolbox in target folder.

dicomanonymizer's People

Contributors

sandywang avatar mike-haobo avatar

Stargazers

Yunman Xia avatar yinxiaolong avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.