fo-dicom，第一个基于.NET Standard 2.0 开发的DICOM开源库

ops/2024/9/25 14:55:29/

在这里插入图片描述

1. 简介：

fo-dicom是一个基于C#开发的库，用于处理DICOM（Digital Imaging and Communications in Medicine）格式的数据。DICOM是一种用于医学影像和相关信息的标准格式，广泛应用于医学领域。fo-dicom提供了多平台支持，可在 Windows、Linux 和 macOS 等操作系统上运行。

fo-dicom库的设计理念是提供一个方便、易用、功能强大的工具，用于处理、读取、写入和修改DICOM文件。该库提供了丰富的API，支持对DICOM文件的标签进行读取和设置，支持对DICOM文件的编码和解码，支持对DICOM文件的传输和存储。

fo-dicom库还提供了对DICOM消息流的封装，使得开发者可以方便地实现自定义的DICOM服务。该库还支持对网络底层的封装，使得开发者可以轻松地实现基于网络的DICOM通信。

开源库地址

2. 开发的背景和目的：

fo-dicom库的产生是为了解决医学图像处理和DICOM数据交换的需求。在医学领域，DICOM（Digital Imaging and Communications in Medicine）是一种用于存储、传输和共享医学影像和相关信息的标准。由于医学影像数据的特殊性和复杂性，需要一个专门的库来处理DICOM数据，并提供方便的接口和工具。

背景上来说，DICOM标准的出现是为了解决各种医学设备之间的互操作性问题。在过去，不同厂商的医学设备使用自己的私有格式来存储和传输影像数据，这导致了数据共享和集成的困难。DICOM标准的制定使得不同设备可以使用统一的格式和通信协议，从而实现医学影像的无缝交流和协作。

fo-dicom作为一个开源的DICOM库，旨在提供一个易于使用且功能强大的工具，使得开发者能够处理医学图像和相关数据。它基于DICOM标准，提供了读取、创建、修改和存储DICOM数据的功能，同时支持医学图像的加载、处理和保存。此外，fo-dicom还具备与远程PACS（Picture Archiving and Communication System）或其他DICOM节点的网络通信能力，以及查询和检索功能，方便用户根据条件查询和获取DICOM实例。

3.主要特点和安装方式

阅读官方文档，即可获得安装方法：官方文档
在这里插入图片描述

4. 主要功能：

  • DICOM 数据处理：fo-dicom 支持读取、创建、修改和存储 DICOM 数据。用户可以轻松访问和操作 DICOM 文件和数据集。
  • 图像处理：该库提供了对医学图像的加载、处理和保存功能。用户可以进行像素级别的操作、图像增强、格式转换等操作。
  • DICOM 网络通信：fo-dicom 具备与远程 PACS 或其他 DICOM 节点的网络通信能力，使用户可以发送和接收 DICOM 消息。
  • 查询和检索：fo-dicom 实现了查询和检索功能，用户可以根据条件进行 DICOM 实例的查询和获取。这有助于快速访问所需的医学图像和相关数据。

5. 使用说明：

图像渲染配置

开箱即用的 fo-dicom 默认为内部类
FellowOakDicom.Imaging.IImage 样式的图像渲染。若要切换到桌面样式或 ImageSharp 样式的图像呈现，首先必须添加所需的 nuget 包，然后调用：

new DicomSetupBuilder().RegisterServices(s => s.AddFellowOakDicom().AddImageManager<WinFormsImageManager>())
.Build();
或new DicomSetupBuilder().RegisterServices(s => s.AddFellowOakDicom().AddImageManager<ImageSharpImageManager>())
.Build();

然后，在渲染时，可以通过以下方式将 IImage 强制转换为类型

var image = new DicomImage("filename.dcm");
var bitmap = image.RenderImage().As<Bitmap>();
//或
var image = new DicomImage("filename.dcm");
var sharpimage = image.RenderImage().AsSharpImage();

日志记录配置

Fellow Oak DICOM 使用 ，因此如果您已经在使用它，则 Fellow Oak DICOM 日志记录将自动显示。
Microsoft.Extensions.Logging

过去，Fellow Oak DICOM 有一个用于日志记录的自定义抽象：ILogger 和 ILogManager。 出于向后兼容性的目的，这仍然受支持，但不建议用于新应用程序。

services.AddLogManager<MyLogManager>();

其中 MyLogManager 如下所示：

using FellowOakDicom.Log;public class MyLogManager: ILogManager {public ILogger GetLogger(string name) {...}
}

6示例应用程序

这里有许多使用 fo-dicom 的简单示例应用程序，它们位于单独的存储库中。这些还包括示例 以前包含在 VS 解决方案的“示例”子文件夹中。

文件操作

var file = DicomFile.Open(@"test.dcm");             // Alt 1
var file = await DicomFile.OpenAsync(@"test.dcm");  // Alt 2var patientid = file.Dataset.GetString(DicomTag.PatientID);file.Dataset.AddOrUpdate(DicomTag.PatientName, "DOE^JOHN");// creates a new instance of DicomFile
var newFile = file.Clone(DicomTransferSyntax.JPEGProcess14SV1);file.Save(@"output.dcm");             // Alt 1
await file.SaveAsync(@"output.dcm");  // Alt 2

将图像渲染为 JPEG

var image = new DicomImage(@"test.dcm");
image.RenderImage().AsBitmap().Save(@"test.jpg");                     // Windows Forms

C-Store SCU系列

var client = DicomClientFactory.Create("127.0.0.1", 12345, false, "SCU", "ANY-SCP");
await client.AddRequestAsync(new DicomCStoreRequest(@"test.dcm"));
await client.SendAsync();

C-Echo SCU/SCP

var server = new DicomServer<DicomCEchoProvider>(12345);var client = DicomClientFactory.Create("127.0.0.1", 12345, false, "SCU", "ANY-SCP");
client.NegotiateAsyncOps();
// Optionally negotiate user identity
client.NegotiateUserIdentity(new DicomUserIdentityNegotiation
{UserIdentityType = DicomUserIdentityType.Jwt,PositiveResponseRequested = true,PrimaryField = "JWT_TOKEN"
});
for (int i = 0; i < 10; i++)await client.AddRequestAsync(new DicomCEchoRequest());
await client.SendAsync();
C-Find SCUvar cfind = DicomCFindRequest.CreateStudyQuery(patientId: "12345");
cfind.OnResponseReceived = (DicomCFindRequest rq, DicomCFindResponse rp) => {Console.WriteLine("Study UID: {0}", rp.Dataset.GetString(DicomTag.StudyInstanceUID));
};var client = DicomClientFactory.Create("127.0.0.1", 11112, false, "SCU-AE", "SCP-AE");
await client.AddRequestAsync(cfind);
await client.SendAsync();

C-Move SCU系列

var cmove = new DicomCMoveRequest("DEST-AE", studyInstanceUid);var client = DicomClientFactory.Create("127.0.0.1", 11112, false, "SCU-AE", "SCP-AE");
await client.AddRequestAsync(cmove);
await client.SendAsync();

N-Action SCU

// It is better to increase 'associationLingerTimeoutInMs' default is 50 ms, which may not be
// be sufficient
var dicomClient = DicomClientFactory.Create("127.0.0.1", 12345, false, "SCU-AE", "SCP-AE",
DicomClientDefaults.DefaultAssociationRequestTimeoutInMs, DicomClientDefaults.DefaultAssociationReleaseTimeoutInMs,5000);
var txnUid = DicomUIDGenerator.GenerateDerivedFromUUID().UID;
var nActionDicomDataSet = new DicomDataset
{{ DicomTag.TransactionUID,  txnUid }
};
var dicomRefSopSequence = new DicomSequence(DicomTag.ReferencedSOPSequence);
var seqItem = new DicomDataset()
{{ DicomTag.ReferencedSOPClassUID, "1.2.840.10008.5.1.4.1.1.1" },{ DicomTag.ReferencedSOPInstanceUID, "1.3.46.670589.30.2273540226.4.54" }
};
dicomRefSopSequence.Items.Add(seqItem);
nActionDicomDataSet.Add(dicomRefSopSequence);
var nActionRequest = new DicomNActionRequest(DicomUID.StorageCommitmentPushModelSOPClass,DicomUID.StorageCommitmentPushModelSOPInstance, 1)
{Dataset = nActionDicomDataSet,OnResponseReceived = (DicomNActionRequest request, DicomNActionResponse response) => {Console.WriteLine("NActionResponseHandler, response status:{0}", response.Status);},
};
await dicomClient.AddRequestAsync(nActionRequest);
dicomClient.OnNEventReportRequest = OnNEventReportRequest;
await dicomClient.SendAsync();private static Task<DicomNEventReportResponse> OnNEventReportRequest(DicomNEventReportRequest request)
{var refSopSequence = request.Dataset.GetSequence(DicomTag.ReferencedSOPSequence);foreach(var item in refSopSequence.Items){Console.WriteLine("SOP Class UID: {0}", item.GetString(DicomTag.ReferencedSOPClassUID));Console.WriteLine("SOP Instance UID: {0}", item.GetString(DicomTag.ReferencedSOPInstanceUID));}return Task.FromResult(new DicomNEventReportResponse(request, DicomStatus.Success));
}

C-ECHO

具有高级 DICOM 客户端连接的 C-ECHO：手动控制 TCP 连接和 DICOM 关联

var cancellationToken = CancellationToken.None;
// Alternatively, inject IDicomServerFactory via dependency injection instead of using this static method
using var server = DicomServerFactory.Create<DicomCEchoProvider>(12345); var connectionRequest = new AdvancedDicomClientConnectionRequest
{NetworkStreamCreationOptions = new NetworkStreamCreationOptions{Host = "127.0.0.1",Port = server.Port,}
};// Alternatively, inject IAdvancedDicomClientConnectionFactory via dependency injection instead of using this static method
using var connection = await AdvancedDicomClientConnectionFactory.OpenConnectionAsync(connectionRequest, cancellationToken);var associationRequest = new AdvancedDicomClientAssociationRequest
{CallingAE = "EchoSCU",CalledAE = "EchoSCP",// Optionally negotiate user identityUserIdentityNegotiation = new DicomUserIdentityNegotiation{UserIdentityType = DicomUserIdentityType.UsernameAndPasscode,PositiveResponseRequested = true,PrimaryField = "USERNAME",SecondaryField = "PASSCODE",}
};var cEchoRequest = new DicomCEchoRequest();using var association = await connection.OpenAssociationAsync(associationRequest, cancellationToken);
try
{DicomCEchoResponse cEchoResponse = await association.SendCEchoRequestAsync(cEchoRequest, cancellationToken).ConfigureAwait(false);Console.WriteLine(cEchoResponse.Status);
}
finally
{await association.ReleaseAsync(cancellationToken);
}

7. 社区和生态：

fo-dicom 有一个活跃的社区，包括众多贡献者和维护者。它在 GitHub 上有一个开放的仓库，用户可以在其中提交问题、提出建议和贡献代码。fo-dicom 的更新频率较高，并得到了广泛的应用和认可。

为了方便新手学习官方构建了样例库：
在这里插入图片描述
同时支持多个平台的案例开发开发。
在这里插入图片描述

8. 优势和劣势：

  • 优势：fo-dicom 是一个强大且易于使用的 DICOM 库，具备处理医学图像和相关数据的核心功能。它提供了多平台支持、良好的文档和示例代码，并拥有一个活跃的社区。
  • 劣势：由于 DICOM 标准的复杂性，初学者可能需要一些时间来适应 fo-dicom 的使用方式。另外，某些高级功能可能需要额外的配置或第三方组件的支持。

9. 未来计划和发展方向：

fo-dicom 的未来计划包括进一步增强图像处理功能、优化性能、改进网络通信和增加对新版 DICOM 标准的支持。通过不断改进和扩展功能，fo-dicom 将继续满足用户对医学图像处理和数据交互的需求。

今天先介绍到这里，后续我将持续分享关于fo-dicom库的使用经验技巧，欢迎有需要的朋友持续关注。


http://www.ppmy.cn/ops/115829.html

相关文章

日常生活中喝够水，能帮助预防多种慢性病、提高免疫力，还能改善情绪、提高认知能力！

日常生活中喝够水，能帮助预防多种慢性病、提高免疫力，还能改善情绪、提高认知能力！

文章目录 引言多喝水的好处为何人体中水分含量这么高？引言 感到口渴时，人体缺水程度已经在 1%~2% 了。建议大家养成随时喝、少量多次的习惯，在口渴前喝水，避免影响健康。 水分的丢失却无时无刻不在发生，即便没有大量出汗，每天通过呼吸、排泄、皮肤蒸发就能排出 1.5~2 升…
阅读更多...
Oracle和JSON结合起来，开发者的福利

Oracle和JSON结合起来，开发者的福利

Oracle Database 23c在简化开发、应对开发发力了&#xff0c;更多拥抱开发者方面的能力&#xff0c;真的是人惊讶&#xff0c;这几天也是参加Oracle官方组织的AI专家培训&#xff0c;受益非浅&#xff0c;在这里给大家分享一下通过 ORDS操作对外暴露Http Restful服务&#xff0…
阅读更多...
【多模态大模型】Qwen2-VL基本原理和推理部署实战

【多模态大模型】Qwen2-VL基本原理和推理部署实战

文章目录 Qwen2-VL基本原理Qwen-VL简要回顾Qwen2-VL的高级升级统一视觉处理方式原生动态分辨率处理&#xff08;非大图切分方式&#xff09;多模态旋转位置编码 Qwen2-VL推理实现|代码解析单图推理视觉信息预处理找到能被28整除的最合适size最大最小pixel数边界处理 多模态信息…
阅读更多...
mysql怎么让字段从1开始自增？

mysql怎么让字段从1开始自增？

mysql怎么让字段从1开始自增&#xff1f; 要确保一个 AUTO_INCREMENT 字段从1开始自增&#xff0c;你需要在创建表的时候指定 AUTO_INCREMENT 的起始值为1&#xff0c; 或者在表创建之后手动设置 AUTO_INCREMENT 的值。 1.创建表时指定 当你创建表的时候&#xff0c;可以直接…
阅读更多...
新峰商城之分类三级联动实现

新峰商城之分类三级联动实现

新峰商城是一个开源电子商务网站&#xff08;SpringBoot项目&#xff09;&#xff0c;本文主要简述它的商品分类中三级联动功能的实现。 一、多层级联动效果的常见场景 二、三级联动或者更多层级的数据联动是常见交互方式&#xff0c;它可以提升用户体验&#xff0c;限制用户随…
阅读更多...
Qt上下文菜单

Qt上下文菜单

在Qt中&#xff0c;上下文菜单&#xff08;Context Menu&#xff09;是一种弹出式的、与用户当前鼠标位置相关的菜单&#xff0c;它通常用于提供针对特定元素的快速操作选项&#xff0c;比如右键点击某个控件时会出现的菜单。Qt::ContextMenuPolicy是一个枚举类型&#xff0c;用…
阅读更多...
Python知识点：如何使用C/C++扩展Python功能

Python知识点：如何使用C/C++扩展Python功能

开篇&#xff0c;先说一个好消息&#xff0c;截止到2025年1月1日前&#xff0c;翻到文末找到我&#xff0c;赠送定制版的开题报告和任务书&#xff0c;先到先得&#xff01;过期不候&#xff01; 在Python中&#xff0c;你可以使用C或C来编写扩展模块&#xff0c;从而提高性能…
阅读更多...
鹏哥C语言51---第7次作业：函数的定义和调用

鹏哥C语言51---第7次作业：函数的定义和调用

#define _CRT_SECURE_NO_WARNINGS #include <stdio.h> #include <string.h> #include <math.h> //------------------------------------------------------------------------------------------第 7 次作业 函数定义和调用 //---------------------------…
阅读更多...
最新文章

Copyright @ 2022~2023