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

🕗 发布于 2024-09-22 08:48 .net fo-dicom

在这里插入图片描述

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 2

var 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 SCU

var 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 identity
    UserIdentityNegotiation = 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库的使用经验技巧，欢迎有需要的朋友持续关注。

原文地址：https://blog.csdn.net/houbincarson/article/details/142345394

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：Maven重点学习笔记(包入门 2万字)
下一篇：Java 线程之间如何通信？

低版本JMX Console未授权
低版本JMX Console未授权
阅读更多2024-09-22
图书管理系统
这样所有书籍的所有信息和借阅记录都会保存在文件里，使用查看图书功能可以直接查看。如果不想要这些信息可以直接删除，但只能一条一条的删除（以后会添加一键全部删除的功能）。下面是一个用Python写的图书管
阅读更多2024-09-22
外包干了4年，技术退步太明显了。。。。。
先说一下自己的情况，本科生生，20年通过校招进入武汉某软件公司，干了差不多4年的功能测试，今年国庆，感觉自己不能够在这样下去了，长时间呆在一个舒适的环境会让一个人堕落!没办法，我找到了我在腾讯的老哥，
阅读更多2024-09-22
【学习笔记】STM32F407探索者HAL库开发（五）F407时钟系统配置
在单片机系统中，设计时以时序电路控制替代纯粹的组合电路，在每一级输出结果前对各个信号进行采样，从而使得电路中某些信号即使出现延时也可以保证各个信号的同步，可以避免电路中发生的“毛刺现象”，达到精确控制
阅读更多2024-09-22
C++ 知识要点：其它
八. 其它调试程序的方法？gdb遇到 coredump 要怎么调试？模板的用法与适用场景用过 C++11？新特性？auto,decltype、explicit、lambda、final函数调用的压栈过
阅读更多2024-09-22
【机器学习】11——矩阵求导
矩阵求导
阅读更多2024-09-22
在excel中使用python？
是的！excel中可以使用python了！在去年8月22日，微软通过官方博客发布将与anaconda展开合作，简而言之就是excel将支持python，可以在表格中直接利用python就行数据分析，可
阅读更多2024-09-22
第160天：安全开发-Python-蓝队项目&流量攻击分析&文件动态监控&Webshell检测
本来后续上传的文件，可以调用api接口上传到威胁分析平台进行分析是否有害，根据分析返回的结果，来判断是否进行删除，但是百度免费的网站已经停掉了，virustotal免费的api坏掉了，别的免费的不好用
阅读更多2024-09-22
【Flink实战】flink消费http数据并将数组展开多行
【Flink实战】flink消费http数据并将数组展开多行
阅读更多2024-09-22
【Android】浅析MVC与MVP
架构（Architecture）在软件开发中指的是软件系统的整体设计和结构，它描述了系统的高层组织方式，包括系统中各个组件之间的关系、依赖、交互方式，以及这些组件如何协同工作来完成系统的功能。组件的划
阅读更多2024-09-22