DICOM/DICOMDIR Patient Sex Updater

updater.py

import os

#Enter your name Here with a ^ symbol.
NAME_SEQ = "Lastname^Firstname".encode("ascii")
SEX_TAG  = bytes.fromhex("10 00 40 00")

MALE = ord('M')
FEMALE = ord('F')

#The target sex
NEWVALUE = FEMALE

#Usage: Place this file in the base folder next to DICOMDIR, then run. Done.
#The script will go through the DICOMDIR and all DICOM files and update the sex
#data of the first patient with the above name.
#Enjoy :)

for filename in [os.path.join('DICOM', f) for f in os.listdir('DICOM')] + ['DICOMDIR']:
    if not os.path.isfile(filename):
        continue

    try:
        with open(filename, 'rb') as f:
            data = bytearray(f.read())

        name_pos = data.find(NAME_SEQ)
        if name_pos == -1:
            print(f"{filename}: Error could not find name position")
            continue

        tag_pos = data.find(SEX_TAG, name_pos + len(NAME_SEQ))
        if tag_pos == -1:
            print(f"{filename}: Error could not find sex tag")
            continue

        sex_pos = tag_pos + 4 + 4
        if sex_pos >= len(data):
            print(f"{filename}: Error could not find value pos after sex tag (file too short)")
            continue

        current = data[sex_pos]

        if (current == MALE and NEWVALUE == FEMALE) or \
           (current == FEMALE and NEWVALUE == MALE):
            data[sex_pos] = NEWVALUE
            with open(filename, 'wb') as f:
                f.write(data)
            print(f"{filename}: {chr(current)}->{chr(NEWVALUE)}")

        elif current == NEWVALUE:
            print(f"{filename}: {chr(current)} (no change)")

        else:
            # stop to prevent corruption
            if 32 <= current <= 126:
                val = chr(current)
            else:
                val = f"0x{current:02X}"
            print(f"{filename}: Error unexpected value {val}")

    except Exception:
        print(f"{filename}: Error could not find value")