Variables Tab

In the toolbar of the Variables tab, the following groups or functions are available:

1. Delete Filters
2. Variable, Function, and Group Filters
3. Filter Configuration
4. Excel Export
5. Information Window
6. Settings for Variable Selection
7. Help for Variable Selection Dialog Box

1. Delete Filters

2. Variable, Function, and Group Filters

To filter the list of variables by variable type, the toolbar provides the following functions:

Selection Status

Filters in the Selection Status group filter the list of variables with respect to the selection status.

	All variables neither added to an experiment nor selected in the current variable list are displayed.
	All variables added to an experiment are displayed.
	All variables selected in the current variable list are displayed.

Class

Filters in the Class group filter the list of variables with respect to the class to which the variables belong.

Type

Filters in the Type group filter the list of variables with respect to the variable types.

Virtualness

Filters in the Virtualness group filter the list of variables with respect to real variables and virtual variables.

Dependence

Filters in the Dependence group filter the list of variables with respect to variables that are dependent on other variables.

Writability

Filters in the Writability group filter the list of variables with respect to the writability of variables.

Readability

Filters in the Readability group filter the list of variables with respect to the readability of variables.

Annotation Severity

Filters in the Annotation Severity group filter the list of variables with respect to variables containing notes.

Role

Filters in the Role group filter the list of variables with respect to variables that have a certain task.

3. Filter Configuration

To manage the filter configurations, the toolbar provides the following functions:

	Use this button to store defined filters in an XML file as filter configuration to be able to load it again in a different environment.
	Use this button to load a filter configuration stored in an XML file.
	Use this button to remove a filter configuration from the variable selection dialog. Note This button appears only after a filter configuration has been loaded.
	Use this button to enable or disable a loaded filter configuration. If the filter configuration is enabled, the background color of the button changes to yellow. Note This button appears only after a filter configuration has been loaded.

4. Excel Export

5. Information Window

6. Settings for Variable Selection

7. Help for Variable Selection Dialog Box

Calling the source pane from the Experiment Environment

In the Experiment Environment, all devices added to the experiment in the Hardware Configuration Editor are listed in this pane. Depending on the corresponding device functions, groups, and rasters are shown additionally if necessary.

Calling the source pane from the Calibration Data Manager (CDM)

In the CDM environment, the functions of all devices added to the experiment in the Hardware Configuration Editor are listed in this pane.

Functions, groups, and rasters will be displayed if you click on the plus symbol in front of the device.

Likewise additional LAB-Files and filter configurations will be displayed.

Open Raster Preselection

Opens the Raster Preselectiondialog box. Use this dialog box to define a uniform raster for all variables of a device. This also applies to variables not displayed in the data list due to a set filter.

Use Predefined Raster

Predefined raster are rasters which an A2L project optionally defines for a variable. If Use Predefined Raster is enabled, INCA uses the predefined rasters from the A2L file.

Use predefined raster

Allows you to precisely manage how the system handles raster assignments. If you select multiple variables, but not all of them can be mapped to the available rasters.

• If the checkbox is activated, the system only uses the predefined rasters. Any variables that do not fit within these rasters will not be assigned to alternative rasters. This could result in incomplete variable mapping.

• If the checkbox is deactivated, the system will first attempt to use the predefined rasters. If that's not possible, the system will look for alternative rasters that can accommodate all selected variables, potentially utilizing rasters that aren't predefined.

Predefined rasters are easily identifiable within the Variable Selection Dialog by their distinctive green double circle icon .

Context Menu

To open the context menu, right-click in the Sources pane.

Add LAB File

The Add LAB file function loads one or several LAB files. Functions and groups of LAB files can be used as a filter in the variable list. To activate this user option, select Experiment > Show Functions in variable list.

Remove LAB File

Removes the selected LAB files from the Source pane.

Reload LAB File

Reloads one or multiple LAB files. If you reload a LAB file that has been modified outside of INCA, e.g. in an external editor, these changes are immediately displayed and used in INCA after the reload.

Open Raster Preselection

Opens the Raster Preselection dialog box. Use this dialog box to define a uniform raster for all variables of a device. This also applies to variables not displayed in the data list due to a set filter.

Expand All

Expands all collapsed elements.

Collapse All

Collapses all expanded elements.

1. Variable Search

   With the Variable Search on the Variables tab, you can browse the list of variables for variables by entering the name of the variable or using the wildcard function. This type of search is an advantage if the exact name of the variable is unknown or if a number of variables with similar attributes are searched for.

   Note
   Searching for variables by using wildcard symbols (* for strings, ? for a single character) lists variables corresponding to the query.

2. Advanced Variable Find

   To enable the Advanced Variable Search, click on .

   With the Advanced Variable Search, you can use search criteria, such as Name, Description, Element Type etc., to search for variables.

3. Add Criteria

   With Add Criteria, you can add search criteria to the search window.

In this pane, the available variables are listed according to the sources selected and the filters used.

Following icons are indicating the selection status of the available variables in functions or groups:

	All measurement variables are already selected.
	All measurement variables are selected in this Variable Selection Dialog session.
	Some measurement variables are already selected.
	Some measurement variables are selected in this Variable Selection Dialog session.

In the Variables pane you can view meta-information on the listed variables and sort it accordingly.

To adjust the header of the Variables pane and to expand the list of variables by additional meta-information or attributes, see Configuring the Representation of Variables View.

If you have specified in the Options > Settings... menu of the Calibration Data Manager that the variables are to be sorted by functions, groups and functions are also displayed in the Variables pane.

Measurement variables can be allocated to one or more rasters. You can allocate rasters manually for single measure variables or in the predefined or preselected rasters for an entire device or a container.

The visualization of the raster options are as follows:

Context Menu

To open the context menu , right-click in the Variables pane.

This context menu contains the following functions:

Select

Selects the marked variable.

Note
You can select variables without using the context menu. Just left-click on the variable.

Select All

Selects all variables.

Deselect

Cancel the selection of a variable.

Add

Adds the selected variable(s) to the corresponding environment.

Copy Variable(s)

Copies the names of selected variables to the clipboard for further use. The copied names can be used, for example, for the purpose of documentation in any (text) editor.

About variable

Opens the About Variable dialog box.

You will see detailed information about the variable and its use.

Display variable documentation

Note
The control unit documentation is only displayed if the control unit manufacturer has provided this and if the corresponding control unit documentation has been added to the project in the database manager.

Displays the control unit documentation for the variables marked in the list.

The information window contains detailed information on the raster and the variables.

Raster details

In this field the filling level in percent of the corresponding raster is shown. As soon as the maximum filling level of the raster is reached, no further variables can be added to this raster. The permissible filling level is defined in the A2L file of the device in question.

Variable details

The variable details of the marked variables are displayed in this box. Variable details are for example:

• Name
• Variable type (e.g. measured variable, calibration, etc.)
• Device affiliation
• Type (e.g. characteristic, map, etc.)