com.opengamma.strata.product.swap.RateCalculation Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of strata-product Show documentation

Domain objects describing trades and products in financial markets

There is a newer version: 2.12.48

/*
 * Copyright (C) 2014 - present by OpenGamma Inc. and the OpenGamma group of companies
 *
 * Please see distribution for license.
 */
package com.opengamma.strata.product.swap;

import com.google.common.collect.ImmutableList;
import com.google.common.collect.ImmutableSet;
import com.opengamma.strata.basics.ReferenceData;
import com.opengamma.strata.basics.ReferenceDataNotFoundException;
import com.opengamma.strata.basics.currency.Currency;
import com.opengamma.strata.basics.date.DayCount;
import com.opengamma.strata.basics.index.Index;
import com.opengamma.strata.basics.schedule.Schedule;

/**
 * The accrual calculation part of an interest rate swap leg.
 * 
 * An interest rate swap leg is defined by {@link RateCalculationSwapLeg}.
 * The rate to be paid is defined by the implementations of this interface.
 * 

 * Implementations must be immutable and thread-safe beans.
 */
public interface RateCalculation {

  /**
   * Gets the type of the leg, such as Fixed or Ibor.
   * 

   * This provides a high level categorization of the swap leg.
   * 
   * @return the leg type
   */
  public abstract SwapLegType getType();

  /**
   * Gets the day count convention.
   * 

   * This is used to convert schedule period dates to a numerical value.
   * 
   * @return the day count convention
   */
  public abstract DayCount getDayCount();

  /**
   * Collects all the currencies referred to by this calculation.
   * 

   * This collects the complete set of currencies for the calculation, not just the payment currencies.
   * 
   * @param builder  the builder to populate
   */
  public abstract void collectCurrencies(ImmutableSet.Builder builder);

  /**
   * Collects all the indices referred to by this calculation.
   * 

   * A calculation will typically refer to at least one index, such as 'GBP-LIBOR-3M'.
   * Each index that is referred to must be added to the specified builder.
   * 
   * @param builder  the builder to use
   */
  public abstract void collectIndices(ImmutableSet.Builder builder);

  /**
   * Creates accrual periods based on the specified schedule.
   * 
   * The specified accrual schedule defines the period dates to be created.
   * One instance of {@link RateAccrualPeriod} must be created for each period in the schedule.
   * 
   * @param accrualSchedule  the accrual schedule
   * @param paymentSchedule  the payment schedule
   * @param refData  the reference data to use when resolving
   * @return the accrual periods
   * @throws ReferenceDataNotFoundException if an identifier cannot be resolved in the reference data
   * @throws RuntimeException if the calculation is invalid
   */
  public abstract ImmutableList createAccrualPeriods(
      Schedule accrualSchedule,
      Schedule paymentSchedule,
      ReferenceData refData);

}