---
title: "visualizations"
slug: "build-visualizations"
updated: 2019-11-22T17:18:55Z
published: 2019-11-22T18:09:37Z
canonical: "code.tag.bio/build-visualizations"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://code.tag.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# visualizations

The visualization attribute of a protocol is an array of objects which contain information for how the Tag.cortex engine renders protocol results to the user.

## Overall schema

```
"visualization": [
  {
    "visualization_type": "numeric-tag", //Mandatory
    "collection": "Ccc ccc ccc", //Optional
    "descriptors": [
      {"focus-mean": "Average value of 'COLLECTION_PLACEHOLDER: VARIABLE_PLACEHOLDER' for cases in the focus cohort ARGUMENT_VALUE(argument_name) (FOCUS_COUNT_PLACEHOLDER entities)"},
      {"background-mean": "Average value of 'VARIABLE_PLACEHOLDER' for all cases (BACKGROUND_COUNT_PLACEHOLDER entities)"}
    ],
    "digits": #, //Optional
    "min": #, //Optional
    "max": # //Optional
  }
]
```