Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/b2ihealthcare/snow-owl
:owl: Snow Owl Terminology Server - a production-ready, scalable, FHIR Terminology Service compliant server that supports SNOMED CT International and Extensions, LOINC, RxNorm, UMLS, ICD-10, custom code systems and many others
https://github.com/b2ihealthcare/snow-owl
codesystem conceptmap elasticsearch fhir fhir-api fhir-server healthcare icd java knowledge-graph loinc ontology owl snomed snomed-ct terminology terminology-server valueset
Last synced: 12 days ago
JSON representation
:owl: Snow Owl Terminology Server - a production-ready, scalable, FHIR Terminology Service compliant server that supports SNOMED CT International and Extensions, LOINC, RxNorm, UMLS, ICD-10, custom code systems and many others
- Host: GitHub
- URL: https://github.com/b2ihealthcare/snow-owl
- Owner: b2ihealthcare
- License: apache-2.0
- Created: 2015-01-09T11:31:14.000Z (almost 10 years ago)
- Default Branch: 9.x
- Last Pushed: 2024-10-23T20:30:14.000Z (18 days ago)
- Last Synced: 2024-10-24T11:04:03.050Z (17 days ago)
- Topics: codesystem, conceptmap, elasticsearch, fhir, fhir-api, fhir-server, healthcare, icd, java, knowledge-graph, loinc, ontology, owl, snomed, snomed-ct, terminology, terminology-server, valueset
- Language: Java
- Homepage: https://docs.b2ihealthcare.com/snow-owl/
- Size: 536 MB
- Stars: 257
- Watchers: 13
- Forks: 32
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 
Snow Owl® is a highly scalable, open source terminology server with revision-control capabilities and collaborative authoring platform features. It allows you to store, search and author high volumes of terminology artifacts quickly and efficiently.
If you’d like to see Snow Owl in action, the [Snowray Terminology Service™](https://snowray.app) provides a managed terminology server and high-quality terminology content management from your web browser.
[](https://github.com/b2ihealthcare/snow-owl/actions)
[](https://github.com/b2ihealthcare/snow-owl/releases/tag/v9.4.0)
[](https://github.com/b2ihealthcare/snow-owl/releases/)
[](https://hub.docker.com/r/b2ihealthcare/snow-owl-oss)
[](https://github.com/b2ihealthcare/snow-owl/blob/9.x/LICENSE)
[](https://codecov.io/gh/b2ihealthcare/snow-owl)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fb2ihealthcare%2Fsnow-owl?ref=badge_shield)
# Introduction
Features include:
* Revision-controlled authoring
* Maintains multiple versions (including unpublished and published) for each terminology artifact and provides APIs to access them all
* Independent work branches offer work-in-process isolation, external business workflow integration and team collaboration
* SNOMED CT and others
* SNOMED CT terminology support
* RF2 Release File Specification as of 2024-10-01
* Support for Relationships with concrete values
* Official and Custom Reference Sets
* Expression Constraint Language v2.2.0 [spec](https://confluence.ihtsdotools.org/download/attachments/33493263/doc_ExpressionConstraintLanguage_v2.2-en-US_INT_20231122.pdf?api=v2), [implementation](https://github.com/b2ihealthcare/snomed-ecl)
* Compositional Grammar 2.3.1 [spec](https://confluence.ihtsdotools.org/download/attachments/33496020/doc_CompositionalGrammar_v2.3.1-en-US_INT_20161118.pdf?api=v2), [implementation](https://github.com/b2ihealthcare/snomed-scg)
* Expression Template Language 1.0.0 [spec](https://confluence.ihtsdotools.org/download/attachments/45529301/doc_TemplateSyntax_v1.0-en-US_INT_20170726.pdf?api=v2), [implementation](https://github.com/b2ihealthcare/snomed-etl)
* LOINC, ICD-10 (+ modifications) and Custom CodeSystems are available when licensed
* With its modular design, the server can maintain multiple terminologies (including local codes, mapping sets, value sets)
* Various sets of APIs
* FHIR Terminology Service API supporting R4/R4B/R5 formats [spec](https://hl7.org/fhir/R4/index.html)
* RESTful and native Java APIs for advanced use cases
* CIS API 1.0 [see reference implementation](https://github.com/IHTSDO/component-identifier-service)
* Highly extensible and configurable
* Simple to use plug-in system makes it easy to develop and add new terminology tooling/API or any other functionality
* Built on top of [Elasticsearch](https://www.elastic.co/elasticsearch) (highly scalable, distributed, open source search engine)
* Connect to your existing cluster or use the embedded instance (supports up to Elasticsearch 8.x)
* All the power of Elasticsearch is available (full-text search features, monitoring, machine-learning, analytics and many more)
# Download
* [WINDOWS](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-oss.zip) - [sha](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-oss.zip.sha1)
* [LINUX](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-oss.tar.gz) - [sha](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-oss.tar.gz.sha1)
* [RPM](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-rpm.rpm) - [sha](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-rpm.rpm.sha1)
* [DEB](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-deb.deb) - [sha](https://artifacts.b2ihealthcare.com/repository/maven-releases/com/b2international/snowowl/com.b2international.snowowl.server.update/9.4.0/com.b2international.snowowl.server.update-9.4.0-deb.deb.sha1)
{% hint style="info" %}
This distribution only includes features licensed under the Apache 2.0 license. To get access to the full set of features, please contact [B2i Healthcare](mailto:[email protected]).
{% endhint %}
View the detailed release notes [here](https://github.com/b2ihealthcare/snow-owl/releases/tag/v9.4.0).
Not the version you're looking for? View [past releases](https://github.com/b2ihealthcare/snow-owl/releases).
### Install and Run
NOTE: You need to have at least version 17 of the JDK installed for local builds and running the development environment. Official releases include the runtime.
Once you have downloaded the appropriate package:
* Run `bin/snowowl.sh` on unix, or `bin/snowowl.bat` on windows
* Run `curl http://localhost:8080/snowowl/info` to access server health status information
* Run `curl http://localhost:8080/snowowl/fhir/metadata` to access FHIR terminology capabilities
* Navigate to `http://localhost:8080/snowowl` to access the REST API documentation page
* Find more information about Snow Owl here in the [official docs](https://docs.b2ihealthcare.com/snow-owl)
# Building from source
Snow Owl uses Maven for its build system. In order to create a distribution, simply run the following command in the cloned directory.
./mvnw clean package
The distribution packages can be found in the `releng/com.b2international.snowowl.server.update/target` folder, when the build is complete.
To run the test cases, use the following command:
./mvnw clean verify
# Development
These instructions will get Snow Owl up and running on your local machine for development and testing purposes.
## Prerequisites
Snow Owl is an Equinox-OSGi based server. To develop plug-ins for Snow Owl you need to use Eclipse as IDE:
* Download Eclipse IDE for Eclipse Committers 2023-12 package from here: https://www.eclipse.org/downloads/packages/release/2023-12/r/eclipse-ide-eclipse-committers
Required Eclipse plug-ins in order (install the listed features via `Help` → `Install New Software...`):
*Note: you may have to untick the `Show only the latest versions of the available software` checkbox to get older versions of a feature. Please use the exact version specified below, not the latest point release.*
* Groovy Development Tools (https://groovy.jfrog.io/ui/native/plugins-release/e4.30 or https://groovy.jfrog.io/artifactory/plugins-release-local/org/codehaus/groovy/groovy-eclipse-integration/5.2.0/e4.30)
* Eclipse Groovy Development Tools - 5.2.0 (in category "Main Package")
* MWE2 (https://download.eclipse.org/modeling/emft/mwe/updates/releases/2.16.0/)
* MWE SDK 1.10.0 (MWE)
* Xtext/Xtend (https://download.eclipse.org/modeling/tmf/xtext/updates/releases/2.33.0/)
* Xtend IDE 2.33.0 (Xtext)
* Xtext Complete SDK 2.33.0 (Xtext)
### Eclipse Preferences
Make sure you have the following preferences enabled/disabled.
* Plug-in development API baseline errors is set to Ignored (Preferences > Plug-in Development > API Baselines)
* The *Plugin execution not covered by lifecycle configuration: org.apache.maven.plugins:maven-clean-plugin:2.5:clean* type of errors can be ignored or changed to *Warnings* in *Preferences→Maven→Errors/Warnings*.
* Set the workspace encoding to *UTF-8* (Preferences→General→Workspace)
* Set the line endings to *Unix* style (Preferences→General→Workspace)
* Set the number of imports and static imports wildcard limit to *5* (Preferences→Java→Code Style→Organize Imports)
### Git configuration
* Make sure the Git line endings are set to *input* (Preferences→Team→Git→Configuration - add key if missing *core.autocrlf = input*)
### Maven Settings
* Make sure the `settings.xml` in your ~/.m2/settings.xml location is updated with the content from the `settings.xml` from this repository's root folder.
## First steps
1. Import all projects into your Eclipse workspace and wait for the build to complete
2. Select all projects and hit `Alt` + `F5` and trigger an update to all Maven projects manually (to download dependencies from Maven)
3. Open the `target-platform/target-platform.target` file
4. Wait until Eclipse resolves the target platform (click on the `Resolve` button if it refuses to do so) and then click on `Set as Active Target platform`
5. Wait until the build is complete and you have no compile errors
6. Launch `snow-owl-oss` launch configuration in the Run Configurations menu
7. Navigate to `http://localhost:8080/snowowl`
# Contributing
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
# Versioning
Our [releases](https://github.com/b2ihealthcare/snow-owl/releases) use [semantic versioning](http://semver.org). You can find a chronologically ordered list of notable changes in [CHANGELOG.md](CHANGELOG.md).
# License
This project is licensed under the Apache 2.0 License. See [LICENSE](LICENSE) for details and refer to [NOTICE](NOTICE) for additional licensing notes and uses of third-party components.
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fb2ihealthcare%2Fsnow-owl?ref=badge_large)
# Acknowledgements
In March 2015, [SNOMED International](http://snomed.org) generously licensed the Snow Owl Terminology Server components supporting SNOMED CT. They subsequently made the licensed code available to their [members](https://www.snomed.org/our-stakeholders/members) and the global community under an open-source license.
In March 2017, [NHS Digital](https://digital.nhs.uk) licensed the Snow Owl Terminology Server to support the mandatory adoption of SNOMED CT throughout all care settings in the United Kingdom by April 2020. In addition to driving the UK’s clinical terminology efforts by providing a platform to author national clinical codes, Snow Owl will support the maintenance and improvement of the dm+d drug extension which alone is used in over 156 million electronic prescriptions per month. Improvements to the terminology server made under this agreement will be made available to the global community.
Many other organizations have directly and indirectly contributed to Snow Owl, including: Singapore Ministry of Health; American Dental Association; University of Nebraska Medical Center (USA); Federal Public Service of Public Health (Belgium); Danish Health Data Authority; Health and Welfare Information Systems Centre (Estonia); Department of Health (Ireland); New Zealand Ministry of Health; Norwegian Directorate of eHealth; Integrated Health Information Systems (Singapore); National Board of Health and Welfare (Sweden); eHealth Suisse (Switzerland); and the National Library of Medicine (USA).