Hl7.Cql.Elm
1.0.0-rc1
See the version list below for details.
dotnet add package Hl7.Cql.Elm --version 1.0.0-rc1
NuGet\Install-Package Hl7.Cql.Elm -Version 1.0.0-rc1
<PackageReference Include="Hl7.Cql.Elm" Version="1.0.0-rc1" />
paket add Hl7.Cql.Elm --version 1.0.0-rc1
#r "nuget: Hl7.Cql.Elm, 1.0.0-rc1"
// Install Hl7.Cql.Elm as a Cake Addin #addin nuget:?package=Hl7.Cql.Elm&version=1.0.0-rc1&prerelease // Install Hl7.Cql.Elm as a Cake Tool #tool nuget:?package=Hl7.Cql.Elm&version=1.0.0-rc1&prerelease
Introduction
This is NCQA's and Firely's official support SDK for working with CQL on the Microsoft .NET (dotnet) platform. It contains an engine for executing ELM, and/or turning the contents of an ELM file into a .NET assembly so it can be called statically.
Release notes
This is release version 1.0 (release candidate) of the engine. The engine has been tested by running it against the current NCQA HEDIS measures. There is quite some variation in how CQL is written and interpreted, so it is likely at this early stage that there will be deviations from other engines currently available. As well, we expect parts of the public interface can to change.
The releases notes at firely-cql-sdk/releases for each major version will document these changes and (major) issues we have encountered.
Getting Started
- Read how to get started with the Demo solution included in the repository.
- There is a great presentation on the engine from DevDays 2023.
- The CQL section in the .NET SDK documentation
- A word document with background documentation on the design. May be somewhat outdated.
- A graphic showing the main (internal) parts of the engine. May be somewhat outdated.
The presentation is a good place to start, but note that we have made some minor changes to the public surface, so the names of the classes in the presentation will differ from the examples in the Demo project itself.
Dev Start
During development, new alpha releases will appear on Firely's Github Package feed, to be able to use pre-release packages within the cql solution. To use theses packages you must add https://nuget.pkg.github.com/FirelyTeam/index.json
to your NuGet sources:
Get a Personal Access token (PAT) from github.com with scope
read:packages
Next open a console on your machine and run
dotnet nuget add source --name github --username <USERNAME> --password <PAT> https://nuget.pkg.github.com/FirelyTeam/index.json
USERNAME
: your username on GitHub
PAT
: your Personal access token with at least the scope read:packages
Support
We actively monitor the issues coming in through the GitHub repository at https://github.com/FirelyTeam/firely-cql-sdk/issues. You are welcome to register your bugs and feature suggestions there. For questions and broader discussions, we use the .NET FHIR Implementers chat and CQL chat on Zulip.
Contributing
We are welcoming contributions!
If you want to participate in this project, we're using Git Flow for our branch management. Please submit PRs with changes against the develop
branch.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- Hl7.Cql.Graph (>= 1.0.0-rc1)
- Microsoft.CodeAnalysis.CSharp (>= 4.7.0)
- Newtonsoft.Json (>= 13.0.3)
- System.Collections.Concurrent (>= 4.3.0)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on Hl7.Cql.Elm:
Package | Downloads |
---|---|
Hl7.Cql.Compiler
Support package for Hl7.Cql. Translates ELM into C# expression trees and can emit those expression trees into either runtime Delegates or C# source code. |
|
Hl7.Cql
A platform for evaluating logic in the HL7 CQL language. |
|
Hl7.Cql.CqlToElm
Support package for Hl7.Cql. Unit conversion for CQL. Contains functionality to convert CQL to ELM. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.0.7-alpha | 129 | 11/19/2024 |
2.0.4-alpha | 943 | 9/20/2024 |
2.0.3-alpha | 327 | 9/4/2024 |
2.0.2-alpha | 53 | 9/4/2024 |
2.0.1-alpha | 211 | 8/21/2024 |
2.0.0-alpha | 522 | 6/17/2024 |
1.0.0-rc3 | 487 | 7/10/2024 |
1.0.0-rc2 | 1,874 | 10/23/2023 |
1.0.0-rc1 | 3,460 | 9/7/2023 |
0.9.0-rc1 | 94 | 8/30/2023 |