本文介绍胸部CT肺结节检测DetectLungNodule的语法及示例。
功能描述
胸部CT肺结节检测可以对输入的胸部常规CT形成的DICOM影像(如5mm的单个序列,API仅接受单序列),进行肺结节的辅助诊断。针对每一个结节,主要通过以下方式进行描述:
- 结节的坐标(coordX,coordY,coordZ)、直径(diameter_mm)。
- 结节在肺叶的位置,例如左肺或右肺,以及肺叶分段(左肺上下叶、右肺上中下叶),通过lung和lobe两个参数共同确定。
- 结节分类及概率。
前提条件
输入限制
- 影像格式:DICOM。
- 影像分辨率:小于等于512×512像素。
- 单张DICOM影像大小不超过1M。
- 输入最少20张,最多600张。
- URL中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DetectLungNodule |
要执行的操作。取值:DetectLungNodule。 |
DataFormat | String | 是 | DICOM |
图片的格式:DICOM。 |
OrgId | String | 是 | 0001 |
数据来源机构代码。 |
OrgName | String | 是 | weiyi |
数据来源机构名称。 |
URLList.N.URL | String | 是 | https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/LIDC-IDRI-0001/000001.dcm |
DICOM影像的图像URL地址。长度小于600。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
Threshold | Float | 否 | 0.70 |
结点阈值。默认取值0.70,取值范围 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Series | Array of Serie |
本次影像分析的分序列的结果,只支持单序列,故该jsonArray的长度为1。数组元素为单个序列的检测结果,由analysisResult和seriesInstanceUid构成。 |
|
Elements | Array of Element |
结节描述。 |
|
Category | String | 1 |
结节分类,取值包括:0-ggo(磨玻璃影)、1-part-solid(部分实性)、2-solid(实性)及3-unknown(未知)。 |
Confidence | Float | 0.7012705768508907 |
结节分类的置信度。 |
Diameter | Float | 9.730626493692398 |
结节的直径。 |
ImageX | Float | 308.9676976455463 |
结节在图像坐标系中的x轴坐标值。 |
ImageY | Float | 198.3552282631497 |
结节在图像坐标系中的y轴坐标值。 |
ImageZ | Float | 20.434030793471255 |
结节在图像坐标系中的z轴坐标值。 |
Lobe | String | up |
肺叶分段。取值包括:up(上叶)、middle(中叶)、down(下叶)及unknown(未知)。 |
Lung | String | left |
结节在肺叶的位置。取值包括:left(左肺)、right(右肺)及unknown(未知)。 |
MeanValue | Float | 261.37589112119247 |
平均CT值,单位为HU。 |
SOPInstanceUID | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013 |
结节中心位置所在帧的ID标识。 |
Volume | Float | 10959.220491175074 |
结节体积,单位为mm³。 |
X | Float | 51.24291240631416 |
结节在物理坐标系中的x轴坐标值。 |
Y | Float | -32.23147700784307 |
结节在物理坐标系中的y轴坐标值。 |
Z | Float | -46.81608170781766 |
结节在物理坐标系中的z轴坐标值。 |
Origin | List | [-166.0,-171.6999969482422,-340.0] |
图像坐标系原点在物理坐标系中的位置。 |
Report | String | 肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。 |
该DICOM序列经过AI分析后AI服务给出的参考报告。 |
SeriesInstanceUid | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192 |
本次分析影像的序列ID。 |
Spacing | List | [0.703125,0.703125,14.34782600402832] |
每个像素的实际距离间隔。 |
RequestId | String | 9889ef5b-b973-4dd0-9f26-3b9cc489c436 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DetectLungNodule
&DataFormat=DICOM
&OrgId=0001
&OrgName=weiyi
&URLList.1.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/LIDC-IDRI-0001/000001.dcm
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>9889ef5b-b973-4dd0-9f26-3b9cc489c436</RequestId>
<Data>
<Series>
<Report>肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。</Report>
<SeriesInstanceUid>1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192</SeriesInstanceUid>
</Series>
<Series>
<Elements>
<ImageZ>20.434030793471255</ImageZ>
<ImageY>198.3552282631497</ImageY>
<ImageX>308.9676976455463</ImageX>
<Lobe>up</Lobe>
<Category>1</Category>
<Lung>left</Lung>
<MeanValue>261.37589112119247</MeanValue>
<Volume>10959.220491175074</Volume>
<Confidence>0.7012705768508907</Confidence>
<X>51.24291240631416</X>
<Y>-32.23147700784307</Y>
<Z>-46.81608170781766</Z>
<SOPInstanceUID>1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013</SOPInstanceUID>
<Diameter>9.730626493692398</Diameter>
</Elements>
</Series>
<Series>
<Origin>[-166.0,-171.6999969482422,-340.0]</Origin>
<Spacing>[0.703125,0.703125,14.34782600402832]</Spacing>
</Series>
</Data>
JSON
格式
{
"RequestId": "9889ef5b-b973-4dd0-9f26-3b9cc489c436",
"Data": {
"Series": [
{
"Report": "肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。",
"SeriesInstanceUid": "1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192"
},
{
"Elements": {
"ImageZ": 20.434030793471255,
"ImageY": 198.3552282631497,
"ImageX": 308.9676976455463,
"Lobe": "up",
"Category": 1,
"Lung": "left",
"MeanValue": 261.37589112119247,
"Volume": 10959.220491175074,
"Confidence": 0.7012705768508907,
"X": 51.24291240631416,
"Y": -32.23147700784307,
"Z": -46.81608170781766,
"SOPInstanceUID": "1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013",
"Diameter": 9.730626493692398
}
},
{
"Origin": "[-166.0,-171.6999969482422,-340.0]",
"Spacing": "[0.703125,0.703125,14.34782600402832]"
}
]
}
}
查询任务结果
该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果。
错误码
关于胸部CT肺结节检测的错误码。详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交