info.monitorenter.gui.chart.traces.accumulationstrategies

Class AAccumulationStrategy

java.lang.Object

info.monitorenter.gui.chart.traces.accumulationstrategies.AAccumulationStrategy

All Implemented Interfaces:

IAccumulationStrategy, Serializable

Direct Known Subclasses:

AccumulationStrategyAmountOfPoints, AccumulationStrategyByPass

public abstract class AAccumulationStrategy
extends Object
implements IAccumulationStrategy

Design helper to deal with the following: If a trace is unsorted then you have to accumulated all n consecutive points into one regardless whether they jump large distances in the value domain. The output might look like something that has nothing in common with the original trace without accumulations. Accumulation then is done just by deflating n consecutive points (see AccumulationStrategyAmountOfPoints).

If a trace is sorted then accumulation may be done based on value regions. Consider you have sorted ascending x values that have a high density of tracepoints in certain regions but a very low density in other regions. If you would accumulated just n consecutive points you would thin out the regions with very little data points (low density) to become even less precision in those large regions while the regions with high density only loose little information. If you decide to split up the visible range in to parts with same value-span then you can just accumulate depending on the density of x values. You will not loose data in value-ranges with low density but are able to drop lots of unnecessary values in high-density areas (see AccumulationStrategyXRangeWithRespectToDensity).

Property Change events

The following PropertyChangeEvent may be fired to PropertyChangeListener instances that register themselves with addPropertyChangeListener(String, PropertyChangeListener).

PropertyChangeEvent.getPropertyName()	EventObject.getSource()	PropertyChangeEvent.getOldValue()	PropertyChangeEvent.getNewValue()	When fired
PROPERTY_ACCUMULATION_FUNCTION	AAccumulationStrategy that changed	IAccumulationFunction, the old value	IAccumulationFunction, the new value	setAccumulationFunction(IAccumulationFunction) was called.
ITrace2DDataAccumulating.PROPERTY_ACCUMULATION_STRATEGY_ACCUMULATION_FUNCTION_CHANGED	ITrace2DDataAccumulating that changed	IAccumulationFunction, the old value	IAccumulationFunction, the new value	setAccumulationFunction(IAccumulationFunction) was called on the current accumulation strategy.

Author:

Achim Westermann

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface info.monitorenter.gui.chart.IAccumulationStrategy

IAccumulationStrategy.AccumulationControlConsecutivePoints, IAccumulationStrategy.IAccumulationControl

Field Summary

Fields

Modifier and Type	Field and Description
protected PropertyChangeSupport	m_propertyChangeSupport The instance that add support for firing PropertyChangeEvents and maintaining PropertyChangeListeners.
static String	PROPERTY_ACCUMULATION_FUNCTION The property key defining the getAccumulationFunction() property.

Constructor Summary

Constructors

Constructor and Description
AAccumulationStrategy(IAccumulationFunction accumulationFunction) Constructor taking the accumulation function to use.

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) Registers a property change listener that will be informed about changes of the property identified by the given propertyName.
protected void	firePropertyChange(String property, Object oldvalue, Object newvalue) Fires a property change event to the registered listeners.
IAccumulationFunction	getAccumulationFunction() Returns the accumulationFunction.
abstract Iterator<ITracePoint2D>	iterator(ITrace2D source, int amountOfPoints) Template method to return an iterator over accumulated points.
void	removePropertyChangeListener(PropertyChangeListener listener) Unregisters a property change listener that has been registered for listening on all properties.
void	removePropertyChangeListener(String property, PropertyChangeListener listener) Removes a property change listener for listening on the given property.
IAccumulationFunction	setAccumulationFunction(IAccumulationFunction accumulationFunction) Sets the accumulationFunction to use for this strategy.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROPERTY_ACCUMULATION_FUNCTION

public static String PROPERTY_ACCUMULATION_FUNCTION

The property key defining the getAccumulationFunction() property. Use in combination with addPropertyChangeListener(String, PropertyChangeListener).

m_propertyChangeSupport

protected PropertyChangeSupport m_propertyChangeSupport

The instance that add support for firing PropertyChangeEvents and maintaining PropertyChangeListeners.

Constructor Detail

AAccumulationStrategy

public AAccumulationStrategy(IAccumulationFunction accumulationFunction)

Constructor taking the accumulation function to use.

Parameters:

accumulationFunction - the accumulation function to use.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

Description copied from interface: IAccumulationStrategy

Registers a property change listener that will be informed about changes of the property identified by the given propertyName.

Specified by:

addPropertyChangeListener in interface IAccumulationStrategy

Parameters:

propertyName - the name of the property the listener is interested in

listener - a listener that will only be informed if the property identified by the argument propertyName changes

See Also:

IAccumulationStrategy.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

firePropertyChange

protected final void firePropertyChange(String property,
                                        Object oldvalue,
                                        Object newvalue)

Fires a property change event to the registered listeners.

Parameters:

property - one of the PROPERTY_XXX constants defined in AAccumulationStrategy.

oldvalue - the old value of the property.

newvalue - the new value of the property.

getAccumulationFunction

public IAccumulationFunction getAccumulationFunction()

Description copied from interface: IAccumulationStrategy

Returns the accumulationFunction.

Specified by:

getAccumulationFunction in interface IAccumulationStrategy

Returns:

the accumulationFunction

See Also:

IAccumulationStrategy.getAccumulationFunction()

iterator

public abstract Iterator<ITracePoint2D> iterator(ITrace2D source,
                                                 int amountOfPoints)

Description copied from interface: IAccumulationStrategy

Template method to return an iterator over accumulated points.

Specified by:

iterator in interface IAccumulationStrategy

Parameters:

source - the real points of this trace.

amountOfPoints - would allow to filter out points to accumulate by just taking n consecutive trace points.

Returns:

an iterator over the accumulated points from the given iterator.

See Also:

IAccumulationStrategy.iterator(info.monitorenter.gui.chart.ITrace2D, int)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Description copied from interface: IAccumulationStrategy

Unregisters a property change listener that has been registered for listening on all properties.

Specified by:

removePropertyChangeListener in interface IAccumulationStrategy

Parameters:

listener - a listener that will only be informed if the property identified by the argument propertyName changes

See Also:

IAccumulationStrategy.removePropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String property,
                                         PropertyChangeListener listener)

Description copied from interface: IAccumulationStrategy

Removes a property change listener for listening on the given property.

Specified by:

removePropertyChangeListener in interface IAccumulationStrategy

Parameters:

property - one of the constants with the PROPERTY_ prefix defined in this class or subclasses.

listener - the listener for this property change.

See Also:

IAccumulationStrategy.removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

setAccumulationFunction

public IAccumulationFunction setAccumulationFunction(IAccumulationFunction accumulationFunction)

Description copied from interface: IAccumulationStrategy

Sets the accumulationFunction to use for this strategy.

Specified by:

setAccumulationFunction in interface IAccumulationStrategy

Parameters:

accumulationFunction - the accumulationFunction to set.

Returns:

the previous accumulation function used.

See Also:

IAccumulationStrategy.setAccumulationFunction(info.monitorenter.gui.chart.IAccumulationFunction)