【转】DCMTK开源库的学习笔记4：利用ini配置文件对dcm影像进行归档

浅浅的花香味﹌ 2023-01-14 05:51 129阅读 0赞

转自：[https://blog.csdn.net/zssureqh/article/details/8846337][https_blog.csdn.net_zssureqh_article_details_8846337]

**背景介绍：**

医学影像PACS工作站的服务端需要对大量的dcm文件进行归档，写入数据库处理。由于医学图像的特殊性，每一个患者（即所谓的Patient）每做一次检查（即Study）都至少会产生一组图像序列（即Series），而每一组图像序列下会包含大量的dcm文件（例如做一次心脏CTA的诊断，完整的一个心脏断层扫描序列大约有200幅图像）。DICOM3.0协议中对每一幅影像是按照特定的三个UID（唯一标示符）来进行标记的，分别是StudyInstanceUID、SeriesInstanceUID、SOPInstanceUID。其中StudyInstanceUID代表了唯一的一次检查（Study），SeriesInstanceUID代表了相应检查下的唯一序列（Series）、SOPInstanceUID代表了唯一检查下的唯一序列下的唯一图像。通常PACS工作站都是利用这三个UID来对dcm文件进行归档处理。

**归档的设计：**

**1、基本的归档结构是：**

<table> 
 <tbody> 
  <tr> 
   <td> <p><strong>第一级：StudyInstanceUID</strong></p> </td> 
   <td> <p>存储同一患者的影像数据</p> </td> 
  </tr> 
  <tr> 
   <td> <p><strong>第二级：SeriesInstanceUID</strong></p> </td> 
   <td> <p>存储同一次检查下的影像数据</p> </td> 
  </tr> 
  <tr> 
   <td> <p><strong>第三级：SOPInstanceUID</strong></p> </td> 
   <td> <p>存储同一个序列下的影像数据</p> </td> 
  </tr> 
 </tbody> 
</table>

了解了大致的归档结构后，现在应该考虑怎样将dcm记录写入到数据库中？最直观的想法就是将每一个dcm文件都记录在数据库中，这样当需要读取指定的dcm文件时通过给定的三个UID直接在数据库中查询就能够得到。但是如此一来，数据库的容量会急剧增加，同一患者在数据库中存在着大量的冗余记录。因为患者的影像数据是按照上述的三级目录来归档的，大量的相关的影像数据存储在服务器的同一个目录下，对于同一个序列的图像可以直接在第二级目录中利用SOPInstanceUID来进行检索，而不需要进行数据库的查询。但是当二级目录下的文件数量较大时，检索文件件中的文件同样需要耗费大量的时间，那么怎样可以提高检索效率呢？答案就是：配置文件。由于在归档的时候我们已经读取过每个dcm文件的三个UID，那么可以将归档时候读取的UID信息写入到相应的INI配置文件中，并存储到相应的图像序列目录下。那么在检索图像时，通过前两级UID可以快速在数据库中查询到影像数据的归档目录，当进入到指定的归档目录后，利用归档时生成的INI文件，可以快速的检索到指定的dcm文件，另外如果归档时将一些常用的dcm文件信息一同写入到INI配置文件中（如图像的宽度、高度、患者姓名、出生年月、窗宽/窗位等），在后续的一些图像处理中同样能够节约时间，提高效率。

**2、INI配置文件的生成**

INI配置文件的格式就不细讲了，CSDN中已有很多详细讲解的博文，请大家自行参阅。这次详细讲解一下利用dcmtk开源库来提取相应的dcm文件信息并写入到ini配置文件中的方法。

DCMTK开源库是一个很好的医学影像开发基础库，其很好的实现了DICOM3.0标准，且类的继承体系简单明了，与DICOM3.0标准一一对应（参考博文：“[dcmtk开源库的继承体系与DICOM3.0标准的对应关系][dcmtk_DICOM3.0]”）。这里我们只用到了dcmtk中的DcmItem类，该类派生自DcmObject基础类，其含有ElementList成员变量，存储了DICOM3.0标准中规定的一系列的数据元（Data Element）基本结构如下图所示：

![d961bc9ff47c93df050d2529178c0e81.png][]

注：DcmItem类就是Dataset（数据集）的子类。其内部包含了数据元序列（即ElementList数据成员）。

通过阅读关于DcmItem类的源码，总结归纳了以下几种dcmtk开源库给出的操作dcm文件相应数据元的函数：findAndGet 函数、findOrCreate函数、findAndXXX函数、putAndInsert函数，以及insertXXX函数，如下图：

![873649141bfb320d885260dcb0347305.png][]

至此我们可以利用findAndGet函数类来提取dcm文件中的相关信息，结合WindowsAPI函数来进行INI配置文件的归档。由于INI配置文件就是文本文件，因此我们选用了DcmItem中的findAndGetString函数来提取dcm文件中的数据元，利用findAndGetString函数能够直接得到字符串格式（const char\*）的数据元，另外，结合WritePrivateProfileString函数来生成INI配置文件。（注：此处findAndGetString函数正好与WritePrivateProfileString函数的格式匹配，如果采用findAndGet的其他函数，如findAndGetSin32，就需要利用itoa等函数将整型转换成const char\*类型，增加了编程的复杂性）

下面给出部分代码：

DcmTagKey THU_DCM_ELEMENTS[]={DCM_InstanceNubmber, DCM_Rows,DCM_Columns,DCM_PatientName};//定义需要写入到ini文件中的dcm数据元标签数组
    		int num=sizeof(THU_DCM_ELEMNTS)/sizeof(DcmTagKey);
    		OFString mImageValue;
    		OFString mGap("|");//INI配置文件中各个数据元之间的间隔符
    		OFString mImageModule("ImageModule\\");//配置文件的节名称
    		OFString mSOPInstanceUID;
    		OFString mSeriesInstanceUID;
    		DcmDataset *pDataset=mDcmFile->getDataset();
    		DcmMetaInfo *pMetaInfo=mDcmFile->getMetaInfo();
    		pDataset->findAndGetOFString(DCM_SeriesInstanceUID,mSeriesInstanceUID);
    		pDataset->findAndGetOFString(DCM_SOPInstanceUID,mSOPInstanceUID);
    		mImageModule+=mSeriesInstanceUID;
    		for(int i=0;i<num;++i)
    		{
    			OFString mValueRecord;
    			DcmElement *element;
    			if(THU_DCM_ELEMNTS[i].getGroup()>0x0002)// to determine if the THU_DCM_ELEMENTS[i] is MetaInfo
    			{
    				//the element belongs to Dataset
    				pDataset->findAndGetOFStringArray(THU_DCM_ELEMNTS[i],mValueRecord);
    				mValueRecord+=mGap;
    			}
    			else
    			{
    				//the element belongs to MetaInfo
    				if(THU_DCM_ELEMNTS[i].getGroup()==0x0000 && THU_DCM_ELEMNTS[i].getElement()==0x0000)
    				{
    					mValueRecord=mGap;
    				}
    				else
    				{
    					pMetaInfo->findAndGetOFStringArray(THU_DCM_ELEMNTS[i],mValueRecord);
    					mValueRecord+=mGap;
    				}
    
    			}
    			mImageValue+=mValueRecord;
    		}
    		::WritePrivateProfileString(mImageModule.c_str(),mSOPInstanceUID.c_str(),mImageValue.c_str(),iniFileName);

**3、数据库的写入：**

数据库写入的方式与INI配置文件生成基本相似，只要稍微了解C++数据库编程的人员，就很容易仿照上述INI配置文件的生成过程来完成数据库写入的部分，此处就不细讲了，只给出简单的部分代码：

DcmFileFormat fileformat;
    				TCHAR FilePath[MAX_PATH];
    				OFCondition oc = fileformat.loadFile(FilePath);
    				DcmDataset *pDataset=fileformat.getDataset();
    				char query[1000];
    				memset(query,0,sizeof(char)*1000);
    				lstrcat(query,_T("insert into patient values ("));
    
    				const char *tString;
    				pDataset->findAndGetString(DCM_InstanceNumber,tString);
    				lstrcat(query,tString);
    				lstrcat(query,_T(","));
    				pDataset->findAndGetString(DCM_PatientName,tString);
    				lstrcat(query,_T("\""));
    				lstrcat(query,tString);
    				lstrcat(query,_T("\""));
    				lstrcat(query,_T(","));
    				pDataset->findAndGetString(DCM_PatientID,tString);
    				lstrcat(query,tString);
    				lstrcat(query,_T(","));
    				pDataset->findAndGetString(DCM_PatientBirthDate,tString);
    				lstrcat(query,tString);
    				lstrcat(query,_T(","));
    				pDataset->findAndGetString(DCM_PatientSex,tString);
    				lstrcat(query,"\"");
    				lstrcat(query,tString);
    				lstrcat(query,"\"");
    				lstrcat(query,",");
    				pDataset->findAndGetString(DCM_PatientAge,tString);
    				char temp[100];
    				memcpy(temp,tString,lstrlen(tString));
    				temp[lstrlen(tString)]=_T('\0');
    				for(int i=0;i<strlen(temp);++i)
    					if(temp[i]==_T('Y'))
    						temp[i]=_T('\0');
    				lstrcat(query,temp);
    				lstrcat(query,",");
    				lstrcat(query,_T("2013)"));		
    				//mysql数据库的写入
    				MYSQL* con;
    				con=mysql_init((MYSQL*)0);
    				if(con!=NULL && mysql_real_connect(con,host,user,passwd,db,port,unix_socket,client_flag))
    				{
    					if(!mysql_select_db(con,db))
    					{
    						::printf("Selcet successfully the database!\n");
    
    						con->reconnect=1;
    						int rt=mysql_real_query(mysql,query,strlen(query));
    						if(rt)
    						{
    							::printf("Error making insert!!!\n");
    						}
    
    					}
    			
    				}

对于MYSQL的C++操作，可以参见博文： [http://www.cnblogs.com/justinzhang/archive/2011/09/23/2185963.html][http_www.cnblogs.com_justinzhang_archive_2011_09_23_2185963.html]

[https_blog.csdn.net_zssureqh_article_details_8846337]: https://blog.csdn.net/zssureqh/article/details/8846337
[dcmtk_DICOM3.0]: https://javar.blog.csdn.net/article/details/115895095
[d961bc9ff47c93df050d2529178c0e81.png]: /images/20221022/84164e10dd9a4d289136ed5e78654b58.png
[873649141bfb320d885260dcb0347305.png]: /images/20221022/9c2d642897ba442c8637b923e1f0f3f2.png
[http_www.cnblogs.com_justinzhang_archive_2011_09_23_2185963.html]: http://www.cnblogs.com/justinzhang/archive/2011/09/23/2185963.html