org.rhq.core.domain.measurement.util
Class MeasurementConverter

java.lang.Object
  org.rhq.core.domain.measurement.util.MeasurementConverter

public class MeasurementConverter
extends Object

Constructor Summary

MeasurementConverter()

Method Summary

static MeasurementNumericValueAndUnits	fit(Double origin, MeasurementUnits units)
static MeasurementNumericValueAndUnits	fit(Double origin, MeasurementUnits units, MeasurementUnits lowUnits, MeasurementUnits highUnits)
static String	format(Double value, MeasurementUnits targetUnits, boolean bestFit)
static String	format(Double value, MeasurementUnits targetUnits, boolean bestFit, Integer minimumFractionDigits, Integer maximumFractionDigits)
static String	format(String value, MeasurementUnits targetUnits)
static String[]	formatToSignificantPrecision(double[] values, MeasurementUnits targetUnits, boolean bestFit) Formats the given array of double values: determines the necessary precision such that when formatted, they are distinct and reasonable to look at.
static MeasurementNumericValueAndUnits	parse(String input, MeasurementSchedule targetSchedule)
static MeasurementNumericValueAndUnits	parse(String input, MeasurementUnits targetUnits)
static Double	scale(Double origin, MeasurementUnits targetUnits)
static Double	scale(MeasurementNumericValueAndUnits origin, MeasurementUnits targetUnits)
static String	scaleAndFormat(Double origin, MeasurementSchedule targetSchedule, boolean bestFit)
static String	scaleAndFormat(Double origin, MeasurementUnits targetUnits, boolean bestFit)
static String	scaleAndFormat(Double origin, MeasurementUnits targetUnits, boolean bestFit, Integer minimumFractionDigits, Integer maximumFractionDigits)

Methods inherited from class java.lang.Object

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

Constructor Detail

MeasurementConverter

public MeasurementConverter()

Method Detail

parse

public static MeasurementNumericValueAndUnits parse(String input,
                                                    MeasurementUnits targetUnits)
                                             throws MeasurementConversionException

Throws:

MeasurementConversionException

parse

public static MeasurementNumericValueAndUnits parse(String input,
                                                    MeasurementSchedule targetSchedule)
                                             throws MeasurementConversionException

Throws:

MeasurementConversionException

scale

public static Double scale(MeasurementNumericValueAndUnits origin,
                           MeasurementUnits targetUnits)
                    throws MeasurementConversionException

Throws:

MeasurementConversionException

scale

public static Double scale(Double origin,
                           MeasurementUnits targetUnits)
                    throws MeasurementConversionException

Throws:

MeasurementConversionException

format

public static String format(String value,
                            MeasurementUnits targetUnits)

formatToSignificantPrecision

public static String[] formatToSignificantPrecision(double[] values,
                                                    MeasurementUnits targetUnits,
                                                    boolean bestFit)

Formats the given array of double values: determines the necessary precision such that when formatted, they are distinct and reasonable to look at. For example, for values { 1.45 1.46 1.47 1.48 1.49 } the desired precision is 2 - less precision loses significant digits, and more precision provides no added benefit. Max precision is bounded for presentation considerations.

Parameters:

values - the values to be formatted

targetUnits - the target units for the values

bestFit - whether or not to use a normalized scale for the family of units

Returns:

the formatted values

format

public static String format(Double value,
                            MeasurementUnits targetUnits,
                            boolean bestFit)

format

public static String format(Double value,
                            MeasurementUnits targetUnits,
                            boolean bestFit,
                            Integer minimumFractionDigits,
                            Integer maximumFractionDigits)

scaleAndFormat

public static String scaleAndFormat(Double origin,
                                    MeasurementSchedule targetSchedule,
                                    boolean bestFit)
                             throws MeasurementConversionException

Throws:

MeasurementConversionException

scaleAndFormat

public static String scaleAndFormat(Double origin,
                                    MeasurementUnits targetUnits,
                                    boolean bestFit)
                             throws MeasurementConversionException

Throws:

MeasurementConversionException

scaleAndFormat

public static String scaleAndFormat(Double origin,
                                    MeasurementUnits targetUnits,
                                    boolean bestFit,
                                    Integer minimumFractionDigits,
                                    Integer maximumFractionDigits)
                             throws MeasurementConversionException

Throws:

MeasurementConversionException

fit

public static MeasurementNumericValueAndUnits fit(Double origin,
                                                  MeasurementUnits units)

fit

public static MeasurementNumericValueAndUnits fit(Double origin,
                                                  MeasurementUnits units,
                                                  MeasurementUnits lowUnits,
                                                  MeasurementUnits highUnits)