ANY-maze Help > The ANY-maze reference > The Protocol page > The elements of a protocol > Behaviour > Points > Point measures

Point 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 point:

 Average distance from the point 
 Maximum distance from the point 
 Minimum distance from the point 
 Average distance of the animal's head from the point 
 Maximum distance of the animal's head from the point 
 Minimum distance of the animal's head from the point  

Movement relative to point measures

 Time moving towards the point 
 Time moving away from the point 
 Time the animal's head was moving towards the point 
 Time the animal's head was moving away from the point 
 Average speed moving towards the point  

Heading/orientation measures

 Initial heading error to the point 
 Average absolute heading error to the point 
 Time the animal's head was oriented towards the point 
 Time the animal's head was oriented away from the point 
 Number of times the animal's head was oriented towards the point  

Location of point measures

 Point X coordinate 
 Point Y coordinate 
 Approximate time at the point  

  

  

Average distance from the point

DescriptionReports the average distance from the animal to the point.
Calculation methodFor each position of the animal, the distance is calculated from the point to the animal; this distance is averaged throughout the entire test or time period. The method actually used to calculate this distance depends on the setting made when setting up the point. Specifically, the distance can either be calculated based on the part of the animal which is closest to the point (excluding its tail), or based on the position of the centre of the animal.
Analysis across timeThis measure can be analysed across time. The result is the average distance from the point to the animal during the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesNone

  

  

Maximum distance from the point

DescriptionReports the maximum distance from the animal to the point.
Calculation methodFor each position of the animal, the distance is calculated from the point to the part of the animal that's closest to the point (the animal's tail is excluded). The maximum distance during the entire test or time period is the result. The method actually used to calculate this distance depends on the setting made when setting up the point. Specifically, the distance can either be calculated based on the part of the animal which is closest to the point (excluding its tail), or based on the position of the centre of the animal.
Analysis across timeThis measure can be analysed across time. The result is the maximum distance from the animal to the point during the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesNone

  

  

Minimum distance from the point

DescriptionReports the minimum distance from the animal to the point.
Calculation methodFor each position of the animal, the distance is calculated from the point to the part of the animal that's closest to the point (the animal's tail is excluded). The minimum distance during the entire test or time period is the result. The method actually used to calculate this distance depends on the setting made when setting up the point. Specifically, the distance can either be calculated based on the part of the animal which is closest to the point (excluding its tail), or based on the position of the centre of the animal.
Analysis across timeThis measure can be analysed across time. The result is the minimum distance from the animal to the point during the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesNone

  

  

Average distance of the animal's head from the point

DescriptionReports the average distance from the animal's head to the point.
Calculation methodCalculates the distance from the point to the position of the animal's head. Averages this distance through the entire test or time period.
Analysis across timeThis measure can be analysed across time. The result is the average distance from the point to the animal's head during the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesThis measure is only available if Head tracking is turned on.

  

  

Maximum distance of the animal's head from the point

DescriptionReports the maximum distance from the animal's head to the point.
Calculation methodCalculates the distance from the point to the position of the animal's head. The maximum distance during the entire test or time period is the result.
Analysis across timeThis measure can be analysed across time. The result is the maximum distance from the animal's head to the point during the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesThis measure is only available if Head tracking is turned on.

  

  

Minimum distance of the animal's head from the point

DescriptionReports the minimum distance from the animal's head to the point.
Calculation methodCalculates the distance from the point to the position of the animal's head. The minimum distance during the entire test or time period is the result.
Analysis across timeThis measure can be analysed across time. The result is the minimum distance from the animal's head to the point during the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesThis measure is only available if Head tracking is turned on.

  

  

Time moving towards the point

DescriptionReports the total amount of time for which the animal was moving towards the point.
Calculation methodFor each position of the animal, a vector is created between the current position and the next position. A second vector is then created between the current position and the point. The angle between these two vectors is calculated - see figure 1.

  

  

Figure 1. ANY-maze calculates the angle 'A' between the animal's heading and a direct heading to the point.

The absolute angle between the two vectors, 'A', is compared to the critical angle for movement towards a point (see notes). If the angle is less than this critical angle, then the animal is deemed to be moving towards the point. If the animal is moving towards the point, then the time taken to move from the current position to the next position is added to the total time moving towards the point.

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal is moving towards the point is specified in the Orientation and movement element of the protocol. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 90° (i.e. by default the angle 'A' will be compared to 45°).

  

  

Time moving away from the point

DescriptionReports the total amount of time for which the animal was moving away from the point.
Calculation methodFor each position of the animal, a vector is created between the current position and the next position. A second vector is then created between the current position and the point. The angle between these two vectors is calculated and subtracted from 180° - see figure 2.

  

  

Figure 2.  ANY-maze calculates the angle 'B' between the animal's heading and a direct heading to the point. This is then subtracted from 180°, yielding angle 'A'.

The angle 'A' is compared to the critical angle for movement away from a point (see notes). If the value is less than this critical angle, then the animal is deemed to be moving away from the point. If the animal is moving away from the point, then the time taken to move from the current position to the next position is added to the total time moving away from the point.

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal is moving away from the point is specified in the protocol's Orientation and movement element. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 90° (i.e. by default the angle 'A' will be compared to 45°).

  

  

Time the animal's head was moving towards the point

DescriptionReports the total amount of time for which the animal's head was moving towards the point.
Calculation methodFor each position of the animal's head, a vector is created between the current position and the next position. A second vector is then created between the current position and the point. The angle between these two vectors is calculated - see figure 3.

  

  

Figure 3. ANY-maze calculates the angle 'A' between the heading of the animal's head and the direct heading to the point.

The angle 'A' is compared to the critical angle for movement towards a point (see notes). If the angle is less than this critical angle, then the animal's head is deemed to be moving towards the point. If the animal's head is moving towards the point, then the time it took to move from the previous position to the current position is added to the total time moving towards the point.

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal is moving towards the point is specified in the Orientation and movement element of the protocol. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 90° (i.e. by default the angle beta is compared to 45°).

This measure is only available if Head tracking is turned on.

  

  

Time the animal's head was moving away from the point

DescriptionReports the total amount of time for which the animal's head was moving away from the point.
Calculation methodFor each position of the animal's head, a vector is created between the current position and the next position. A second vector is then created between the current position and the point. The angle between these two vectors is calculated and the result is subtracted from 180° - see figure 4.

  

  

Figure 4. ANY-maze calculates the angle 'B' between the heading of the animal's head and the direct heading to the point; this is then subtracted from 180°, yielding angle 'A'.

The angle 'A' is compared to the critical angle for movement away from a point (see notes). If the angle is less than this critical angle, then the animal's head is deemed to be moving away from the point. If the animal's head is moving away from the point, then the time it took to move from the previous position to the current position is added to the total time moving away from the point.

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal's head is moving away from the point is specified in the Orientation and movement element of the protocol. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 90° (i.e. by default the angle 'A' will be compared to 45°).

This measure is only available if Head tracking is turned on.

  

  

Average speed moving towards the point

DescriptionReports the average speed of the animal when it was moving towards the point.
Calculation methodFor each position of the animal, a vector is created between the current position and the next position. A second vector is then created between the current position and the point. The angle between these two vectors is calculated - see figure 5.

  

  

Figure 5. ANY-maze calculates the angle 'A' between the animal's heading and a direct heading to the point.

The absolute angle between the two vectors, 'A', is compared to the critical angle for movement towards a point (see notes). If the angle is less than this critical angle, then the animal is deemed to be moving towards the point. If the animal is moving towards the point, then the time taken to move from the current position to the next position is added to the total time moving towards the point and the distance from the current position to the next position is added to the total distance moving towards the point. At the end of the test the total distance moving towards the point is divided by the total time moving towards the point, yielding the average speed moving towards the point.

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsThe units specified in Analysis options on the Protocol page
NotesThe critical angle used to define whether the animal is moving towards the point is specified in the Orientation and movement element of the protocol. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 90° (i.e. by default the angle 'A' will be compared to 45°).   

  

  

Initial heading error to the point

DescriptionReports the angle between the animal's heading at the start of the test and a direct heading to the point.
Calculation methodCalculation of this measure depends on the settings in the Analysis options > Heading error sub-element of the protocol. Specifically, there are two options for how the animal's heading at the start of the test is determined - one uses a specific time delay, the other a specific distance. In the first case, the animal's heading is taken to be the vector from the its first position in the test to the first position detected after the specified time interval has elapsed. In the second case, the heading is taken to be the vector from the animal's first position in the test to the first position that's more than the specified distance from it. In both cases, positions that are detected while the animal is considered to be immobile (if immobility detection is switched on) are ignored - thus in the first case, the animal must be mobile for the period that is specified.

Having determined the animal's initial heading, the system then calculates the vector from the first position in the test to the point. The angle between this vector and the animal's heading vector is the initial heading error.

Analysis across timeThis measure cannot be analysed across time.
UnitsDegrees
NotesNone

  

  

Average absolute heading error to the point

DescriptionReports the average absolute angle between the animal's heading and a direct heading to the point.
Calculation methodThe animal's heading is defined as the vector that joins the position with the next position in time. The heading to the point is defined as the vector that joins the animal's position to the point, and the heading error is defined as the angle between the two vectors. This angle is calculated for every position of the animal, and the angle's absolute value is summed and then divided by the number of positions.

If immobility is being detected in a test, then all positions when the animal is deemed to be immobile are ignored in the calculation of the average heading error. If immobility is not being detected, then all positions are used - with the caveat that a position must be at least a minimum distance from the previous position for it to be considered. The minimum distance used is based on the size of the animal.

Analysis across timeThis measure can be analysed across time. The result is based on just those positions that fall within the time period.
UnitsDegrees
NotesNone

  

  

Time the animal's head was oriented towards the point

DescriptionReports the total amount of time for which the animal's head was oriented towards the point.
Calculation methodThe animal's orientation is defined by a vector connecting the start of the head vector position to the head position. For most animals, excluding quails, the start of the head vector position is the animal's centre. However, in the case of quails, it is a point near the base of the neck, which was determined during tracking. A second vector is created between the position of the animal's head and the position of the point. The angle between these two vectors is calculated - see figure 6.

  

  

Figure 6. ANY-maze calculates the angle beta between the two vectors Va (the vector which defines the animal's orientation) and Vb (the vector from the animal to the point).

The absolute angle between the two vectors (beta) is compared to the critical angle for movement away from/towards a point (see notes). If the angle is less than this critical angle, then the animal is deemed to be oriented towards the point. If the animal is oriented towards the point, then the time between the previous position of the animal and its current position is added to the total time oriented towards the point (irrespective of whether it was oriented towards the point at the previous position).

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal is oriented towards the point is the same angle as is used to determine whether the animal is moving towards or away from a point, and is defined in the Orientation and movement element of the protocol. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 60° (i.e. by default the angle beta will be compared to 30°).

This measure is only available if Head tracking is turned on.

  

  

Time the animal's head was oriented away from the point

DescriptionReports the total amount of time for which the animal's head was oriented away from the point.
Calculation methodThe animal's orientation is defined by a vector connecting the start of the head vector position to the head position. For most animals, excluding quails, the start of the head vector position is the animal's centre. However, in the case of quails, it is a point near the base of the neck, which was determined during tracking. A second vector is created between the position of the animal's head and the position of the point. The angle between these two vectors is calculated - see figure 7.

  

  

Figure 7. ANY-maze calculates the angle beta between the two vectors Va (the vector which defines the animal's orientation) and Vb (the vector from the animal to the point).

The angle between the two vectors (beta) is subtracted from 180° and the absolute value of the result is calculated; this is compared to the critical angle for movement towards/away from a point (see notes). If the angle is less than this critical angle, then the animal is deemed to be oriented away from the point. If the animal is oriented away from the point, then the time between the previous position of the animal and its current position is added to the total time oriented away from the point (irrespective of whether it was orientated away from the point at the previous position).

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal's head is oriented away from the point is the same angle as is used to determine whether the animal is moving towards or away from a point, and is defined in the protocol's Orientation and movement element. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 60° (i.e. by default the angle abs(180-beta) will be compared to 30°).

This measure is only available if Head tracking is turned on.

  

  

Number of times the animal's head was oriented towards the point

DescriptionReports the count of occasions when the animal's head was oriented towards the point.
Calculation methodThe animal's orientation is defined by a vector connecting the start of the head vector position to the head position. For most animals, excluding quails, the start of the head vector position is the animal's centre. However, in the case of quails, it is a point near the base of the neck, which was determined during tracking. A second vector is created between the position of the animal's head and the position of the point. The angle between these two vectors is calculated - see figure 8.

  

  

Figure 8. ANY-maze calculates the angle beta between the two vectors Va (the vector which defines the animal's orientation) and Vb (the vector from the animal to the point).

The absolute angle between the two vectors (beta) is compared to the critical angle for movement away from/towards a point (see notes). If the angle is less than this critical angle, then the animal is deemed to be oriented towards the point. If the animal is now oriented towards the point when previously it wasn't, then the count of occasions when the animal's head was oriented towards the point is increased by one.

Analysis across timeThis measure can be analysed across time. The result is calculated using just those positions which fall within the time period.
UnitsSeconds
NotesThe critical angle used to define whether the animal is oriented towards the point is the same angle as is used to determine whether the animal is moving towards or away from a point, and is defined in the protocol's Orientation and movement element. In fact, the value entered in the analysis options is twice the critical angle, as this is more intuitive. The default critical angle is 60° (i.e. by default the angle beta will be compared to 30°).

This measure is only available if Head tracking is turned on.   

  

  

Point X coordinate

DescriptionReports the X coordinate of the location of a point whose position is determined by where the animal spent the longest time either located or doing something, such as freezing.
Calculation methodA heat map for whatever the point is based on is created and the position of the 'hottest' value in the heat map is determined.
Analysis across timeThis measure cannot be analysed across time.
UnitsPixels
NotesThis measure is not available for points whose location in the apparatus is set within the protocol. This is because the location will be the same for all tests, and so reporting it as a measure is meaningless. If you want to know the location of such a point then it is reported in the Protocol report.

  

  

Point Y coordinate

DescriptionReports the Y coordinate of the location of a point whose position is determined by where the animal spent the longest time either located or doing something such as freezing.
Calculation methodA heat map for whatever the point is based on is created and the position of the 'hottest' value in the heat map is determined.
Analysis across timeThis measure cannot be analysed across time.
UnitsPixels
NotesThis measure is not available for points whose location in the apparatus is set within the protocol. This is because the location will be the same for all tests, and so reporting it as a measure is meaningless. If you want to know the location of such a point then it is reported in the Protocol report.

  

  

Approximate time at the point

DescriptionReports the approximate time the animal spent at the location of a point whose position is determined by where the animal spent the longest time either located or doing something, such as freezing.
Calculation methodA heat map for whatever the point is based on is created and the time the animal spent at the 'hottest' value in the heat map is determined.
Analysis across timeThis measure cannot be analysed across time.
UnitsSeconds
NotesThe value reported is approximate because the way a heat map is generated is itself approximate - heat maps being intended to provide a visual, rather than analytical, representation of the animal's behaviour during a test.

This measure is not available for points whose location in the apparatus is set within the protocol.

See also:

 Information measures 
 Apparatus measures 
 Zone 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 
 Virtual switch measures 

© Copyright 2003-2026 Stoelting Co. All rights reserved

ANY-maze help topic T0344