MarketData (OpenGamma Strata Data)

All Known Implementing Classes:

ImmutableMarketData
```
public interface MarketData
```
Provides access to market data, such as curves, surfaces and time-series.
Market data is looked up using subclasses of MarketDataId. All data is valid for a single date, defined by getValuationDate(). When performing calculations with scenarios, only the data of a single scenario is accessible.
The standard implementation is ImmutableMarketData.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default MarketData`	`combinedWith(MarketData other)` Combines this market data with another.
`default boolean`	`containsValue(MarketDataId<?> id)` Checks if this market data contains a value for the specified identifier.
`static MarketData`	`empty(LocalDate valuationDate)` Obtains an instance containing no market data.
`<T> Set<MarketDataId<T>>`	`findIds(MarketDataName<T> name)` Finds the market data identifiers associated with the specified name.
`<T> Optional<T>`	`findValue(MarketDataId<T> id)` Finds the market data value associated with the specified identifier.
`Set<MarketDataId<?>>`	`getIds()` Gets the market data identifiers.
`LocalDateDoubleTimeSeries`	`getTimeSeries(ObservableId id)` Gets the time-series identified by the specified identifier, empty if not found.
`Set<ObservableId>`	`getTimeSeriesIds()` Gets the time-series identifiers.
`LocalDate`	`getValuationDate()` Gets the valuation date of the market data.
`default <T> T`	`getValue(MarketDataId<T> id)` Gets the market data value associated with the specified identifier.
`static MarketData`	`of(LocalDate valuationDate, Map<? extends MarketDataId<?>,?> values)` Obtains an instance from a valuation date and map of values.
`static MarketData`	`of(LocalDate valuationDate, Map<? extends MarketDataId<?>,?> values, Map<? extends ObservableId,LocalDateDoubleTimeSeries> timeSeries)` Obtains an instance from a valuation date, map of values and time-series.
`default <T> MarketData`	`withValue(MarketDataId<T> id, T value)` Returns a copy of this market data with the specified value.

- Method Detail
  - of
```
static MarketData of(LocalDate valuationDate,
                     Map<? extends MarketDataId<?>,?> values)
```
    Obtains an instance from a valuation date and map of values.
    Each entry in the map is a single piece of market data, keyed by the matching identifier. For example, an FxRate can be looked up using an FxRateId. The caller must ensure that the each entry in the map corresponds with the parameterized type on the identifier.
    
    Parameters:
    
    valuationDate - the valuation date of the market data
    
    values - the market data values
    
    Returns:
    
    the market data instance containing the values in the map
    
    Throws:
    
    ClassCastException - if a value does not match the parameterized type associated with the identifier
  - of
```
static MarketData of(LocalDate valuationDate,
                     Map<? extends MarketDataId<?>,?> values,
                     Map<? extends ObservableId,LocalDateDoubleTimeSeries> timeSeries)
```
    Obtains an instance from a valuation date, map of values and time-series.
    
    Parameters:
    
    valuationDate - the valuation date of the market data
    
    values - the market data values
    
    timeSeries - the time-series
    
    Returns:
    
    the market data instance containing the values in the map and the time-series
    
    Throws:
    
    ClassCastException - if a value does not match the parameterized type associated with the identifier
  - empty
```
static MarketData empty(LocalDate valuationDate)
```
    Obtains an instance containing no market data.
    
    Parameters:
    
    valuationDate - the valuation date of the market data
    
    Returns:
    
    empty market data
  - getValuationDate
```
LocalDate getValuationDate()
```
    Gets the valuation date of the market data.
    All values accessible through this interface have the same valuation date.
    
    Returns:
    
    the valuation date
  - containsValue
```
default boolean containsValue(MarketDataId<?> id)
```
    Checks if this market data contains a value for the specified identifier.
    
    Parameters:
    
    id - the identifier to find
    
    Returns:
    
    true if the market data contains a value for the identifier
  - getValue
```
default <T> T getValue(MarketDataId<T> id)
```
    Gets the market data value associated with the specified identifier.
    If this market data instance contains the identifier, the value will be returned. Otherwise, an exception will be thrown.
    
    Type Parameters:
    
    T - the type of the market data value
    
    Parameters:
    
    id - the identifier to find
    
    Returns:
    
    the market data value
    
    Throws:
    
    MarketDataNotFoundException - if the identifier is not found
  - findValue
```
<T> Optional<T> findValue(MarketDataId<T> id)
```
    Finds the market data value associated with the specified identifier.
    If this market data instance contains the identifier, the value will be returned. Otherwise, an empty optional will be returned.
    
    Type Parameters:
    
    T - the type of the market data value
    
    Parameters:
    
    id - the identifier to find
    
    Returns:
    
    the market data value, empty if not found
  - getIds
```
Set<MarketDataId<?>> getIds()
```
    Gets the market data identifiers.
    
    Returns:
    
    the set of market data identifiers
  - findIds
```
<T> Set<MarketDataId<T>> findIds(MarketDataName<T> name)
```
    Finds the market data identifiers associated with the specified name.
    This returns the unique identifiers that refer to the specified name. There may be more than one identifier associated with a name as the name is not unique.
    
    Type Parameters:
    
    T - the type of the market data value
    
    Parameters:
    
    name - the name to find
    
    Returns:
    
    the set of market data identifiers, empty if name not found
  - getTimeSeriesIds
```
Set<ObservableId> getTimeSeriesIds()
```
    Gets the time-series identifiers.
    
    Returns:
    
    the set of observable identifiers
  - getTimeSeries
```
LocalDateDoubleTimeSeries getTimeSeries(ObservableId id)
```
    Gets the time-series identified by the specified identifier, empty if not found.
    
    Parameters:
    
    id - the identifier to find
    
    Returns:
    
    the time-series, empty if no time-series found
  - combinedWith
```
default MarketData combinedWith(MarketData other)
```
    Combines this market data with another.
    The result combines both sets of market data. Values are taken from this set of market data if available, otherwise they are taken from the other set.
    The valuation dates of the sets of market data must be the same.
    
    Parameters:
    
    other - the other market data
    
    Returns:
    
    the combined market data
  - withValue
```
default <T> MarketData withValue(MarketDataId<T> id,
                                 T value)
```
    Returns a copy of this market data with the specified value.
    When the result is queried for the specified identifier, the specified value will be returned.
    For example, this method could be used to replace a curve with a bumped curve.
    
    Type Parameters:
    
    T - the type of the market data value
    
    Parameters:
    
    id - the identifier to find
    
    value - the value to associate with the identifier
    
    Returns:
    
    the derived market data with the specified identifier and value

Copyright 2009-Present by OpenGamma Inc. and individual contributors
Apache v2 licensed
Additional documentation can be found at strata.opengamma.io.

Interface MarketData

Method Summary

Method Detail

of

of

empty

getValuationDate

containsValue

getValue

findValue

getIds

findIds

getTimeSeriesIds

getTimeSeries

combinedWith

withValue