本文介绍胸部CT平扫筛查ScreenChestCT的语法及示例。

功能描述

胸部CT平扫筛查基于常规胸部CT影像,实现了人体胸部多器官及多病种的检测及量化分析,主要功能如下:

1. 基于常规胸部CT自动测量冠状动脉的钙化积分值。

2. 自动检出肺结节,输出结节体积、平均灰度和AI结构化报告。

3. 自动分割肺叶区域肺炎病灶,输出病灶的大小和肺炎的类型等信息。

4. 检出肋骨骨折,并给出骨折的类型。

应用场景

胸部CT平扫筛查与医疗影像应用集成后,面向医院、区域医共体医联体、体检机构以及第三方影像中心等机构的影像医生、临床医生提供常规胸部CT影像检测及量化分析。

特色优势

功能丰富,首次实现通过一次CT扫描和一次上传即可完成多器官和多病种的检测和量化分析。

前提条件

请确保您已开通图像分析处理,若未开通服务请立即开通

输入限制

  • 图片格式:DICOM。
  • 图像大小:不超过3M。
  • 图像分辨率:不小于512×512像素。
  • 图像帧数:至少20帧,至多600帧。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ScreenChestCT

系统规定参数。取值:ScreenChestCT

DataFormat String DICOM

图片的格式。目前仅支持DICOM。

OrgName String weiyi

数据来源机构名称。

OrgId String 7ff51bfe-e73d-11ea-827d-506b4b3f3cf6

数据来源机构代码。

Mask Long 4

该值控制输出算法输出的种类。十进制数。

  • bit位值为1,代表启用对应的算法。
  • bit位值为0,代表禁用对应算法。

例如Mask=3,二进制为0011,即调用新冠病毒肺炎辅助诊断冠脉钙化积分测算两个算法;如果Mask=11,二进制为1011,即调用新冠病毒肺炎辅助诊断冠脉钙化积分测算肋骨骨折检测三个算法。系统仅识别二进制后四位的值,如果Mask=16,二进制为10000,后四位均为0,系统将无法识别对应算法,提示报错;如果Mask=17,二进制为10001,后四位均为0001,即调用新冠病毒肺炎辅助诊断一个算法。具体对应关系请参见下表算法启用与Mask值对应关系

URLList.N.URL String https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727647871015858256476470406.dcm

图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

算法启用与Mask值对应关系

Mask

对应二进制数

二进制中对应位置(由低到高位)

描述

1

00000001

1

二进制第一bit位为1,代表启用新冠病毒肺炎辅助诊断算法。

2

00000010

2

二进制第二bit位为1,代表启用冠脉钙化积分测算算法。

4

00000100

3

二进制第三bit位为1,代表启用胸部CT肺结节检测算法。

8

00001000

4

二进制第四bit位为1,代表启用肋骨骨折检测算法。

16

00010000

5

二进制第五bit位为1,代表启用主动脉瘤肺动脉高压检测算法。

返回数据

名称 类型 示例值 描述
RequestId String 528B54D4-3AAB-47CF-B6CE-0C2A2FB4C7C2

请求ID。

Data Object

返回的结果数据内容。

LungNodule Object

肺结节检测算法的输出结果。

Series Array of Serie

本次影像分析的分序列的结果,只支持单序列,故该jsonArray的长度为1。数组元素为单个序列的检测结果,由analysisResult和seriesInstanceUid构成。

SeriesInstanceUid String 1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192

本次分析影像的序列ID。

Elements Array of Element

结节描述。

Lobe String up

肺叶分段。取值包括:up(上叶)、middle(中叶)、down(下叶)及unknown(未知)。

MeanValue Float 261.37589112119247

平均CT值,单位为HU。

Lung String left

结节在肺叶的位置。取值包括:left(左肺)、right(右肺)及unknown(未知)。

Confidence Float 0.7012705768508907

结节分类的置信度。

SOPInstanceUID String 1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013

结节中心位置所在帧的ID标识。

Category String 1

结节分类。取值包括:

  • 0:ggo(磨玻璃影)
  • 1:part-solid(部分实性)
  • 2:solid(实性)
  • 3:unknown(未知)
Volume Float 10959.220491175074

结节体积,单位为平方毫米。

Diameter Float 9.730626493692398

结节的直径。

X Float 51.24291240631416

结节在物理坐标系中的x轴坐标值。

Y Float -32.23147700784307

结节在物理坐标系中的y轴坐标值。

Z Float -46.81608170781766

结节在物理坐标系中的z轴坐标值。

ImageX Float 308.9676976455463

结节在图像坐标系中的x轴坐标值。

ImageY Float 198.3552282631497

结节在图像坐标系中的y轴坐标值。

ImageZ Float 198.3552282631497

结节在图像坐标系中的z轴坐标值。

Origin Array of Float [-166.0,-171.6999969482422,-340.0]

图像坐标系原点在物理坐标系中的位置。

Report String 肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。

该DICOM序列经过AI分析后AI服务给出的参考报告。

Spacing Array of Float [0.703125,0.703125,14.34782600402832]

每个像素的实际距离间隔。

CACS Object

冠脉钙化积分测算算法的输出结果。

ResultUrl String http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/calc-cacs/2020-09-29/2020-09-29-11%3A07%3A41-D74FE0DF-8F80-41EB-B08B-2E67053587EC.tar.gz?Expires=1601350661&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iB16ms28Y5mzB11ghYUd7upCi4****

分割结果下载地址,有效时间5分钟。

Score String 4.83

冠脉钙化积分值。

Covid Object

新冠肺炎算法的输出结果。

NormalProbability String 0.7230905

普通肺炎的概率。

NewProbability String 4.062644e-06

新冠肺炎概率。

LesionRatio String 0.9387283236994219

白化比例。

OtherProbability String 0.27690542

其他概率。

Mask String http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****

NII格式的mask文件HTTP地址。

DetectRibFracture Object

肋骨骨折检测算法的输出结果。

ResultURL String http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/detect-rib-fracture/local_test/2020-12-22/result-D5CD101C-F8E5-43CA-9E99-44C783B8F8BE.tar.gz?Expires=1608631727&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=d6c32E1IB4b7Ayo1lpjs%2Bq3Ylv****

分割结果下载地址,有效时间5分钟。

Spacing Array of Float [1.25,0.8261719942092896,0.8261719942092896]

每个像素之间的物理距离间隔。

Origin Array of Float [-431.9739990234375,-211.5,-204.01400756835938]

像素坐标系原点在物理坐标系中的位置。

Detections Array of Detections

肋骨骨折检出结果。

FractureId Long 2

骨折处序号,从1起始。

FractureConfidence Float 0.7916666666666667

骨折分类的置信度。

FractureCategory Long 1

骨折分类结果。

  • 1:移位骨折。
  • 2:非移位骨折。
  • 3:皮质弯曲。
  • 4:陈旧骨折。
Coordinates Array of Long [75,-98,-156,98,-80,-133]

物理坐标系下骨折检测框。

CoordinateImage Array of Long [338,137,220,366,159,239]

图像坐标系下骨折检测框。

FractureLocation String L4

骨折所在肋骨编号(L1~L12,R1~R12)。L表示左侧,R表示右侧。

FractureSegment Long 0

骨折所在肋骨段。取值如下:

  • 0:前段
  • 1:腋段
  • 2:后段
ErrorMessage String Failed to execute [cacs,covid]

错误码描述。

AnalyzeChestVessel Object

肋骨骨折检测算法的输出结果。

AortaInfo Object

主动脉分析结果。

MaxAreaIndex Long 416

主动脉血管最大截面积在Area中的索引。

MaxArea Float 2722

Area中,主动脉血管截面积中的最大值。

MaxDiameter Float 63

最大截面积处的血管最大直径,单位为毫米。

LabelValue Long 2

当前血管在血管分割Mask中的Label值。AortaInfo中取值为2。

Coordinates Array

在病人坐标系下,血管中心线上从起始点到终点每隔1毫米的点对应的XYZ三维坐标序列。

Array of Float [19.0,-151.3,549.0]

在病人坐标系下,血管中心线上从起始点到终点每隔1毫米的点对应的XYZ三维坐标序列。

Area Array of Float [428]

沿血管中心线每隔1毫米处垂直于血管的血管截面积,单位为平方毫米。

PulmonaryInfo Object

肺动脉分析结果。

MaxAreaIndex Long 0

肺动脉血管最大截面积在Area中的索引。

MaxArea Float 928

Area中,肺动脉血管截面积中的最大值。

MaxDiameter Float 42

最大截面积处的血管最大直径,单位为毫米。

LabelValue Long 1

当前血管在血管分割Mask中的Label值。PulmonaryInfo中取值为1。

Coordinates Array

在病人坐标系下,血管中心线上从起始点到终点每隔1毫米的点对应的XYZ三维坐标序列。

Array of Float [32.6,-182.9,697.1]

在病人坐标系下,血管中心线上从起始点到终点每隔1毫米的点对应的XYZ三维坐标序列。

Area Array of Float [928]

沿血管中心线每隔1毫米处垂直于血管的血管截面积,单位为平方毫米。

NearestAortaArea Float 2439

主动脉中心线上最靠近肺动脉截面积最大处的点处的主动脉截面积。

ResultURL String http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/ct_artery_aa_ph/local_test/2021-07-08/6C4713DF-F548-47DF-A456-5DA1C8334444_result_compressed.tgz?Expires=1625732732&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=5UKVmLfM7GWllIcPr9a6dKz%2B5h****

CPR相关结果下载地址。

示例

请求示例

http(s)://[Endpoint]/?Action=ScreenChestCT
&DataFormat=DICOM
&OrgName=weiyi
&OrgId=7ff51bfe-e73d-11ea-827d-506b4b3f3cf6
&URLList=[{"URL":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727647871015858256476470406.dcm"}]
&Mask=4
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ScreenChestCTResponse>
    <RequestId>528B54D4-3AAB-47CF-B6CE-0C2A2FB4C7C2</RequestId>
    <Data>
        <LungNodule>
            <Series>
                <SeriesInstanceUid>1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192</SeriesInstanceUid>
                <Elements>
                    <Lobe>up</Lobe>
                    <MeanValue>261.3759</MeanValue>
                    <Lung>left</Lung>
                    <Confidence>0.7012706</Confidence>
                    <SOPInstanceUID>1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013</SOPInstanceUID>
                    <Category>1</Category>
                    <Volume>10959.221</Volume>
                    <Diameter>9.730626</Diameter>
                    <X>51.242912</X>
                    <Y>-32.231476</Y>
                    <Z>-46.816082</Z>
                    <ImageX>308.9677</ImageX>
                    <ImageY>198.35522</ImageY>
                    <ImageZ>198.35522</ImageZ>
                </Elements>
                <Report>肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。</Report>
            </Series>
        </LungNodule>
        <CACS>
            <ResultUrl>http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/calc-cacs/2020-09-29/2020-09-29-11%3A07%3A41-D74FE0DF-8F80-41EB-B08B-2E67053587EC.tar.gz?Expires=1601350661&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=iB16ms28Y5mzB11ghYUd7upCi4****</ResultUrl>
            <Score>4.83</Score>
        </CACS>
        <Covid>
            <NormalProbability>0.7230905</NormalProbability>
            <NewProbability>4.062644e-06</NewProbability>
            <LesionRatio>0.9387283236994219</LesionRatio>
            <OtherProbability>0.27690542</OtherProbability>
            <Mask>http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****</Mask>
        </Covid>
        <DetectRibFracture>
            <ResultURL>http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/detect-rib-fracture/local_test/2020-12-22/result-D5CD101C-F8E5-43CA-9E99-44C783B8F8BE.tar.gz?Expires=1608631727&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=d6c32E1IB4b7Ayo1lpjs%2Bq3Ylv****</ResultURL>
            <Detections>
                <FractureId>2</FractureId>
                <FractureConfidence>0.7916667</FractureConfidence>
                <FractureCategory>1</FractureCategory>
                <FractureLocation>L4</FractureLocation>
                <FractureSegment>0</FractureSegment>
            </Detections>
        </DetectRibFracture>
        <ErrorMessage>Failed to execute [cacs,covid]</ErrorMessage>
        <AnalyzeChestVessel>
            <AortaInfo>
                <MaxAreaIndex>416</MaxAreaIndex>
                <MaxArea>2722</MaxArea>
                <MaxDiameter>63</MaxDiameter>
                <LabelValue>2</LabelValue>
                <Coordinates/>
            </AortaInfo>
            <PulmonaryInfo>
                <MaxAreaIndex>0</MaxAreaIndex>
                <MaxArea>928</MaxArea>
                <MaxDiameter>42</MaxDiameter>
                <LabelValue>1</LabelValue>
                <Coordinates/>
                <NearestAortaArea>2439</NearestAortaArea>
            </PulmonaryInfo>
            <ResultURL>http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/ct_artery_aa_ph/local_test/2021-07-08/6C4713DF-F548-47DF-A456-5DA1C8334444_result_compressed.tgz?Expires=1625732732&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&amp;Signature=5UKVmLfM7GWllIcPr9a6dKz%2B5h****</ResultURL>
        </AnalyzeChestVessel>
    </Data>
</ScreenChestCTResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "528B54D4-3AAB-47CF-B6CE-0C2A2FB4C7C2",
  "Data" : {
    "LungNodule" : {
      "Series" : [ {
        "SeriesInstanceUid" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192",
        "Elements" : [ {
          "Lobe" : "up",
          "MeanValue" : 261.3759,
          "Lung" : "left",
          "Confidence" : 0.7012706,
          "SOPInstanceUID" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013",
          "Category" : "1",
          "Volume" : 10959.221,
          "Diameter" : 9.730626,
          "X" : 51.242912,
          "Y" : -32.231476,
          "Z" : -46.816082,
          "ImageX" : 308.9677,
          "ImageY" : 198.35522,
          "ImageZ" : 198.35522
        } ],
        "Origin" : [ ],
        "Report" : "肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。",
        "Spacing" : [ ]
      } ]
    },
    "CACS" : {
      "ResultUrl" : "http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/calc-cacs/2020-09-29/2020-09-29-11%3A07%3A41-D74FE0DF-8F80-41EB-B08B-2E67053587EC.tar.gz?Expires=1601350661&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iB16ms28Y5mzB11ghYUd7upCi4****",
      "Score" : "4.83"
    },
    "Covid" : {
      "NormalProbability" : "0.7230905",
      "NewProbability" : "4.062644e-06",
      "LesionRatio" : "0.9387283236994219",
      "OtherProbability" : "0.27690542",
      "Mask" : "http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****"
    },
    "DetectRibFracture" : {
      "ResultURL" : "http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/detect-rib-fracture/local_test/2020-12-22/result-D5CD101C-F8E5-43CA-9E99-44C783B8F8BE.tar.gz?Expires=1608631727&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=d6c32E1IB4b7Ayo1lpjs%2Bq3Ylv****",
      "Spacing" : [ ],
      "Origin" : [ ],
      "Detections" : [ {
        "FractureId" : 2,
        "FractureConfidence" : 0.7916667,
        "FractureCategory" : 1,
        "Coordinates" : [ ],
        "CoordinateImage" : [ ],
        "FractureLocation" : "L4",
        "FractureSegment" : 0
      } ]
    },
    "ErrorMessage" : "Failed to execute [cacs,covid]",
    "AnalyzeChestVessel" : {
      "AortaInfo" : {
        "MaxAreaIndex" : 416,
        "MaxArea" : 2722,
        "MaxDiameter" : 63,
        "LabelValue" : 2,
        "Coordinates" : [ [ ] ],
        "Area" : [ ]
      },
      "PulmonaryInfo" : {
        "MaxAreaIndex" : 0,
        "MaxArea" : 928,
        "MaxDiameter" : 42,
        "LabelValue" : 1,
        "Coordinates" : [ [ ] ],
        "Area" : [ ],
        "NearestAortaArea" : 2439
      },
      "ResultURL" : "http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/ct_artery_aa_ph/local_test/2021-07-08/6C4713DF-F548-47DF-A456-5DA1C8334444_result_compressed.tgz?Expires=1625732732&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=5UKVmLfM7GWllIcPr9a6dKz%2B5h****"
    }
  }
}

查询任务结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果

错误码

关于胸部CT平扫筛查的错误码。详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。