# Measure Templex Expressions

## Evaluating Expressions

- Tcl Console
- HyperView Notes
- TextView

## Non-Grouped Measures Expression Type

The expression below will return the default x vector for the measure item specified by`item_index`

.`"p" <page_id> "w" <window_id> "measure" <measure_id> . item_index . x_option . y_option . "x"`

For example, `p1w1measure3.7.0.3.x`

will return the x vector (time in
this case) for item 7 in measure group 3.

Where:

Page ID = 1

Window ID = 1

Measure ID = 3

Item Index = 7

X Option = 0 (Default)

Y Option = 3 (Magnitude for a Distance Between measure, for example)

In addition, the expression
below will return the y vector specified by `y_option`

for the measure item
specified by `item_index`

.

`"p" <page_id> "w" <window_id> "measure" <measure_id> . item_index . x_option . y_option . "y"`

For example, `p1w1measure3.7.0.3.y `

will return the magnitude values for
item 7 in measure group 3, across all time steps.

Where:

Page ID = 1

Window ID = 1

Measure ID = 3

Item Index = 7

X Option = 0 (Default)

Y Option = 3 (Magnitude for a Distance Between measure, for example)

` x_option`

must always be zero.## Grouped Measures Expression Type

The expression below will return the x vector specified by`x_option`

for all of the items in
a measure group.`"p" <page_id> "w" <window_id> "measure" <measure_id> . "all" . x_option . y_option . "x"`

For example, `p1w1measure3.all.2.3.x`

will return the Y coordinate
values of all items in measure group 3, at a particular time step.

Where:

Page ID = 1

Window ID = 1

Measure ID = 3

X Option = 2 (Y Coordinate)

Y Option = 3 (Magnitude)

In addition, the expression below will return the y vector
specified by `y_option`

for all of the items in a measure group.

`"p" <page_id> "w" <window_id> "measure" <measure_id> . "all" . x_option . y_option . "y"`

For example, `p1w1measure3.all.2.3.y`

will return the magnitude values
of all items in measure group 3, at a particular time step.

Where:

Page ID = 1

Window ID = 1

Measure ID = 3

X Option = 2 (Y Coordinate)

Y Option = 3 (Magnitude)

## Measure Values at a Particular Time Step

The expression below will return all values for measure item specified by
`item_idx`

, at a particular timestep.

`"p" <page_id> "w" <window_id> "measure" <measure_id> . item_idx . "vals"`

For example, `p1w1measure3.2.vals`

will return all values (for example: X,
Y, Z and Magnitude for a Distance Between measure or X, Y, Z for Position measures) for
measure item 2 in measure group 3.

Where:

Page ID = 1

Window ID = 1

Measure ID = 3

Item Index = 2

## Min Values

The expression below will return the least value (minimum) across all time steps and measure items, for the given x and y options.`"p" <page_id> "w" <window_id> "measure" <measure_id> . x_option_idx . y_option_idx . "min"`

## Max Values

The expression below will return the greatest value (maximum) across all time steps and measure items, for the given x and y options.`"p" <page_id> "w" <window_id> "measure" <measure_id> . x_option_idx . y_option_idx . "max"`

## Extreme Values

The expression below will return the greatest absolute value (extreme) across all time steps and measure items, for the given x and y options.`"p" <page_id> "w" <window_id> "measure" <measure_id> . x_option_idx . y_option_idx . "extreme"`

For example, `p1w1measure3.0.3.min`

will return the least value of
magnitude across all measure items and time steps, the time/frequency at which this value is
attained, and the time step/frame at which this value is attained. Similarly max will return
the largest value, and extreme will return the largest absolute
value.

Where:

Page ID = 1

Window ID = 1

Measure Group = 3

X Option = 0

Y Option = 3

## Measure Group IDs

The following expression can be used to return all of the IDs in the measure group
specified by `measure_id`

:

`"p" <page_id> "w" <window_id> "measure" <measure_id> . "ids"`

For example, `p1w1measure3.ids`

would be used to return the IDs of all
measure items in measure group 3.

Where:

Page ID = 1

Window ID = 1

Measure Group = 3

## Measure Group Label

The following expression can be used to return the label for the measure group specified by`measure_id`

:`"p" <page_id> "w" <window_id> "measure" <measure_id> . "label"`

For example, `p1w1measure3.label`

would be used to return the label for
measure group 3.

Where:

Page ID = 1

Window ID = 1

Measure Group = 3

## Measure Options

The tables below contain the expressions for the measure options currently available in HyperView:

Val | X Option | Y Option |
---|---|---|

0 | Default (time, frequency) | X Coordinate |

1 | X Coordinate | Y Coordinate |

2 | Y Coordinate | Z Coordinate |

3 | Z Coordinate | Magnitude |

4 | Entity ID | - |

5 | Distance | - |

Val | X Option | Y Option |
---|---|---|

0 | Default (time, frequency) | X Coordinate |

1 | X Coordinate | Y Coordinate |

2 | Y Coordinate | Z Coordinate |

3 | Z Coordinate | - |

4 | Entity ID | - |

5 | Distance | - |

Val | X Option | Y Option |
---|---|---|

0 | Default (time, frequency) | X Projection |

1 | X Coordinate | Y Projection |

2 | Y Coordinate | Z Projection |

3 | Z Coordinate | True Angle |

4 | Entity ID | - |

5 | Distance | - |

Val | X Option | Y Option |
---|---|---|

0 | Default (time, frequency) | Yaw |

1 | X Coordinate | Pitch |

2 | Y Coordinate | Roll |

3 | Z Coordinate | - |

4 | Entity ID | - |

5 | Distance | - |

Val | X Option | Y Option |
---|---|---|

0 | Default (time, frequency) | Value in the case of a single layer plot. Bottom value in the case of a top/bottom plot. |

1 | X Coordinate | Top value in the case of a top/bottom plot. |

1mn(101, 102, etc.) | - | Value in the case of a single layer plot. Bottom corner value in the case of a top/bottom plot, where mn is the corner node index number. |

2 | Y Coordinate | - |

2mn(101, 102, etc.) | - | Top corner value in the case of a top/bottom plot, where mn is the corner node index number. |

3 | Z Coordinate | - |

4 | Entity ID | - |

5 | Distance | - |

## Notes

Any invalid expression will return “N/A”.