Repository files navigation

Interrogate the SNOMED CT clinical ontology using the SNOMED International Terminology Server REST API.

You can install the development version directly from GitHub with:

pip install git+https://github.com/AberystwythSystemsBiology/SCTTSRApy

We currently support the following API endpoints:

• Branching
• Code Systems
• Concepts
• Descriptions
• Relationships

Retrieve all children of363908000:

>>>fromscttsrapy.conceptsimportget_concept_children>>>get_concept_children("363908000"){"success":true,"content": [        {"conceptId":"763699005","active":true,"definitionStatus":"PRIMITIVE","moduleId":"900000000000207008","fsn": {"term":"Clinical Opiate Withdrawal Scale score (observable entity)","lang":"en"            },"pt": {"term":"Clinical Opiate Withdrawal Scale score","lang":"en"            },"isLeafInferred":true,"id":"763699005"        },        ...    ]}>>>

If you're using a custom Snowstorm instance, you can easily configure a customendpoint_builder:

>>>fromscttsrapy.apiimportEndpointBuilder>>>endpoint_builder=EndpointBuilder()>>># Setting up the custom API endpoint>>>endpoint_builder.set_api_endpoint("localhost:9000")>>># Setting up a custom header. In reality this isn't going to do anything, but you may want to lock your Snowstorm API behind a JWT.>>>endpoint_builder.set_headers(....{...."User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.95 Safari/537.36"....})>>>get_concept_children("363908000",endpoint_builder=endpoint_builder){    ...}

Please report all bugs or feature suggestions to theissues tracker. Please do not email me directly as I'm struggling to keep track of what needs to be fixed.

We welcome all sorts of contribution, so please be as candid as you want.

By default,SCTTSRApy queries the public SNOMED CT terminology endpoint hosted by SNOMED International.

This server has no service level agreement andMUST NOT be used as part of production systems in healthcare settings, even if you hold a SNOMED CT licence.

Please refer to theSnowstorm documentation for instructions on how to build a dedicated SNOMED endpoint for production.

In order to use SNOMED CT terminology, a licence is required which depends both on the country you are based in, and the purpose of your work.

SNOMED International maintains a public SNOMED CT terminology server for strict ‘reference purposes’ under theSNOMED International SNOMED CT Browser License Agreement.

Use of SNOMED CT terminology for data analysis or health care production systems is subject to other licences. Some users are eligible for free licences:

• UK-based users can obtain a licence free of charge on theNHS TRUD website.
• residents of other Member Countries and low-income countries are also eligible. More information can be found on theSNOMED International website.

This project is proudly licensed under theGNU General Public License v3.0.