ANY-maze Help > The ANY-maze reference > The Protocol page > The elements of a protocol > Behaviour > Virtual switches > Virtual switch measures

Virtual switch 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 virtual switch:

 Number of activations 
 Time active 
 Latency to first activation 
 Latency to first deactivation 
 Distance travelled before 1st activation 
 Distance travelled while active 
 Longest activation 
 Shortest activation 
 Average activation duration 
 Frequency of activations  

  

Most measures are available for the apparatus as 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 a virtual switch has been defined for 'Moving fast', then the following sets of measures will be available:

 The measures listed above for moving fast anywhere in the apparatus. 
 The measures listed above* for moving fast in the left zone. 
 The measures listed above* for moving fast in the right zone. 

*Except for 'Average activation duration' and 'Distance travelled before 1st activation', which are only available for the apparatus as a whole.

  

  

Number of activations

DescriptionReports the number of times the virtual switch was activated (turned on).
Calculation methodCounts the number of activations.
Analysis in zonesCounts the number of times the virtual switch was activated while the animal was in the zone (or for an investigation zone, while the animal was investigating the zone). Note that if the virtual switch is active when the animal enters (or starts investigating) the zone, an activation will not be counted.
Analysis across timeThis measure can be analysed across time. For any time period, the result is the number of activations during the time period.
UnitsNone
NotesNone

  

  

Time active

DescriptionReports the total amount of time the virtual switch was active.
Calculation methodSums the duration of each activation of the virtual switch.
Analysis in zonesSums the amount of time for which the virtual switch was active when the animal was 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 active to be non-zero while the Number of activations is zero. This can occur if the animal enters the zone when the virtual switch is active. In this case, the time the virtual switch is active in the zone will be registered, but the activation itself won't be (as it didn't occur in the zone).

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

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

UnitsSeconds
NotesNone

  

  

Latency to first activation

DescriptionReports the amount of time that elapsed in the test before the virtual switch was activated for the first time.
Calculation methodThe value of the test clock at the first activation.
Analysis in zonesThe value of the test clock at the first activation that occurred when the animal was in 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 deactivation

DescriptionReports the amount of time that elapsed in the test before the virtual switch was deactivated for the first time.
Calculation methodThe value of the test clock at the first deactivation.
Analysis in zonesThe value of the test clock at the first deactivation that occurred when the animal was in 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 activation

DescriptionReports the distance the animal had travelled in the apparatus up to the moment the virtual switch was first activated.
Calculation methodThe accumulated total distance travelled is noted at the time of the first activation.
Analysis in zonesThis 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

  

  

Distance travelled while active

DescriptionReports the distance the animal travelled in the apparatus while the virtual switch was active.
Calculation methodWhile virtual switch is active, the distance travelled is accumulated.
Analysis in zonesCalculated by summing the distance the animal travelled while in the zone (or, for an investigation zone, while investigating the zone) when the virtual switch was active.
Analysis across timeThis measure can be analysed across time. For any time period, the result is the distance the animal travelled during the time period while the virtual switch was active.
UnitsThe units specified in Analysis options on the Protocol page
NotesNone

  

  

Longest activation

DescriptionReports the duration of the longest period for which the virtual switch was continuously active.
Calculation methodThe duration of each activation is calculated and the largest value is found.
Analysis in zonesThe longest period for which the virtual switch was continuously active while 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 longest period for which the virtual switch was continuously active during the period.
UnitsSeconds
NotesNone

  

  

Shortest activation

DescriptionReports the duration of the shortest period for which the virtual switch was continuously active.
Calculation methodThe duration of each activation is calculated and the smallest value is found.
Analysis in zonesThe shortest period for which the virtual switch was continuously active while 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 shortest period for which the virtual switch was continuously active during the period.
UnitsSeconds
NotesNone

  

  

Average activation duration

DescriptionReports the average duration for which the virtual switch was held active.
Calculation methodCalculated by dividing the Time active by the Number of activations.
Analysis in zonesThis measure cannot be analysed in zones.
Analysis across timeThis measure cannot be analysed across time.
UnitsSeconds
NotesNone

  

  

Frequency of activations

DescriptionReports the frequency with which the virtual switch was activated.
Calculation methodCalculated by dividing the Number of activations by the Test duration.
Analysis in zonesCalculated by dividing the Number of activations in the zone by the Total time in the zone. For an investigation zone, this will be the number of activations 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 activations which occurred during the period divided by the period's duration.
UnitsHertz
NotesNone

See also:

 Information measures 
 Apparatus measures 
 Zone measures 
 Point measures 
 Sequence measures 
 Key measures 
 On/off input measures 
 Rotary encoder measures 
 Signal measures 
 Sensor measures 
 Movement detector measures 
 On/off output measures 
 Speaker measures 
 Shocker measures 
 Pellet dispenser measures 
 Laser controller measures 
 Syringe pump measures 
 OPAD measures 
 Light controller measures 
 Procedure measures 
 Event measures 

© Copyright 2003-2026 Stoelting Co. All rights reserved

ANY-maze help topic T0385