What is a Lens?

A Zus Lens is a set of FHIR resources derived from a patient’s raw resources that have been structurally normalized, de-duplicated, summarized, and tagged. Alongside Zus Data Enrichment, a Lens helps to extract signal quickly from raw data.

Deduplication: Clinical data are aligned based on their appropriate Zus-enriched codings and a single resource is written per unique data type based on the patient’s history.

Structural Normalization: Zus helps reduce noisy data by normalizing clinical data into single FHIR resources representing unique data or events.

Summarization: Zus summarizes the history for each data type in a single resource, so you have one source for answering questions such as: “what was the last activity for this medication?” or “what is the current status?”

Additionally, you may just want to present what is currently applicable and active for the patient today. Lenses help with both of these scenarios and you can access them simply by specifying the related tag of the Lens you want (see below).

Lens resources are created after Zus enriches newly created resources and are rewritten every time a new relevant resource is created with no work or intervention needed by you.

How Are Lenses Represented?

Zus-Derived Lens Resources

Lens resources are aggregated, summarized versions of Builder-generated and third party resources in the Zus Aggregated Profile (ZAP). You can identify a Lens resource by the presence of a “Lens Tag,” which is a meta tag generated by Zus.

Lens Tag example:

"meta": {
    "tag": [
        {
            "system": "https://zusapi.com/lens",
            "code": "ActiveMedications"
        }
    ]
}

❗

Lens Permissions

Builder users and app clients are NOT permitted to create, modify, or delete Lens resources. Any attempt to do so will result in a 403 error.