28.2. ActiveTime

28.2. ActiveTime
Prev	Chapter 28. Software Project Telemetry: Reduction Functions	Next

	Active Time is deprecated: please use DevTime instead
	As of October 2006, we recommend the use of the DevTime family of reduction functions (DevTime, EventTypeDevTime, WorkspaceDevTime, MemberDevTime) instead of Active Time. DevTime provides a more comprehensive approach to measuring developer activities and the time spent on them.

28.2.1. Description

ActiveTime reduction function computs single telemetry stream representing the total active time of the entire project. Active time is a measure of the time spent by developers actively editing code inside an IDE. It measures a small part of overall developer "effort".

28.2.2. Parameters

Table 28.1.

Parameter	Description	Default
filePattern	Ant-like file pattern specifying the files to be included in computation.	**
isCumulative	If true, an cumulative version of telemetry stream is returned.	false

28.2.3. Example

Example 28.1. ActiveTime

streams ActiveTimeStream(filePattern, cumulative) = {
   "Active Time", ActiveTime(filePattern, cumulative)
};

y-axis yAxis(label) = {label};

chart ActiveTimeChart() = {
  "Overall Active Time", 
  (ActiveTimeStream("**", "false"), yAxis("Active Time Hours"))
};

draw ActiveTimeChart();

This chart shows that for the project in question, active time varied from 5 hours to 80 hours per week over the course of 16 weeks. This is a non-cumulative active time telemetry which includes all the files in project in computation.