ENTITY SPECIFIC FILTERS
-----------------------
1. Time Stamp Order Filter - Checks whether the input stream of	entities
are in timestamp order
	
	Filter Config File syntax-
	f tsorder
	
	COMMENTS - 
	This filter takes not parameters as input
	


	
2. Type Filter - This retains entities only of the "types" specified.  A
type is one of  Event, Histogram, Counter


	Filter Config File syntax-
	f type <type1> <type2> .....
	
	COMMENTS - 
	This filter takes a list of types as Input. 
	Ex: types=["Event", "Histogram"]



2. Tag Filter - This retains entities with the "tag" values specified.  A
tag is a numeric value.


	Filter config file Syntax-
	f type <tag1> <tag2> .....
	
	COMMENTS - 
	This filter takes a list of tags as Input. 
	Ex: tags=[123,456]

3. Inperiod filter - An inperiod filter lets specify 2 timestamps, and
events only within this time-period will pass the filter

	Filter config file Syntax-
	f inperiod <start time> <end time>

	COMMENTS - This filter takes a starttime and an endtime as arguments

4. Name Filter - A name filter that filters events with specific names
	
	
	Filter config file Syntax-
	f name <name1> <name2> ...

	COMMENTS - This filter takes a list of names as arguments. Each name is
	a string. 
	Ex: list_of_names=["EVENT_START", "EVENT_END", "EVENT_ENTER_LOOP"]	

5. NULL filter - perform no filtering. Retain all entities from input in
output.

	Filter config file Syntax-
	f null
	
	COMMENTS - No arguments are taken by the filter


6. Interval Filter - An interval filter generated intervals for pairs of
specific events that are in the input stream 

	Filter config file Syntax-
	f interval <start_of_the_interval_events_id> <end_id>  <name_of_the_interval>
	
	COMMENTS - An interval filter takes the id of the event tha should
	represent the start of the interval, the id of the end event and the
	name of the interval. The ids are numeric values while the name is a
	string.


7. Merge filter - merges 2 or more input files based on timestamp.  A merge
filter merges the information elements of two information element stream
into one. The timestamp ordering is maintained in the output file after
merging.  


	Filter config file Syntax-
	f merge

	COMMENTS - Doesnt take any argument as input

8. Histogram Graphs Filter - A histogram graph filter produces gnuplot
input files to generate histogram graphs for each histogram present in the
input stream. The output from this filter are the  gnuplot input files.


	Filter config file Syntax-
	f graph <speed in cputicks per sec> <title of the graph> <name>

	COMMENTS - This filter expects the speed, which is a numeric value and
	the title of the graph as input. The title is a string value. It also
	expects a name argument, which is a string and shall be used while
	generating the output graph filenames.


9. Elapsed Timestamp Filter - An elapsed time filter modifies absolute
timestamp as they appear in a raw data stream to instead be the elapsed
time from the start of the data-set. The CPU speed (ticks per second)
should be passed to the filter to convert the timestamps into
micro-seconds.

	Filter config file Syntax-
	f elapsed_time <speed in CPU ticks per second>
	
	COMMENTS - This filter expects the speed of the CPU in CPU Ticks per
	second as an argument. Its basically a numeric value.


INTERVAL SPECIFIC FILTERS
-------------------------
1. Merge Interval Filter - merges 2 or more interval input files based on
start timestamp of the interval.  A merge filter merges the information
elements of two information element stream into one. The timestamp ordering
is maintained in the output file after merging.  

	
	Filter config file Syntax-
	i merge

	COMMENTS - Doesnt take any argument as input


2. Elapsed Timestamp Filter - An elapsed time filter modifies absolute
timestamp as they appear in a raw data stream to instead be the elapsed
time from the start of the data-set. The CPU speed (ticks per second)
should be passed to the filter to convert the timestamps into
micro-seconds. This elapsed time filter works on interval input files.

	Filter config file Syntax-
	i elapsed_time <speed in CPU ticks per second>
	
	COMMENTS - This filter expects the speed of the CPU in CPU Ticks per
	second as an argument. Its basically a numeric value.


3. XML Histogram - Generate a XML histogram from the interval input stream
for the interval type specified.

	Filter config file Syntax-
	i xml type1 type2 type3 ...
	
	COMMENTS - This filter takes a list of interval types for which
	histograms have to be generated. The contents of the list are the types
	of the intervals, which is a string value
	Ex: list_of_interval_types=["CONTEXT_SWITCH_INTERVAL","INTERVAL1"]
	


4. Interval Graph Filter - Generate a histogram graph from the interval
input stream for the interval types specified.

	Filter config file Syntax-
	i graph <speed in cputicks per sec> <title of the graph> <interval type1> <interval type2> ....

	COMMENTS - This filter expects the speed, which is a numeric value and
	the title of the graph as input. The title is a string value.  This
	filter also takes a list of interval types for which graphs have to be
	generated. The contents of the list are the types of the intervals,
	which is a string value