Class BondYieldSensitivity
- java.lang.Object
-
- com.opengamma.strata.pricer.bond.BondYieldSensitivity
-
- All Implemented Interfaces:
FxConvertible<PointSensitivity>
,PointSensitivity
,PointSensitivityBuilder
,Serializable
,org.joda.beans.Bean
,org.joda.beans.ImmutableBean
public final class BondYieldSensitivity extends Object implements PointSensitivity, PointSensitivityBuilder, org.joda.beans.ImmutableBean, Serializable
Point sensitivity to a bond yield implied parameter point.Holds the sensitivity to the bond yield grid point.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
BondYieldSensitivity.Meta
The meta-bean forBondYieldSensitivity
.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description MutablePointSensitivities
buildInto(MutablePointSensitivities combination)
Builds the point sensitivity, adding to the specified mutable instance.BondYieldSensitivity
cloned()
Clones the point sensitivity builder.int
compareKey(PointSensitivity other)
Compares the key of two sensitivities, excluding the point sensitivity value.BondYieldSensitivity
convertedTo(Currency resultCurrency, FxRateProvider rateProvider)
Converts this instance to an equivalent amount in the specified currency.boolean
equals(Object obj)
Currency
getCurrency()
Gets the currency of the sensitivity.double
getDuration()
Gets the underlying duration.double
getExpiry()
Gets the time to expiry of the option as a year fraction.double
getForward()
Gets the underlying bond forward yield.double
getSensitivity()
Gets the value of the sensitivity.double
getStrike()
Gets the strike yield.BondVolatilitiesName
getVolatilitiesName()
Gets the name of the volatilities.int
hashCode()
BondYieldSensitivity
mapSensitivity(DoubleUnaryOperator operator)
Returns an instance with the specified operation applied to the sensitivities in this builder.static BondYieldSensitivity.Meta
meta()
The meta-bean forBondYieldSensitivity
.BondYieldSensitivity.Meta
metaBean()
BondYieldSensitivity
multipliedBy(double factor)
Multiplies the sensitivities in this builder by the specified factor.BondYieldSensitivity
normalize()
Normalizes the point sensitivities by sorting and merging.static BondYieldSensitivity
of(BondVolatilitiesName volatilitiesName, double expiry, double duration, double strike, double forward, Currency sensitivityCurrency, double sensitivity)
Obtains an instance from the specified elements.String
toString()
BondYieldSensitivity
withCurrency(Currency currency)
Returns an instance with the specified sensitivity currency set.BondYieldSensitivity
withSensitivity(double value)
Returns an instance with the new point sensitivity value.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.opengamma.strata.market.sensitivity.PointSensitivityBuilder
build, combinedWith
-
-
-
-
Method Detail
-
of
public static BondYieldSensitivity of(BondVolatilitiesName volatilitiesName, double expiry, double duration, double strike, double forward, Currency sensitivityCurrency, double sensitivity)
Obtains an instance from the specified elements.- Parameters:
volatilitiesName
- the name of the volatilitiesexpiry
- the time to expiry of the option as a year fractionduration
- the underlying bond durationstrike
- the bond strike yieldforward
- the underlying bond forward yieldsensitivityCurrency
- the currency of the sensitivitysensitivity
- the value of the sensitivity- Returns:
- the point sensitivity object
-
withCurrency
public BondYieldSensitivity withCurrency(Currency currency)
Description copied from interface:PointSensitivity
Returns an instance with the specified sensitivity currency set.The result will consists of the same points, but with the sensitivity currency altered.
- Specified by:
withCurrency
in interfacePointSensitivity
- Specified by:
withCurrency
in interfacePointSensitivityBuilder
- Parameters:
currency
- the new currency- Returns:
- an instance based on this sensitivity with the specified currency
-
withSensitivity
public BondYieldSensitivity withSensitivity(double value)
Description copied from interface:PointSensitivity
Returns an instance with the new point sensitivity value.- Specified by:
withSensitivity
in interfacePointSensitivity
- Parameters:
value
- the new sensitivity- Returns:
- an instance based on this sensitivity with the specified sensitivity
-
compareKey
public int compareKey(PointSensitivity other)
Description copied from interface:PointSensitivity
Compares the key of two sensitivities, excluding the point sensitivity value.If the other point sensitivity is of a different type, the comparison is based solely on the simple class name. If the point sensitivity is of the same type, the comparison must check the key, then the currency, then the date, then any other state.
The comparison by simple class name ensures that all instances of the same type are ordered together.
- Specified by:
compareKey
in interfacePointSensitivity
- Parameters:
other
- the other sensitivity- Returns:
- positive if greater, zero if equal, negative if less
-
convertedTo
public BondYieldSensitivity convertedTo(Currency resultCurrency, FxRateProvider rateProvider)
Description copied from interface:PointSensitivity
Converts this instance to an equivalent amount in the specified currency.The result will be expressed in terms of the given currency. Any FX conversion that is required will use rates from the provider.
- Specified by:
convertedTo
in interfaceFxConvertible<PointSensitivity>
- Specified by:
convertedTo
in interfacePointSensitivity
- Parameters:
resultCurrency
- the currency of the resultrateProvider
- the provider of FX rates- Returns:
- the converted instance, which should be expressed in the specified currency
-
multipliedBy
public BondYieldSensitivity multipliedBy(double factor)
Description copied from interface:PointSensitivityBuilder
Multiplies the sensitivities in this builder by the specified factor.The result will consist of the same points, but with each sensitivity multiplied.
Builders may be mutable. Once this method is called, this instance must not be used. Instead, the result of the method must be used.
- Specified by:
multipliedBy
in interfacePointSensitivityBuilder
- Parameters:
factor
- the multiplicative factor- Returns:
- the resulting builder, replacing this builder
-
mapSensitivity
public BondYieldSensitivity mapSensitivity(DoubleUnaryOperator operator)
Description copied from interface:PointSensitivityBuilder
Returns an instance with the specified operation applied to the sensitivities in this builder.The result will consist of the same points, but with the operator applied to each sensitivity.
This is used to apply a mathematical operation to the sensitivities. For example, the operator could multiply the sensitivities by a constant, or take the inverse.
inverse = base.mapSensitivities(value -> 1 / value);
Builders may be mutable. Once this method is called, this instance must not be used. Instead, the result of the method must be used.
- Specified by:
mapSensitivity
in interfacePointSensitivityBuilder
- Parameters:
operator
- the operator to be applied to the sensitivities- Returns:
- the resulting builder, replacing this builder
-
normalize
public BondYieldSensitivity normalize()
Description copied from interface:PointSensitivityBuilder
Normalizes the point sensitivities by sorting and merging.The sensitivities in the builder are sorted and then merged. Any two entries that represent the same curve query are merged. For example, if there are two point sensitivities that were created based on the same curve, currency and fixing date, then the entries are combined, summing the sensitivity value.
Builders may be mutable. Once this method is called, this instance must not be used. Instead, the result of the method must be used.
- Specified by:
normalize
in interfacePointSensitivityBuilder
- Returns:
- the resulting builder, replacing this builder
-
buildInto
public MutablePointSensitivities buildInto(MutablePointSensitivities combination)
Description copied from interface:PointSensitivityBuilder
Builds the point sensitivity, adding to the specified mutable instance.- Specified by:
buildInto
in interfacePointSensitivityBuilder
- Parameters:
combination
- the combination object to add to- Returns:
- the specified mutable point sensitivities instance is returned, for method chaining
-
cloned
public BondYieldSensitivity cloned()
Description copied from interface:PointSensitivityBuilder
Clones the point sensitivity builder.This returns a
PointSensitivityBuilder
instance that is independent from the original. Immutable implementations may return themselves.Builders may be mutable. Using this method allows a copy of the original to be obtained, so both the original and the clone can be used.
- Specified by:
cloned
in interfacePointSensitivityBuilder
- Returns:
- the built combined sensitivity
-
meta
public static BondYieldSensitivity.Meta meta()
The meta-bean forBondYieldSensitivity
.- Returns:
- the meta-bean, not null
-
metaBean
public BondYieldSensitivity.Meta metaBean()
- Specified by:
metaBean
in interfaceorg.joda.beans.Bean
-
getVolatilitiesName
public BondVolatilitiesName getVolatilitiesName()
Gets the name of the volatilities.- Returns:
- the value of the property, not null
-
getExpiry
public double getExpiry()
Gets the time to expiry of the option as a year fraction.- Returns:
- the value of the property, not null
-
getDuration
public double getDuration()
Gets the underlying duration.- Returns:
- the value of the property
-
getStrike
public double getStrike()
Gets the strike yield.- Returns:
- the value of the property
-
getForward
public double getForward()
Gets the underlying bond forward yield.- Returns:
- the value of the property
-
getCurrency
public Currency getCurrency()
Gets the currency of the sensitivity.- Specified by:
getCurrency
in interfacePointSensitivity
- Returns:
- the value of the property, not null
-
getSensitivity
public double getSensitivity()
Gets the value of the sensitivity.- Specified by:
getSensitivity
in interfacePointSensitivity
- Returns:
- the value of the property
-
-