Repository files navigation

Dicognito is aPython module and command-line utility that anonymizesDICOM files.

Use it to anonymize one or more DICOM files belonging to one or any number of patients. Objects will remain groupedin their original patients, studies, and series.

Anonymization causes significant elements, such as identifiers, names, andaddresses, to be replaced by new values. Dates and times will be shifted into thepast, but their order will remain consistent within and across the files.

The package isavailable on pypi and can be installed from the command line by typing

pip install dicognito

Once installed, adicognito command will be added to your Python scripts directory.You can run it on entire filesystem trees or a collection of files specified by glob like so:

# Recurse down the filesystem, anonymizing all found DICOM files.# Anonymized files will be placed in out-dir, named by new SOP# instance UID.dicognito --output-directory out-dir.# Anonymize all files in the current directory with the dcm extension# (-o is an alias for --output-directory).dicognito -o out-dir*.dcm# Anonymize all files in the current directory with the dcm extension# but overwrite the original files.# Note: repeatedly anonymizing the same files will cause date elements# to  move farther into the past.dicognito --in-place*.dcm

Get more help viadicognito --help.

To anonymize a bunch of DICOM objects from within a Python program, import the objects usingpydicom and use theAnonymizer class:

importpydicomimportdicognito.anonymizeranonymizer=dicognito.anonymizer.Anonymizer()fororiginal_filenamein ("original1.dcm","original2.dcm"):withpydicom.dcmread(original_filename)asdataset:anonymizer.anonymize(dataset)dataset.save_as("clean-"+original_filename)

Use a singleAnonymizer on datasets that might be part of the same series, or the identifiers will not beconsistent across objects.

Additional (even custom) element handlers can be added to theAnonymizer viaadd_element_handler to augmentor override builtin behavior.

Using the default settings, dicognito will

• Add "DICOGNITO" to DeidentificationMethod
• Remove BranchOfService
• Remove MedicalRecordLocator
• Remove MilitaryRank
• Remove Occupation
• Remove PatientInsurancePlanCodeSequence
• Remove PatientReligiousPreference
• Remove PatientTelecomInformation
• Remove PatientTelephoneNumbers
• Remove ReferencedPatientPhotoSequence
• Remove ResponsibleOrganization
• Replace AccessionNumber with anonymized values
• Replace CountryOfResidence with anonymized values
• Replace CurrentPatientLocation with ""
• Replace FillerOrderNumberImagingServiceRequest with anonymized values
• Replace FillerOrderNumberImagingServiceRequestRetired with anonymized values
• Replace FillerOrderNumberProcedure with anonymized values
• Replace InstitutionAddress with anonymized values (only if replacing matching InstitutionName element)
• Replace InstitutionName with anonymized values
• Replace InstitutionalDepartmentName with "RADIOLOGY"
• Replace IssuerOfPatientID with "DICOGNITO"
• Replace OtherPatientIDs with anonymized values
• Replace PatientAddress with anonymized values
• Replace PatientID with anonymized values
• Replace PerformedProcedureStepID with anonymized values
• Replace PlacerOrderNumberImagingServiceRequest with anonymized values
• Replace PlacerOrderNumberImagingServiceRequestRetired with anonymized values
• Replace PlacerOrderNumberProcedure with anonymized values
• Replace RegionOfResidence with anonymized values
• Replace RequestedProcedureID with anonymized values
• Replace RequestingService with ""
• Replace ScheduledProcedureStepID with anonymized values
• Replace StationName with anonymized values
• Replace StudyID with anonymized values
• Replace all DA elements with anonymized values that precede the originals
• Replace all DT elements with anonymized values that precede the originals
• Replace all PN elements with anonymized values
• Replace all TM elements with anonymized values that precede the originals (only if replacing matching DA element)
• Replace all UI elements with anonymized values
• Replace private "MITRA LINKED ATTRIBUTES 1.0" element "Global Patient ID" with anonymized values
• Set PatientIdentityRemoved to "YES" if BurnedInAnnotation is "NO"

Logo: Remixed fromRadiologybypriyanka andIncognito byd͡ʒɛrmi Good fromthe Noun Project.