cql-exec-examples

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

cql-exec-examples

★ 8 Open GitHub ↗

Examples demonstrating the CoffeeScript CQL Execution project

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CQL Execution Examples

This repository is intended to include examples showing how to use the
[cql-execution](https://github.com/cqframework/cql-execution)
library.  Currently, there are two examples, demonstrating how to use `cql-execution` with the
[cql-exec-fhir](https://github.com/cqframework/cql-exec-fhir) data source and
[cql-exec-vsac](https://github.com/cqframework/cql-exec-vsac) code service.

The `cql-exec-vsac` code service requires a valid UMLS account to download value sets.  If you do not have an UMLS
account, you can request one here: https://uts.nlm.nih.gov/license.html

NOTE: These are simplified examples, designed only for the purpose of demonstrating how to use the cql-execution and
its corresponding modules.  These examples are NOT clinically validated and should NOT be used in a clinical setting.

# Setting Up the Environment

To use this project, you should perform the following steps:

1. Install [Node.js](https://nodejs.org/en/download/)
2. Install [Yarn](https://yarnpkg.com/en/docs/install)
3. Execute the following from this project's root directory: `yarn`

# Running the Examples

The first time you run each example, you need to download the referenced value sets from the Value Set Authority Center
(VSAC).  This requires your UMLS API Key.  Your API Key may be found in your [UMLS Profile](https://uts.nlm.nih.gov//uts.html#profile).

To run the examples while passing your UMLS API Key via the command line:

```bash
$ node index.js myUmlsApiKey
```

NOTE: You can also set the credentials by setting an `UMLS_API_KEY` environment variable instead
of passing the credentials on the command line.

After running once with your credentials, the downloaded value set definitions are cached.  After that, you should be
able to run the same example without credentials:

```bash
$ node index.js
```

# Updating the Example CQL and ELM

The CQL execution framework uses the ELM JSON representations of the CQL logic.  After updating the example CQL in
this project, you will need to translate it to ELM JSON for execution to pick up the changes. The CQL-to-ELM
translator requires that [Java](https://adoptopenjdk.net/) be installed. This has been tested using OpenJDK 11, but
later versions may also work (your mileage my vary).

Once Java has been installed, run the CQL-to-ELM translation via the following command:

```bash
$ ./gradlew cql2elm
```

_NOTE: You may see CQL-to-ELM errors trying to compile CQL from dependency libraries in node_modules. You can
safely ignore these errors._

# Linting the Code

To encourage quality and consistency within the code base, all code should pass eslint without any warnings.  Many text
editors can be configured to automatically flag eslint violations.  We also provide an npm script for running eslint on
the project.  To run eslint, execute the following command:

```
$ yarn lint
```

cql-exec-examples

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README