# Contextualisation

Variables in ENLYZE represent time series data extracted from a data source and linked to a specific machine. To make a variable available to services interacting with the ENLYZE Manufacturing Data Platform, you must first activate it. This guide explains how to explore variables, assign metadata, and activate them.

{% hint style="info" %}
What variables, time series, and the three variable statuses (Inactive, Exploration, Active) are is explained under [Variables & time series (Concepts)](https://docs.enlyze.com/en/concepts/understanding-machine-data/variables-and-time-series).
{% endhint %}

## From Inactive to Exploration: Searching for Variables

The process of searching for variables to start exploring them, takes place in the [ENLYZE App](https://app.enlyze.com/). To choose inactive variables for exploration:

1. Navigate to [**Settings > Machines**](https://app.enlyze.com/settings/appliances)**.**

<figure><img src="https://4261006941-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNEuiyRRKwuqtIcaEt45%2Fuploads%2FBfLLkoSLvCfySb6TemFa%2Fimage.png?alt=media&#x26;token=5ef9550d-df40-444b-bb26-4e8e698ced2c" alt="" width="563"><figcaption><p>Machine Settings Page</p></figcaption></figure>

2. Open the **Selection** section for the relevant machine.
3. Use the variable table to locate and select variables.
4. Move your selected variables listed on the right section to exploration using the `Explore` button.

### Available Filters

<figure><img src="https://4261006941-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNEuiyRRKwuqtIcaEt45%2Fuploads%2FoPZ94fMcvDeH1hocavI6%2Fimage.png?alt=media&#x26;token=18b31587-feec-4b80-a444-31e71b1d7cae" alt="" width="563"><figcaption><p>Variable Selection Section</p></figcaption></figure>

* **Include/Exclude by Keyword**

  Use keywords to include or exclude variables. These filters apply to the `Origin Name`, `Display Name`, and `Comment` fields.

<figure><img src="https://4261006941-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNEuiyRRKwuqtIcaEt45%2Fuploads%2F2fJ4yedOmdT8VzJeeMkg%2Fimage.png?alt=media&#x26;token=0b06302e-4922-48b8-8f4f-592fd2ce7337" alt="" width="331"><figcaption></figcaption></figure>

* **Data Type and Status**

  Filter variables by type: *string, numerical or boolean*.

  Filter variables by status:

  * :dark\_sunglasses: Binoculars = Exploration
  * 💎 Diamond = Active

<figure><img src="https://4261006941-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNEuiyRRKwuqtIcaEt45%2Fuploads%2Fgit-blob-659659914bbf3aae69b3964cae9f96b10cf7cab1%2Fvarmapping-status-filter-01.png?alt=media" alt="" width="233"><figcaption></figcaption></figure>

* **Data Source Filter**

  Each variable lists its origin in the `Data Source Name` column. Use this filter to narrow your search to specific sources.

Once you've selected variables for exploration, they appear in the right-hand panel. Click `Explore` to change their status to Exploration.

## From Exploration to Active: Contextualizing Variables

<figure><img src="https://4261006941-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNEuiyRRKwuqtIcaEt45%2Fuploads%2FHflvFSIIHJ0R3qAEaMh2%2Fimage.png?alt=media&#x26;token=a95ba33d-607c-463f-a845-aa73d4b8c2cc" alt="" width="563"><figcaption><p>Variables in Exploration</p></figcaption></figure>

You can manage variables in exploration under:

> **`Settings > Machines > Your_Machine > Selection > Exploration`**

This view allows you to preview the variable’s values over time. Use the **Time Picker** in the top-right corner to adjust the visible time range.

{% hint style="warning" %}
**Important**\
Data collection begins only after a variable is set to **Exploration**. No values are available from before that point. You can see how long a variable has been in this status via the indicator in the top-right of each variable card.
{% endhint %}

### Activating a Variable

To activate a variable:

1. Assign a **display** **name**. This name will be the one used by external services.
2. Set a **scaling factor** (if required).
3. Configure the **unit**.

Click `Take Over` to activate the variable. It will disappear from the exploration list and move to active.

### Discarding a Variable

If you no longer wish to explore a variable, you can discard it. This removes all collected data but the variable can still be found in the selection table.

## Managing Active Variables

<figure><img src="https://4261006941-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNEuiyRRKwuqtIcaEt45%2Fuploads%2FX3g9zvZtkXF9AMDEohnH%2Fimage.png?alt=media&#x26;token=091504be-3844-43f0-90ab-79f17879d644" alt="" width="563"><figcaption><p>Overview of Active Variables</p></figcaption></figure>

Access active variables via:

> **`Settings > Machines > Your_Machine > Overview`**

You can:

* Edit variable metadata using the **Edit** button in the right-most column.
* **Deactivate** a variable, which deletes its historical data and removes it from the overview.

## Related topics

Only in German

{% embed url="<https://www.enlyze.com/stories/euromap-standards-datenblocke-tags-harmonisierten-daten>" %}

{% embed url="<https://www.enlyze.com/stories/daten-harmonisierung-visualisieren-kontextualisieren-namensschema>" %}
