8000 GitHub - dqdinh/LUWAKX · GitHub
[go: up one dir, main page]

Skip to content
dqdinhPublic
forked from ZentaLabs/LUWAKX

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

LuwakX - Config-Driven DICOM Anonymization

PyPI version

LuwakX is a powerful, config-driven tool for anonymizing DICOM files using the deid library. It supports flexible configuration through JSON files and provides both command-line and programmatic interfaces. It is based on the 2025b DICOM standards.

Installation

From PyPI

pip install luwakx

From source

git clone https://github.com/ZentaLabs/LUWAKX.git
cd luwakx
pip install -e ".[test]"

Using requirements.txt (development)

pip install -r requirements.txt
pip install -e ".[test]"

Note: deid is a custom fork not available on PyPI. It is automatically installed from GitHub the first time anonymization is run.

Prerequisites

  • Python >= 3.12

Usage

Command Line Interface

luwakx --config_path /path/to/config.json

Options:

  • --config_path: Path to the JSON configuration file
  • --no-console: Disable console logging (only log to file)

Programmatic Interface

from luwakx.anonymize import LuwakAnonymizer

anonymizer = LuwakAnonymizer("/path/to/config.json")
result = anonymizer.anonymize()

Configuration

Create a JSON configuration file:

{
  "inputFolder": "/path/to/input/dicom/files",
  "patientIdPrefix": "Patient",
  "outputDeidentifiedFolder": "/path/to/output/deidentified",
  "outputPrivateMappingFolder": "/path/to/output/privateMapping",
  "recipesFolder": "/path/to/output/recipes",
  "recipes": ["basic_profile"],
  "projectHashRoot": "your_encryption_key",
  "maxDateShiftDays": 1095,
  "logLevel": "INFO"
}

For full configuration documentation see luwakx/README.md.

License

Apache License 2.0 — see LICENSE.txt.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0