Class: EstimateAccuracyChart
Instance Attribute Summary
Attributes inherited from ChartBase
#aggregated_project, #all_boards, #board_id, #canvas_height, #canvas_width, #data_quality, #date_range, #file_system, #holiday_dates, #issues, #settings, #time_range, #timezone_offset
Instance Method Summary
collapse
Methods inherited from ChartBase
#aggregated_project?, #canvas, #canvas_responsive?, #chart_format, #collapsible_issues_panel, #color_block, #color_for, #completed_issues_in_range, #current_board, #daily_chart_dataset, #describe_non_working_days, #description_text, #format_integer, #format_status, #header_text, #holidays, #html_directory, #icon_span, #label_days, #label_issues, #link_to_issue, #next_id, #random_color, #render, #render_top_text, #status_category_color, #wrap_and_render
Constructor Details
Returns a new instance of EstimateAccuracyChart.
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 4
def initialize configuration_block
super()
'Estimate Accuracy'
description_text <<-HTML
<div class="p">
This chart graphs estimates against actual recorded cycle times. Since
estimates can change over time, we're graphing the estimate at the time that the story started.
</div>
<div class="p">
The #{color_block '--estimate-accuracy-chart-completed-fill-color'} completed dots indicate
cycletimes.
<% if @has_aging_data %>
The #{color_block '--estimate-accuracy-chart-active-fill-color'} aging dots
(click on the legend to turn them on) show the current
age of items, which will give you a hint as to where they might end up. If they're already
far to the right then you know you have a problem.
<% end %>
</div>
HTML
@y_axis_label = 'Story Point Estimates'
@y_axis_type = 'linear'
@y_axis_block = ->(issue, start_time) { story_points_at(issue: issue, start_time: start_time)&.to_f }
@y_axis_sort_order = nil
instance_eval(&configuration_block)
end
|
Instance Method Details
#hash_sorter ⇒ Object
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 104
def hash_sorter
lambda do |arg1, arg2|
estimate1 = arg1[0][0]
estimate2 = arg2[0][0]
sample_count1 = arg1.size
sample_count2 = arg2.size
if @y_axis_sort_order
index1 = @y_axis_sort_order.index estimate1
index2 = @y_axis_sort_order.index estimate2
if index1.nil?
comparison = 1
elsif index2.nil?
comparison = -1
else
comparison = index1 <=> index2
end
return comparison unless comparison.zero?
end
sample_count2 <=> sample_count1
end
end
|
33
34
35
36
37
38
39
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 33
def run
data_sets = scan_issues
return '' if data_sets.empty?
wrap_and_render(binding, __FILE__)
end
|
#scan_issues ⇒ Object
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 41
def scan_issues
completed_hash, aging_hash = split_into_completed_and_aging issues: issues
@has_aging_data = !aging_hash.empty?
[
[completed_hash, 'Completed', 'completed', false],
[aging_hash, 'Still in progress', 'active', true]
].filter_map do |hash, label, completed_or_active, starts_hidden|
fill_color = CssVariable["--estimate-accuracy-chart-#{completed_or_active}-fill-color"]
border_color = CssVariable["--estimate-accuracy-chart-#{completed_or_active}-border-color"]
data = hash.sort(&hash_sorter).collect do |key, values|
estimate, cycle_time = *key
estimate_label = "#{estimate}#{'pts' if @y_axis_type == 'linear'}"
title = ["Estimate: #{estimate_label}, Cycletime: #{label_days(cycle_time)}, #{values.size} issues"] +
values.collect { |issue| "#{issue.key}: #{issue.summary}" }
{
'x' => cycle_time,
'y' => estimate,
'r' => values.size * 2,
'title' => title
}
end
next if data.empty?
{
'label' => label,
'data' => data,
'fill' => false,
'showLine' => false,
'backgroundColor' => fill_color,
'borderColor' => border_color,
'hidden' => starts_hidden
}
end
end
|
#split_into_completed_and_aging(issues:) ⇒ Object
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 80
def split_into_completed_and_aging issues:
aging_hash = {}
completed_hash = {}
issues.each do |issue|
cycletime = issue.board.cycletime
start_time, stop_time = cycletime.started_stopped_times(issue)
next unless start_time
hash = stop_time ? completed_hash : aging_hash
estimate = @y_axis_block.call issue, start_time
cycle_time = ((stop_time&.to_date || date_range.end) - start_time.to_date).to_i + 1
next if estimate.nil?
key = [estimate, cycle_time]
(hash[key] ||= []) << issue
end
[completed_hash, aging_hash]
end
|
#story_points_at(issue:, start_time:) ⇒ Object
129
130
131
132
133
134
135
136
137
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 129
def story_points_at issue:, start_time:
story_points = nil
issue.changes.each do |change|
return story_points if change.time >= start_time
story_points = change.value if change.story_points?
end
story_points
end
|
#y_axis(label:, sort_order: nil, &block) ⇒ Object
139
140
141
142
143
144
145
146
147
148
|
# File 'lib/jirametrics/estimate_accuracy_chart.rb', line 139
def y_axis label:, sort_order: nil, &block
@y_axis_sort_order = sort_order
@y_axis_label = label
if sort_order
@y_axis_type = 'category'
else
@y_axis_type = 'linear'
end
@y_axis_block = block
end
|