Detailed Segment Report

The following gives definitions for variables in the Detailed Segment Report.

Note that the extent to which these are meaningful will depend partly on how you collected your data and partly on the questions that you want to answer. It is a good idea to carefully check with some test data that results are meaningful. Please report issues related to this specific report to [email protected].

Variables that relate to "hover" samples are of course only available if these samples are available in your raw data. This is not the case if you are analysing an .eptxyp (Eye and Pen) or Handspy xml file. For many uses they are also not particularly valuable.

variable name	description
seg_id	Name of file with segment data. This will be a markwrite peoject (wmp) file
category	The name of the highest level segment in the current segment tree.
level	Level of current segment if segment tree.
segpath	Full path of segment.
name	Name (tag) assigned to the segment
start_time	Start time of the segment, in sec.msec format.
end_time	End time of the segment, in sec.msec format.
duration	Segment duration (end time - start time)
start_index	The index of the segment's first pen sample point in the full sample array (0 based indexing)
starts_with_press	First sample in segment is a pen press (i.e. pressure > 0)
end_index	The index of the segment's last pen sample point in the full sample array (0 based indexing)
sample_count	Number of samples in segment
subsegment_count	Number of subsegment (children) embraced by this segment.
prev_penpress_time	Time of the last pen-press (inking) sample
prev_pause	"Pause" prior to start of segment: start_time - prev_penpress_time
prev_xy_displacement	length of straight line drawn between previous pen-press and location of first sample in segment (calculated regardless of whether or not the segment starts with a pen-press)
prev_notpress_tracelength	Total "trace" length of pen tip between last pen-press and first sample of segment. This is the sum of straight-line distances between all hover samples, including cases where the pen goes out of range between samples.
prev_trace_disp_ratio	prev_notpress_tracelength / prev_xy_displacement Gives an indication of how much pen-waving occurred between during pen-lift prior to segment.
next_penpress_time	Time of first pen-press immediately following segment.
x_displacement	Distance in the x axis between first and final sample in segment (including non-press samples).
y_displacement	Distance in the y axis between first and final sample in segment (including non-press samples).
pentrace_length	total of distance moved by pen-tip between samples.
hover_pentrace_len	total of straight-line distance between samples, when not pressed.
press_pentrace_len	total of straight-line distance between samples, when pen is pressed. This therefore represents length of the inked lines of recorded by the digitiser).
time_hover	Total time the pen was in the air but within range of the digitiser during the segment period.
time_press	Total time pen was in contact with digitiser surface during segment period.
time_notpress	duration - time_press: Total time in segment when the pen was not pressed on the digitiser surface.
time_outrange	duration - time_press - time_hover: Total time in segment when pen was not recording.