HP Caliper Advisor Rule Writer Guide

the name of a function, the name of the image it is part of, and its sample count)
is returned. Note that fewer than 10 functions might be returned if that is all there
is.
• metrics = object.get_histogram(‘DCACHE’, ‘n’)
metrics: (1)
This example shows an easy way to test for the presence of dcache histogram
performance data without actually retrieving the data. If at least one such dataset
exists, then its integer ID number is returned. Otherwise, the None value is
returned.
• metrics = object.get_histogram_nth(‘ICACHE’, (‘FUNCTION’,
25, ‘AVERAGE_LATENCY’), -1)
metrics: ((('__f_fo', 'sweep3d', 1, 402, 402.0),
('inner_auto_', 'sweep3d', 1, 283, 283.0),
('__itrunc_', 'sweep3d', 1, 281, 281.0),
('global_int_sum_', 'sweep3d', 4, 627, 156.75),
('bcast_real_', 'sweep3d', 1, 151, 151.0),
('bcast_int_', 'sweep3d', 4, 545, 136.25),
('__set_global_flags', 'sweep3d', 2, 263, 131.5),
('inner_', 'sweep3d', 2, 259, 129.5),
('octant_', 'sweep3d', 49, 5270,
107.55102040816327),
('ld_out', 'sweep3d', 9, 635, 70.555555555555557),
('flux_err_', 'sweep3d', 5, 279,
55.799999999999997),
('source_', 'sweep3d', 4, 189, 47.25),
('____F90_START_IO', 'sweep3d', 6, 283,
47.166666666666664),
('__io_unit_lock', 'sweep3d', 2, 86, 43.0),
('__sinit_com_util_C_', 'libunwind.so.1', 1, 35,
35.0),
('__milli_div32I', 'sweep3d', 45, 936,
20.800000000000001),
('sweep_', 'sweep3d', 5974, 104901,
17.559591563441579),
('write_list_item', 'sweep3d', 4, 43, 10.75),
('real_malloc', 'libc.so.1', 1, 10, 10.0),
('memmove', 'libc.so.1', 2, 17, 8.5),
('__cnv_ic', 'sweep3d', 1, 8, 8.0),
46 HP Caliper Advisor Accessor Functions