.NET API لتصوير DICOM الطبي
قراءة، كتابة، إخفاء هوية، تحويل الصيغة وعرض ملفات DICOM في .NET C#، وتبادل الدراسات عبر DIMSE و DICOMweb، دون أي برامج خارجية أو تبعيات أصلية.
Download Free TrialAspose.Medical for .NET هي مكتبة فئة .NET خالصة للعمل مع ملفات DICOM (التصوير الرقمي والاتصالات في الطب). تتيح للمطورين قراءة، كتابة، تعديل، إخفاء هوية، تحويل الصيغة وعرض بيانات التصوير الطبي، تسلسلها إلى DICOM JSON و DICOM XML، وتبادل الدراسات مع الأنظمة الأخرى عبر DIMSE و DICOMweb، دون أي برنامج خارجي أو تبعيات أصلية.
المكتبة مكتوبة بالكامل بلغة C# المدارة وتعمل على .NET 10 في Windows و Linux و macOS. لا توجد ملفات تنفيذية أصلية ولا حزم NuGet من أطراف ثالثة، لذا تُنشر المكتبة كملف تجميع واحد في أي تطبيق .NET، من أداة سطح مكتب إلى حاوية في نظام رعاية صحية سحابي.
الميزات الأساسية:
- قراءة وكتابة ملفات DICOM من ملف، أو تدفق، أو أنبوب، بشكل متزامن أو غير متزامن، مع دعم كامل لجميع عناصر البيانات القياسية وتمثيلات القيم.
- التحكم في الذاكرة للملفات الكبيرة: تحميل كل عنصر، تأجيل العناصر الكبيرة حتى تُستخدم، أو تخطيها وقراءة البيانات الوصفية فقط.
- قراءة وتعديل أي عنصر بيانات، بما في ذلك السلاسل والعلامات الخاصة، مع معالجة مجموعة الأحرف للنص غير ASCII.
- إخفاء هوية ملفات DICOM باستخدام ملفات الخصوصية وفقًا لـ DICOM PS 3.15، مع خيارات للاحتفاظ بـ UIDs، التواريخ، معرفات الجهاز والمؤسسة، وخصائص المريض.
- تحويل الصيغة بين أساليب النقل: JPEG، JPEG-LS، JPEG 2000، HTJ2K، JPEG XL و RLE، مع تنفيذ كل مشفر في .NET.
- عرض الإطارات إلى بكسلات BGRA مع جدول تحويل النمط (modality LUT)، جدول تحويل VOI (النافذة والمستوى) والطبقات المتراكبة التي يطبقها المرسِّم.
- تسلسل مجموعات البيانات إلى نموذج DICOM JSON (PS3.18) وإلى DICOM XML (PS3.19) والعكس، بما في ذلك البث غير المتزامن وتحميل البيانات الضخمة القابلة للإضافة.
- التواصل عبر DIMSE باستخدام عميل وخادم: C-ECHO، C-STORE، C-FIND، C-MOVE، C-GET، خدمات N، وTLS.
- استعلام قائمة عمل النمط، الإبلاغ عن MPPS وتوزيع العمل باستخدام عناصر عمل UPS-RS، كعميل وكخادم.
- البحث، تحميل وتنزيل الدراسات على أي خادم DICOMweb باستخدام عميل مُعَرّف لـ QIDO-RS، WADO-RS، STOW-RS، الصور المُعالجة، WADO-URI وخدمات سير العمل.
- إنشاء خادم DICOMweb الخاص بك: QIDO-RS، WADO-RS، STOW-RS وخدمات سير العمل على ASP.NET Core أو أي مستضيف HTTP آخر، مع تخزينك خلفها.
Aspose.Medical for .NET مكتبة مستقلة. لا تحتاج إلى عارض DICOM، ولا برنامج تصوير طبي ولا مشفرات أصلية للتثبيت. تتناسب مع أنظمة تقنية المعلومات في الرعاية الصحية، دمج PACS، منصات الطب عن بُعد وأي تطبيق يحتاج إلى معالجة بيانات DICOM بشكل موثوق.
ميزات متقدمة لواجهة برمجة تطبيقات .NET DICOM
قراءة وكتابة ملفات DICOM من ملفات، تدفقات أو أنابيب
الوصول إلى جميع علامات DICOM، السلاسل والعناصر الخاصة ومعالجتها
إخفاء هوية بيانات المريض باستخدام ملفات الخصوصية DICOM PS 3.15
تحويل الصيغة بين أساليب النقل، بما في ذلك HTJ2K و JPEG XL
عرض الإطارات إلى بكسلات للعارضات، المصغرات وتصدير الصور
تسلسل بيانات DICOM إلى JSON و XML، مع بث غير متزامن
تبادل الدراسات عبر DIMSE: C-ECHO، C-STORE، C-FIND، C-MOVE، C-GET
الحفاظ على الذاكرة ثابتة في الملفات الكبيرة عبر تأجيل أو تخطي العناصر الكبيرة
عرض الصور متعددة الإطارات مع Modality LUT، VOI LUT والطبقات المتراكبة
مكتبة .NET خالصة - بلا تبعيات
Aspose.Medical for .NET مكتوبة بالكامل بلغة C# المدارة وتُوزَّع كملف تجميع واحد دون ملفات تنفيذية أصلية أو حزم NuGet من أطراف ثالثة. المكتبات الأخرى للتصوير الطبي تعتمد على مشفرات أصلية أو أدوات خارجية؛ هذه لا تعتمد. جميع مشفرات ضغط الصور (JPEG، JPEG-LS، JPEG 2000، HTJ2K، JPEG XL، RLE) مُنفذة في .NET، لذلك تتصرف المكتبة بنفس الطريقة على Windows و Linux و macOS. هذا يجعلها ملائمة للحاويات، بيئات السحابة وأي نشر لا يمكن فيه تثبيت مكتبات أصلية. الحزمة تستهدف .NET 10.
إخفاء هوية ملفات DICOM للامتثال للخصوصية
خصوصية المريض متطلب أساسي في تطبيقات الرعاية الصحية. Aspose.Medical for .NET تُخفي هوية بيانات DICOM باستخدام ملفات الخصوصية وفق DICOM PS 3.15. يمكنك إزالة أو استبدال معلومات تعريف المريض مع الحفاظ على القيمة السريرية لبيانات التصوير، ويمكنك اختيار ما تحتفظ به الملف: السمات الخاصة الآمنة، UIDs، معرفات الجهاز والمؤسسة، خصائص المريض، والمعلومات الزمنية الطولية. تُظهر صفحة إخفاء هوية DICOM خيارات الملف بالتفصيل.
إخفاء هوية ملف DICOM - C#
// Load the DICOM file
DicomFile dicomFile = DicomFile.Open("patient_scan.dcm");
// Basic Application Level Confidentiality Profile of DICOM PS 3.15
ConfidentialityProfile profile = ConfidentialityProfile.CreateDefault(ConfidentialityProfileOptions.BasicProfile);
Anonymizer anonymizer = new(profile);
// Anonymize into a new file and save it
DicomFile anonymized = anonymizer.Anonymize(dicomFile);
anonymized.Save("anonymized_scan.dcm");عرض إطارات DICOM في .NET C#
Aspose.Medical for .NET يُحوّل إطار DICOM إلى صورة بكسل BGRA 32-بت. يطبق المرسِّم التفسير الضوئي، Modality LUT و VOI LUT (النافذة والمستوى) من مجموعة البيانات ويرسم الطبقات المتراكبة، بحيث يتطابق الناتج مع ما يعرضه العارض. ثم تكون البكسلات لك: انسخها إلى مخزن ومرّرها إلى أي مكتبة تصوير لحفظ PNG أو JPEG أو TIFF. المشفر الوحيد المدمج في المكتبة هو PNM. تُظهر صفحات التحويل المسار الكامل لـ PNG، JPEG و TIFF.
عرض إطار DICOM - C#
// Load the DICOM file
DicomFile dicomFile = DicomFile.Open("chest_xray.dcm");
// Render the first frame; LUTs and overlays are applied by the renderer
using PixelImage<Bgra32> image = dicomFile.RenderImage(0);
// Copy the pixels out and hand them to an imaging library
Bgra32[] pixels = new Bgra32[image.Width * image.Height];
image.CopyPixelsTo(pixels);تحويل الصيغة بين أساليب النقل
تتطلب أنظمة التصوير والأرشيفات أساليب نقل DICOM محددة. Aspose.Medical for .NET يحول بين الصيغ غير المضغوطة، JPEG Baseline، JPEG Extended، JPEG Lossless، JPEG-LS، JPEG 2000، HTJ2K (JPEG 2000 عالي السرعة)، JPEG XL و RLE. HTJ2K و JPEG XL هما أحدث خيارين في معيار DICOM، وهنا تم تنفيذهما في .NET كما هو الحال مع جميع المشفرات الأخرى. التحويل مهم لتكامل PACS، لحجم الأرشيف وللتوافق بين الأنظمة. راجع صفحة تحويل أسلوب النقل وصفحة JPEG 2000.
تحويل DICOM إلى HTJ2K - C#
// Load existing DICOM file
DicomFile dicomFile = DicomFile.Open("input.dcm");
// Transcode to High-Throughput JPEG 2000, lossless
DicomFile transcoded = dicomFile.Transcode(TransferSyntax.HTJ2KLossless);
// Save the transcoded file
transcoded.Save("output.dcm");تسلسل DICOM إلى JSON و XML
أنظمة الرعاية الصحية تتبادل البيانات عبر خدمات الويب، لذا تقوم Aspose.Medical for .NET بتسلسل مجموعات بيانات DICOM إلى نموذج DICOM JSON (PS3.18) وإلى DICOM XML (PS3.19)، وتعيد تحليل كليهما إلى مجموعات البيانات. تعمل المسلسلات على السلاسل، التدفقات والأنابيب، متزامنًا وغير متزامن، ويمكن قراءة تسلسل مجموعات البيانات واحدة تلو الأخرى دون الاحتفاظ بالمستند بالكامل في الذاكرة. يتم حل مراجع البيانات الضخمة عبر محمل قابل للإضافة، لذا يمكن ترك بيانات البكسل الكبيرة خارج المستند. راجع صفحات DICOM إلى JSON وDICOM إلى XML.
تسلسل DICOM إلى JSON و XML - C#
// Load the DICOM file
DicomFile dicomFile = DicomFile.Open("patient_scan.dcm");
Dataset dataset = dicomFile.Dataset;
// Serialize the dataset to JSON (DICOM JSON Model) and to DICOM XML
string json = DicomJsonSerializer.Serialize(dataset, writeIndented: true);
string xml = DicomXmlSerializer.Serialize(dataset);
// Parse both back into datasets
Dataset? fromJson = DicomJsonSerializer.Deserialize(json);
Dataset fromXml = DicomXmlSerializer.Deserialize(xml);شبكات DICOM عبر DIMSE
Aspose.Medical for .NET يتواصل مباشرة مع أنظمة DICOM الأخرى. توفر المكتبة عميل DIMSE وخادم DIMSE لـ C-ECHO، C-STORE، C-FIND، C-MOVE و C-GET، إلى جانب خدمات N، تفاوض الارتباط مع سياقات العرض والأدوار، نوافذ العمليات غير المتزامنة، تفاوض هوية المستخدم وTLS. تُقَدم الطلبات في طابور على الارتباط وتُستجاب بواسطة المعالجات التي تسجّلها، لذلك يصبح عقدة التخزين والإعادة أو وكيل الاستعلام أو اختبار SCP مسألة عدة فئات. تُظهر صفحة قائمة عمل النمط قائمة العمل وسير عمل MPPS في الطرفين. يغطي دليل شبكة DICOM واجهة برمجة التطبيقات بالكامل.
إرسال دراسة إلى PACS باستخدام C-STORE - C#
DicomFile dicomFile = DicomFile.Open("study.dcm");
DicomNetworkClient client = DicomNetworkClient
.CreateBuilder(new DicomNetworkClientOptions
{
Called = "PACS_AE",
Calling = "CLIENT_AE",
Connection = new DicomNetworkConnectionOptions
{
TargetHost = new IPEndPoint(IPAddress.Parse("192.0.2.10"), 104)
},
AssociationNegotiation = new AssociationNegotiationOptions()
.WithPresentationContext(new PresentationContext
{
AbstractSyntax = Uid.CTImageStorage,
Role = null,
TransferSyntaxes = ImmutableArray.Create(TransferSyntax.ExplicitVrLittleEndian)
})
})
.Build();
client.QueueRequest(new CStoreRequest(dicomFile.Dataset, TransferSyntax.ExplicitVrLittleEndian));
await client.SendAsync(CancellationToken.None);
await client.StopAsync();عميل وخادم DICOMweb
خدمات التصوير السحابية والأرشيفات الحديثة تُظهر DICOM عبر HTTP. عميل DICOMweb في Aspose.Medical for .NET يلتف حول كل عملية قياسية في طريقة مُعَرَّفة: بحث QIDO-RS، استرجاع دراسات، سلسلة، نسخ، إطارات، صور مُعالجة ومصغرات عبر WADO-RS، تحميل STOW-RS، WADO-URI، وخدمات قائمة العمل، خطوة الإجراء والالتزام بالتخزين. يعمل على HttpClient الخاص بك، لذا يبقى المصادقة وTLS حيث يتم تكوينهما في تطبيقك، وتأتي النتائج كمجموعات البيانات والملفات نفسها التي تعمل معها باقي المكتبة. تنفّذ المكتبة نفسها جانب الخادم: تتعامل مع بروتوكول QIDO-RS، WADO-RS، STOW-RS وخدمات سير العمل، ويتصل كودك بالتخزين. راجع صفحات عميل DICOMweb وخادم DICOMweb.
البحث عن دراسات على خادم DICOMweb - C#
using HttpClient http = new HttpClient();
DicomWebClient client = new DicomWebClient(http, new DicomWebClientOptions
{
BaseUri = new Uri("https://pacs.example.org/dicom-web/")
});
DicomWebSearchOptions search = new DicomWebSearchOptions
{
MatchingParameters = [new DicomWebQueryParameter("PatientID", "PATIENT-001")]
};
await using DicomWebClientStream<Dataset> studies = await client.Studies.SearchAsync(search);
await foreach (Dataset study in studies)
Console.WriteLine(study.GetSingleValueOrDefault(Tag.StudyInstanceUID, string.Empty));ملفات DICOM الكبيرة دون ذاكرة كبيرة
لا تتسع الصور الشرائحية الكاملة، السلاسل الطويلة والدراسات متعددة الإطارات للذاكرة بسهولة. Aspose.Medical for .NET يتيح لك تحديد مقدار ما يُحمَّل من الملف: قراءة كل شيء، تأجيل العناصر التي تتجاوز حدًا معينًا حتى تُستَخدم، أو تخطيها والعمل بالبيانات الوصفية فقط. القراءة من تدفق أو أنبوب والكتابة بنفس الطريقة يحافظ على حركة البيانات بدلاً من تراكمها. يوضح دليل إدارة الذاكرة المقايضات.
قراءة البيانات الوصفية دون بيانات البكسل - C#
// Elements larger than the threshold are not loaded into memory
DicomFile metadataOnly = DicomFile.Open(
"whole_slide.dcm",
ReadDicomFileOptions.Default,
TagDataReadingStrategies.SkipLargeTags());
string? patientName = metadataOnly.Dataset.GetSingleValueOrDefault(Tag.PatientName, string.Empty);Support and Learning Resources
- موارد التعلم
- التوثيق
- دليل المطور
- مرجع واجهة برمجة التطبيقات
- دعم المنتج
- دعم مجاني
- دعم مدفوع
- المدونة
- ملاحظات الإصدار
- لماذا Aspose.Medical for .NET؟
- قائمة العملاء
- قصص نجاح