Как да създадете персонализиран профил за анонимизация на DICOM от CSV, JSON или XML

Този урок показва как да се създадат персонализирани профили за анонимност на DICOM, като се използват CSV, JSON или XML файлове в C#. Custom Profiles ви позволяват да определите точно кои етикети трябва да бъдат премахнати, заменени или запазени в съответствие с конкретните политики за поверителност на вашата институция.

Защо да създаваме персонализирани профили?

Предефинирани профили на DICOM PS3.15 може да не отговарят на всички институционални изисквания.

• Съхраняване на специфични институционални идентификатори за вътрешна проследимост
• Прилагане на организационни правила за поверителност
• Свържете се с уникални регулаторни изисквания във вашата юрисдикция

Акции обяснени

Следните действия могат да се прилагат към етикетите DICOM:

Предимства: Подготвяне на околната среда

• Visual Studio или всяка съвместима .NET IDE.
• Създаване на нов проект за .NET 8 конзола.
• Инсталирайте Aspose.Medical от NuGet Package Manager.
• Подгответе персонализирания файл за дефиниране на профила си.

Стъпка по стъпка ръководство за създаване на персонализирани профили

Install-Package Aspose.Medical

TagPattern;Action
(0010,0010);Z
(0010,0020);Z
(0010,0030);X
(0010,0040);K
(0020,000D);U
(0020,000E);U
(0008,0018);U
(0008,0080);D
(0008,0081);D
(0008,1030);C

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

[
  { "TagPattern": "(0010,0010)", "Action": "Z" },
  { "TagPattern": "(0010,0020)", "Action": "Z" },
  { "TagPattern": "(0010,0030)", "Action": "X" },
  { "TagPattern": "(0010,0040)", "Action": "K" },
  { "TagPattern": "(0020,000D)", "Action": "U" },
  { "TagPattern": "(0020,000E)", "Action": "U" },
  { "TagPattern": "(0008,0018)", "Action": "U" },
  { "TagPattern": "(0008,0080)", "Action": "D" },
  { "TagPattern": "(0008,0081)", "Action": "D" },
  { "TagPattern": "(0008,1030)", "Action": "C" }
]

<?xml version="1.0" encoding="utf-8"?>
<ConfidentialityProfile>
  <TagAction TagPattern="(0010,0010)" Action="Z" />
  <TagAction TagPattern="(0010,0020)" Action="Z" />
  <TagAction TagPattern="(0010,0030)" Action="X" />
  <TagAction TagPattern="(0010,0040)" Action="K" />
  <TagAction TagPattern="(0020,000D)" Action="U" />
  <TagAction TagPattern="(0020,000E)" Action="U" />
  <TagAction TagPattern="(0008,0018)" Action="U" />
  <TagAction TagPattern="(0008,0080)" Action="D" />
  <TagAction TagPattern="(0008,0081)" Action="D" />
  <TagAction TagPattern="(0008,1030)" Action="C" />
</ConfidentialityProfile>

using Aspose.Medical.Dicom.Anonymization;

// Load from CSV
ConfidentialityProfile profileFromCsv = ConfidentialityProfile.LoadFromCsvFile(
    "profile.csv", 
    ConfidentialityProfileOptions.All
);

// Or load from JSON
ConfidentialityProfile profileFromJson = ConfidentialityProfile.LoadFromJsonFile(
    "profile.json", 
    ConfidentialityProfileOptions.All
);

// Or load from XML
ConfidentialityProfile profileFromXml = ConfidentialityProfile.LoadFromXmlFile(
    "profile.xml", 
    ConfidentialityProfileOptions.All
);

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Anonymization;

// Load custom profile
ConfidentialityProfile profile = ConfidentialityProfile.LoadFromCsvFile(
    "profile.csv", 
    ConfidentialityProfileOptions.All
);

// Create anonymizer with custom profile
Anonymizer anonymizer = new(profile);

// Load and anonymize DICOM file
DicomFile dcm = DicomFile.Open("patient_study.dcm");
DicomFile anonymizedDcm = anonymizer.Anonymize(dcm);
anonymizedDcm.Save("anonymized_study.dcm");

Допълнителен код с CSV профил

Ето пълен пример с използване на персонализиран профил, базиран на CSV:

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Anonymization;

// Load custom confidentiality profile from CSV
ConfidentialityProfile profile = ConfidentialityProfile.LoadFromCsvFile(
    "hospital_privacy_profile.csv",
    ConfidentialityProfileOptions.All
);

// Create anonymizer with the custom profile
Anonymizer anonymizer = new(profile);

// Load DICOM file
DicomFile dcm = DicomFile.Open("patient_scan.dcm");

// Anonymize using custom profile
DicomFile anonymizedDcm = anonymizer.Anonymize(dcm);

// Save result
anonymizedDcm.Save("anonymized_scan.dcm");

Console.WriteLine("Anonymization completed with custom profile!");

Примери за практичен сценарий

Сценарий 1: Идентифициране на институцията за вътрешно проследяване

TagPattern;Action
(0010,0010);Z
(0010,0020);Z
(0008,0080);K
(0008,0081);K

Сценарий 2: Заменете всички UID, докато запазвате отношенията

TagPattern;Action
(0020,000D);U
(0020,000E);U
(0008,0018);U
(0008,0016);K

Сценарий 3: Максимална поверителност за външно споделяне

TagPattern;Action
(0010,0010);X
(0010,0020);X
(0010,0030);X
(0010,0040);X
(0008,0080);X
(0008,0081);X
(0008,1030);X
(0008,103E);X

Валидиране: Тестване на Вашия персонализиран профил

Винаги валидиране на персонализирани профили преди употреба на производството:

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Anonymization;

// Load custom profile
ConfidentialityProfile profile = ConfidentialityProfile.LoadFromCsvFile(
    "test_profile.csv",
    ConfidentialityProfileOptions.All
);

Anonymizer anonymizer = new(profile);

// Test with sample files
string[] testFiles = Directory.GetFiles("test_samples", "*.dcm");

foreach (string filePath in testFiles)
{
    try
    {
        DicomFile dcm = DicomFile.Open(filePath);
        DicomFile anonymized = anonymizer.Anonymize(dcm);
        
        string outputPath = Path.Combine("test_output", Path.GetFileName(filePath));
        anonymized.Save(outputPath);
        
        Console.WriteLine($"✓ Processed: {Path.GetFileName(filePath)}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"✗ Failed: {Path.GetFileName(filePath)} - {ex.Message}");
    }
}

Console.WriteLine("\nValidation complete. Review output files in DICOM viewer.");

Troubleshooting

Инвалидни файлови пътеки

Ако профилът не може да бъде намерен:

string profilePath = "profile.csv";
if (!File.Exists(profilePath))
{
    Console.WriteLine($"Profile file not found: {profilePath}");
    return;
}

Invalid Tag Pattern или действие

Уверете се, че тегловите шаблони следват формата (GGGG,EEEE) където GGGG е групата и EEEE е елементът в hexadecimal. валидни действия са: D, Z, X, K, C, U.

Най-добрите практики за персонализирани профили

• Контрол на версии: Съхранявайте файловете на профила в контрола на версия, за да проследявате промените с течение на времето.
• Документация: Добавете коментари, които обясняват защо са избрани конкретни действия за всеки етикет.
• Тестиране: Валидирайте профилите с данни за тестване, преди да кандидатствате за производство на DICOM файлове.
• Backup: Винаги запазвайте резервни копия на оригинални профилни файлове.
• Ревизия: Профилите се проверяват периодично, за да се гарантира, че те все още отговарят на регулаторните изисквания.

Допълнителна информация

• Помислете за създаването на множество профили за различни случаи на употреба (вътрешно споделяне, външни изследвания и т.н.).
• Документ, чийто профил е бил използван при анонимизиране на файлове за одитни цели.
• JSON и XML формати предлагат по-добра структура за сложни профили с нежни дефиниции.

заключение

Този урок е показал как да се създадат персонализирани профили за анонимност на DICOM, като се използват CSV, JSON или XML файлове в C# с Aspose.Medical.