本文介绍主动脉瘤肺动脉高压检测AnalyzeChestVessel的语法及示例。

功能描述

主动脉瘤肺动脉高压检测可以对输入的胸部CT平扫DICOM影像数据中的主动脉及肺动脉进行分割,并分别提取其中心线,然后根据中心线生成最佳视角的Stretch CPR图像、Cross Section图像及环绕血管一周的Straightened CPR图像,同时返回每根血管的最大直径,沿中心线上每隔1毫米处垂直于血管的血管截面积及这些点在原始图像病人坐标系中的位置。

前提条件

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

输入限制

  • 图像格式:DICOM、NIFTI。
  • 如果输入格式为DICOM,每次请求帧数最少20帧最多600帧;如果输入格式为NIFTI,每次请求须有且仅有一例数据。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

系统规定参数。取值:AnalyzeChestVessel

DataFormat String NIFTI

图像格式。目前只支持DICOM和NIFTI。

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

数据来源机构代码。

OrgName String 测试组织

数据来源机构名称。

DataSourceType String HTTP_NII

输入数据的类型,支持HTTP_FILESHTTP_NII

  • HTTP_FILES为序列文件,对应DataFormat为DICOM。
  • HTTP_NII为单个文件,对应DataFormat为NIFTI。
URLList.N.URL String https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/ct_artery_aa_ph/aa/13_1.3.12.2.1107.5.1.4.67018.30000019012009435582900046382.nii.gz

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

返回数据

名称 类型 示例值 描述
RequestId String B87D013B-F25F-47DC-ABE1-440F4837AFD2

请求ID。

Data 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=AnalyzeChestVessel
&URLList=[{"URL":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/ct_artery_aa_ph/aa/13_1.3.12.2.1107.5.1.4.67018.30000019012009435582900046382.nii.gz"}]
&DataFormat=NIFTI
&OrgId=7ff51bfe-e73d-11ea-827d-506b4b3f3cf6
&OrgName=测试组织
&DataSourceType=HTTP_NII
&公共请求参数

正常返回示例

XML格式

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

<AnalyzeChestVesselResponse>
    <RequestId>B87D013B-F25F-47DC-ABE1-440F4837AFD2</RequestId>
    <Data>
        <AortaInfo>
            <MaxAreaIndex>416</MaxAreaIndex>
            <MaxArea>2722</MaxArea>
            <MaxDiameter>63</MaxDiameter>
            <LabelValue>2</LabelValue>
            <Coordinates>
                <0>19</0>
                <1>-151.3</1>
                <2>549</2>
            </Coordinates>
            <Area>428</Area>
        </AortaInfo>
        <PulmonaryInfo>
            <MaxAreaIndex>0</MaxAreaIndex>
            <MaxArea>928</MaxArea>
            <MaxDiameter>42</MaxDiameter>
            <LabelValue>1</LabelValue>
            <Coordinates>
                <0>32.6</0>
                <1>-182.9</1>
                <2>697.1</2>
            </Coordinates>
            <Area>928</Area>
            <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>
    </Data>
</AnalyzeChestVesselResponse>

JSON格式

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

{
  "RequestId" : "B87D013B-F25F-47DC-ABE1-440F4837AFD2",
  "Data" : {
    "AortaInfo" : {
      "MaxAreaIndex" : 416,
      "MaxArea" : 2722,
      "MaxDiameter" : 63,
      "LabelValue" : 2,
      "Coordinates" : [ [ 19.0, -151.3, 549.0 ] ],
      "Area" : [ 428 ]
    },
    "PulmonaryInfo" : {
      "MaxAreaIndex" : 0,
      "MaxArea" : 928,
      "MaxDiameter" : 42,
      "LabelValue" : 1,
      "Coordinates" : [ [ 32.6, -182.9, 697.1 ] ],
      "Area" : [ 928 ],
      "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接口来获取该接口的真实请求结果。详情请参见查询异步任务结果

错误码

关于主动脉瘤肺动脉高压检测的错误码。详情请参见常见错误码

SDK参考

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

安全声明

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