ANY-maze Help > The ANY-maze reference > The Protocol page > The elements of a protocol > Behaviour > Keys > Key measures

Key measures

ANY-maze has been designed to be extended, and we'll be delighted to add any new measures you might find useful, for free! Just contact ANY-maze Support.

ANY-maze will score the following measures for a key:

 Number of presses 
 Time pressed 
 Latency to first press 
 Latency to first release 
 Distance travelled before 1st press 
 Longest press 
 Shortest press 
 Average press duration 
 Press frequency 
 List of activation durations  

  

Each measure is available for the apparatus as a whole (i.e. irrespective of where the behaviour occurred) and also for each defined zone. For example, if a protocol includes two zones called 'Left' and 'Right' and two keys have been defined, one for 'Grooming' and one for 'Rearing' then the following sets of measures will be available:

 All the measures listed above for grooming anywhere in the apparatus 
 All the measures listed above for rearing anywhere in the apparatus 
 All the measures listed above for grooming in the left zone 
 All the measures listed above for rearing in the left zone 
 All the measures listed above for grooming in the right zone 
 All the measures listed above for rearing in the right zone  

  

  

Number of presses

DescriptionReports the number of times the key was pressed down, i.e. the number of times the animal started to exhibit the key's behaviour.
Calculation methodCounts the number of key presses.
Analysis in zonesCounts the number of times the key was pressed when the animal was in the zone (or for an investigation zone, while the animal was investigating the zone).
Analysis across timeThis measure can be analysed across time. For any time period, the result is the number of times the key was pressed down during the time period.
UnitsNone
NotesNone

  

  

Time pressed

DescriptionReports the total amount of time the key was pressed down, i.e. the total amount of time that the animal was exhibiting the key's behaviour.
Calculation methodSums the amount of time for which the key was pressed.
Analysis in zonesSums the amount of time for which the key was pressed in the zone (or for an investigation zone, while the animal was investigating the zone).

For a particular zone, it's possible for the Time pressed to be non-zero while the Number of presses is zero. This can occur if the animal enters the zone when the key is pressed. In this case, the time the key is pressed will be registered but the key press itself won't be.

Analysis across timeThis measure can be analysed across time. For any time period, the result is the amount of time that the key was pressed during the period.

For a particular time period, it's possible for the Time pressed during the period to be non-zero while the Number of presses for the period is zero. This can occur if the key is already pressed at the start of the period. In this case, the time the key is pressed will be registered but the key press itself won't be.

UnitsSeconds
NotesNone

  

  

Latency to first press

DescriptionReports the amount of time that elapsed in the test before the key was pressed for the first time, i.e. the amount of time that elapsed before the key's behaviour started for the first time.
Calculation methodThe value of the test clock at the first key press.
Analysis in zonesThe value of the test clock at the first key press that occurred within the zone (or for an investigation zone, while the animal was investigating the zone).
Analysis across timeThis measure cannot be analysed across time.
UnitsSeconds
NotesNone

  

  

Latency to first release

DescriptionReports the amount of time that elapsed in the test before the key was released for the first time, i.e. the amount of time that elapsed before the key's behaviour ended for the first time.
Calculation methodThe value of the test clock at the first key release.
Analysis in zonesThe value of the test clock at the first key release that occurred within the zone (or for an investigation zone, while the animal was investigating the zone).
Analysis across timeThis measure cannot be analysed across time.
UnitsSeconds
NotesNone

  

  

Distance travelled before 1st press

DescriptionReports the distance the animal had travelled in the apparatus up to the moment the key was first pressed.
Calculation methodThe accumulated total distance travelled is noted at the time of the first key press.
Analysis in zonesThe measure cannot be analysed in zones.
Analysis across timeThis measure cannot be analysed across time.
UnitsThe units specified in Analysis options on the Protocol page
NotesNone

  

  

Longest press

DescriptionReports the duration of the longest period for which the key was continuously pressed down, i.e. the longest period for which the animal continuously exhibited the key's behaviour.
Calculation methodThe duration of each key press is calculated and the largest value is found.
Analysis in zonesThe longest period for which the key was continuously pressed in the zone (or for an investigation zone, while the animal was investigating the zone).
Analysis across timeThis measure can be analysed across time. For any time period, the result is the longest period for which the key was continuously pressed during the period.
UnitsSeconds
NotesNone

  

  

Shortest press

DescriptionReports the duration of the shortest period for which the key was continuously pressed down, i.e. the shortest period for which the animal continuously exhibited the key's behaviour.
Calculation methodThe duration of each key press is calculated and the smallest value is found.
Analysis in zonesThe shortest period for which the key was continuously pressed in the zone (or for an investigation zone, while the animal was investigating the zone).
Analysis across timeThis measure can be analysed across time. For any time period, the result is the shortest period for which the key was continuously pressed during the period.
UnitsSeconds
NotesNone

  

  

Average press duration

DescriptionReports the average duration for which the key was held down, i.e. the average duration of the episodes of the key's behaviour.
Calculation methodCalculated by dividing the Time pressed by the Number of presses.
Analysis in zonesThis measure cannot be analysed in zones.
Analysis across timeThis measure cannot be analysed across time.
UnitsSeconds
NotesNone

  

  

Press frequency

DescriptionReports the frequency with which the key was pressed, i.e. the frequency with which the animal exhibited the key's behaviour.
Calculation methodCalculated by dividing the Number of presses by the Test duration.
Analysis in zonesCalculated by dividing the Number of presses in the zone by the Total time in the zone. For an investigation zone, this will be the number of presses while the animal was investigating the zone divided by the total time investigating the zone.
Analysis across timeThis measure can be analysed across time. For any time period, the result is the Number of presses which occurred during the period divided by the period's duration.
UnitsHertz
NotesNone

  

  

List of activation durations

DescriptionReports a comma-separated list of the duration of each activation of the key. For example, if key was activated three times, for 10s on the first occasion and for 20s on the second and third, then the list would show '10.0, 20.0, 20.0'.
Calculation methodThe duration of each activation is calculated and added to the list. If the key is active at the end of the test, then the last duration in the list will be from the time the key was activated to the time of the test end.
Analysis in zonesThe measure cannot be analysed in zones.
Analysis across timeThis measure cannot be analysed across time.
UnitsAll the durations in the list are reported in seconds.
NotesWhen included on the Data page, this measure will show all the activation durations in a single cell. If the spreadsheet is saved in CSV format and then opened in (for example) Microsoft Excel, then the durations will be listed in individual cells.

The length of the list is limited to 8192 characters, but usually at last 1,000 activations will be listed before the limit is reached.

See also:

 Information measures 
 Apparatus measures 
 Zone measures 
 Point measures 
 Sequence measures 
 On/off input measures 
 Signal measures 
 Sensor measures 
 Rotary encoder measures 
 Movement detector measures 
 On/off output measures 
 Syringe pump measures 
 Laser controller measures 
 OPAD measures 
 Procedure measures 
 Event measures 
 Virtual switch measures 

© Copyright 2003-2026 Stoelting Co. All rights reserved

ANY-maze help topic T0372