vpal.utility Namespace Reference

Classes
class	Bar
class	ContinuousQuantityFilter
class	DiscreteQuantityFilter

Functions
def	collect_object_value_pairs (obj_list, value_name1, value_name2, sort_items=False)
def	collect_object_values (obj_list, value_name)
def	combined_filter (object_list, filter_list)
def	compute_2d_pareto_front (obj_list, par1, par2, maximize1=True, maximize2=True)
def	compute_weighted_mean (value_list, weight_list)
def	int_to_time (t)
def	limit_periodic_quantity_to_range (value_to_limit, low_value=-180.0, high_value=180.0)
def	mad (value_list)
def	minimum_angular_difference (angle1, angle2, low_value=-180.0, high_value=180.0)
def	print_table (table, n_digits=9)
def	sort_objects_by_quantity (object_list, quantity_name, reverse_boolean=False)
def	tabulate (table, headers=None, n_digits=9, padding=3)
def	time_to_int (year, day, hour, minute, sec)

Detailed Description

utility function module

Function Documentation

collect_object_value_pairs()

def vpal.utility.collect_object_value_pairs	(		obj_list,
			value_name1,
			value_name2,
			sort_items = False
	)

collect set of value pairs from a list of objects
(if sort_items=True, we sort them on the first value) 

collect_object_values()

def vpal.utility.collect_object_values	(		obj_list,
			value_name
	)

collect a value from a list of objects

combined_filter()

def vpal.utility.combined_filter	(		object_list,
			filter_list
	)

takes a list of objects, and a list of filters (may be a
combination of discrete or continuous value filters)
and returns a list of objects files which pass all of the filters

compute_2d_pareto_front()

def vpal.utility.compute_2d_pareto_front	(		obj_list,
			par1,
			par2,
			maximize1 = True,
			maximize2 = True
	)

returns a list of objects on the pareto front of par1 and par2
if maximize1 or maximize2 is false, then the objective for that variable will
be minimization rather than maximization

compute_weighted_mean()

def vpal.utility.compute_weighted_mean	(		value_list,
			weight_list
	)

return the weighted mean of a list of values

int_to_time()

def vpal.utility.int_to_time

(

t

)

ported from int_to_time.c

limit_periodic_quantity_to_range()

def vpal.utility.limit_periodic_quantity_to_range	(		value_to_limit,
			low_value = -180.0,
			high_value = 180.0
	)

clamp periodic variable to range [low_value,high_value)

mad()

def vpal.utility.mad

(

value_list

)

computes the median absolute deviation of a list of numbers
see: Anomaly Detection by Robust Statistics, P. Rousseeuw & M. Hubert

minimum_angular_difference()

def vpal.utility.minimum_angular_difference	(		angle1,
			angle2,
			low_value = -180.0,
			high_value = 180.0
	)

compute smallest value of (angle1-angle2) taking branch cuts into account

print_table()

def vpal.utility.print_table	(		table,
			n_digits = 9
	)

simple formatted print out of a table

sort_objects_by_quantity()

def vpal.utility.sort_objects_by_quantity	(		object_list,
			quantity_name,
			reverse_boolean = False
	)

#sorts low to high (if reverse is True, then high to low)

tabulate()

def vpal.utility.tabulate	(		table,
			headers = None,
			n_digits = 9,
			padding = 3
	)

simple formatted chunk of text representing a table, replacement for tabulate module

time_to_int()

def vpal.utility.time_to_int	(		year,
			day,
			hour,
			minute,
			sec
	)

ported from time_to_int.c in hops/sub/util