![](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEialB48k_2CNhzPZdF5TL87spXsZVFBUz2eFXbh8nHdfx525R3lQjJjV_8LkVKkZQ4c8NfKEYthQWTeZm8rPPnGeCGW3ohkiCwxS7VNqvONHx6oAkXKpxVXakWuMrTW-zDyq_ixBLSgCOfEKghVi91ek4akYQGl4Wp6MPi9vUSPperCX2NhAWRFOVBpfFo/s1600/Header%20-%20OSS%20-%20EZ%20WSI%20DICOMWeb%20library.png)
Today, many institutions are building custom solutions for understanding their medical data, as well as tools for acting on that data. A major pain point with the current approach is that these tools can be error prone, lack built in medical context and medical data structure representations. Enter Clinical Quality Language (CQL), a portable, computable, and open HL7 language specification for expressing computable clinical logic over healthcare data. We believe that CQL has the power to radically improve the future of data driven workflows in healthcare. Over the past year at Google Health, our team has been hard at work building foundational tools for healthcare data analytics. Today we’re announcing the release of an experimental open source toolkit for Clinical Quality Language execution.
The Google CQL engine is an experimental open source toolkit that includes a CQL execution engine built from scratch in Go. We built this engine with a focus on horizontal scalability in mind, ease of use, and high test coverage. We wanted to make it easy to experiment with our engine, so we’ve included an easy to use CLI, REPL, and a two-click setup web playground! The toolkit is still a work in progress and we very much welcome input, contributions, and ideas from the community.
Why CQL
CQL represents a major shift away from the precedent of distributing clinical logic as free text guidelines which each institution implements in custom and often error prone ways. Now, CQL allows clinical logic to be written once, distributed, and run anywhere in a single framework. Major standards bodies like Medicare, NCQA, and the World Health Organization (WHO) have already started to adopt and distribute clinical measures in CQL! (Check out these antenatal care measures from the WHO as an example). We believe that CQL lowers the burden to writing, sharing, and computing complex clinical content.
CQL supports multiple common healthcare data models (such as FHIR and QDM) and is designed with common clinical concepts, tasks, and nested data structures in mind. For example, consider this comparison:
![]() |
(click to enlarge) A side by side comparison of FHIR SQL (BigQuery) to CQL. This logic extracts CHD encounters with statins prescribed during the visit. |
The FHIR SQL requires more boilerplate, unnesting, and custom value set handling. It’s very clear here that the CQL is more readable, concise, and easier to understand than the SQL implementation for this example.
If you’d like to see a more in depth CQL example with an explanation, see Appendix A.
As the healthcare industry has matured so have the representations of Clinical Quality Measures. Previously, clinical quality mandates were provided as free-text guidelines. That left it up to each medical institution to implement themselves. This was of course error prone, and repetitive across the industry. There is a shift today where institutions like the WHO, CMS, and NCQA are writing clinical measures increasingly in CQL.
Examples like the WHO Antenatal Care Guidelines project exemplify the shift to openly distributed and executable measures. We believe that computable and shareable measures like these WHO SMART Guidelines are the future for expressing and sharing medical knowledge.
Our CQL Toolkit
We would love others excited about this work to check out our experimental CQL tools at https://github.com/google/cql. We continue to be very interested in welcoming external contributors, so we strongly encourage you to check out the repository to give it a try and consider helping with any open issues. If you’re not sure where to ask, reach out to us! We’d also like to hear from others about what they’re working on and how the Google CQL engine may fit into their toolchain, feel free to reach out at evango@google.com or open an issue on the repository.
If you want to learn more about CQL see https://github.com/cqframework/clinical_quality_language and https://cql.hl7.org/index.html.
Appendix A: Simplified Diabetes CQL Example
library ExampleCQLLibrary version '1.2.3'
using FHIR version '4.0.1'
valueset Diabetes: 'diabetes-valuseset-url' version '1.0'
valueset GlucoseLevels: 'glucose-levels-valueset-url' version '1.0'
context Patient
define PatientMeetsAgeRequirement: AgeInYearsAt(Now()) < 20
define HasDiabetes:
exists ([Condition: Diabetes] chd where chd.onset before Now())
define LatestGlucoseReading:
Last([Observation: GlucoseLevels] bp sort by effective desc)
define LatestGlucoseAbove200: LatestGlucoseReading.value > 200
define Denominator: PatientMeetsAgeRequirement and HasDiabetes
define Numerator: Denominator and LatestGlucoseAbove200
In this example for a given patient record, the code selects for individuals under 20 where their most recent glucose reading was above 200. Although this is a simple example, it’s made simple because CQL provides a solid foundation for which to define and act on medical information and concepts.