Orthanc REST客户端

提供针对Orthanc REST API端点的REST客户端。

基于出色的apiron库。

安装

pip install orthanc-rest-client

如何使用

导入预定义客户端并传递服务器详情

from orthanc_rest_client import Orthanc
orthanc = Orthanc('http://localhost:8042')

# Patient endpoints
orthanc.get_patients()
orthanc.get_patient(id)
...and so on

# Study endpoints
orthanc.get_studies()
orthanc.get_study(id)
...and so on

# Series endpoints
orthanc.get_series()
orthanc.get_one_series(id)
...and so on

# Instance endpoints
orthanc.get_instances()
orthanc.get_instance(id)
...and so on

# Get changes
orthanc.get_changes()

# Find objects by query
query = {'Level': 'Patient',
            'Query': {'PatientName': 'Jon*'},
        }
orthanc.find(query)

# Get previous queries
orthanc.get_queries()

有许多其他预配置端点。

身份验证

传递有效的认证对象

from requests.auth import HTTPBasicAuth
auth = HTTPBasicAuth('orthanc', 'orthanc')
orthanc = Orthanc('https://test.server.com', auth=auth)

然后正常调用函数（认证对象将自动传递）。

高级示例

例如，将实例文件保存到本地目录

def save_dcm_file(instance_id):
    fileName = '.'.join([instance_id, "dcm"])
    with open(fileName, 'wb') as dcm:
        for chunk in orthanc.get_instance_file(instance_id):
            dcm.write(chunk)

从系列中获取DCM文件的压缩包

with open('test.zip', 'wb') as z:
    for chunk in orthanc.get_series_archive(<id>):
        z.write(chunk)

非HTTPS端点的安全警告

当使用HTTP端点时，REST客户端将发出警告。鉴于数据敏感性，强烈建议使用HTTPS。

您可以使用warn_insecure关键字参数禁用警告

orthanc = Orthanc('http://insecure.endpoint.com', warn_insecure=False)

更多信息

• apiron
• Orthanc文档
• Orthanc REST API