/*
* QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals.
* Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
using System;
using System.Collections.Generic;
using System.Linq;
using QuantConnect.Data;
using QuantConnect.Interfaces;
using QuantConnect.Util;
namespace QuantConnect.Securities.Volatility
{
///
/// Represents a base model that computes the volatility of a security
///
public class BaseVolatilityModel : IVolatilityModel
{
///
/// Provides access to registered
///
protected ISubscriptionDataConfigProvider SubscriptionDataConfigProvider { get; set; }
///
/// Gets the volatility of the security as a percentage
///
public virtual decimal Volatility { get; }
///
/// Sets the instance to use.
///
/// Provides access to registered
public virtual void SetSubscriptionDataConfigProvider(
ISubscriptionDataConfigProvider subscriptionDataConfigProvider)
{
SubscriptionDataConfigProvider = subscriptionDataConfigProvider;
}
///
/// Updates this model using the new price information in
/// the specified security instance
///
/// The security to calculate volatility for
/// The new data used to update the model
public virtual void Update(Security security, BaseData data)
{
}
///
/// Returns history requirements for the volatility model expressed in the form of history request
///
/// The security of the request
/// The date/time of the request
/// History request object list, or empty if no requirements
public virtual IEnumerable GetHistoryRequirements(Security security, DateTime utcTime)
{
return Enumerable.Empty();
}
///
/// Gets history requests required for warming up the greeks with the provided resolution
///
/// Security to get history for
/// UTC time of the request (end time)
/// Resolution of the security
/// Number of bars to lookback for the start date
/// Enumerable of history requests
/// The has not been set
public IEnumerable GetHistoryRequirements(
Security security,
DateTime utcTime,
Resolution? resolution,
int barCount)
{
if (SubscriptionDataConfigProvider == null)
{
throw new InvalidOperationException(
"BaseVolatilityModel.GetHistoryRequirements(): " +
"SubscriptionDataConfigProvider was not set."
);
}
var configurations = SubscriptionDataConfigProvider
.GetSubscriptionDataConfigs(security.Symbol)
.OrderBy(c => c.TickType)
.ToList();
var configuration = configurations.First();
var bar = configuration.Type.GetBaseDataInstance();
bar.Symbol = security.Symbol;
var historyResolution = resolution ?? bar.SupportedResolutions().Max();
var periodSpan = historyResolution.ToTimeSpan();
// hour resolution does no have extended market hours data
var extendedMarketHours = periodSpan != Time.OneHour && configurations.IsExtendedMarketHours();
var localStartTime = Time.GetStartTimeForTradeBars(
security.Exchange.Hours,
utcTime.ConvertFromUtc(security.Exchange.TimeZone),
periodSpan,
barCount,
extendedMarketHours,
configuration.DataTimeZone, dailyPreciseEndTime: false);
var utcStartTime = localStartTime.ConvertToUtc(security.Exchange.TimeZone);
return new[]
{
new HistoryRequest(utcStartTime,
utcTime,
configuration.Type,
configuration.Symbol,
historyResolution,
security.Exchange.Hours,
configuration.DataTimeZone,
historyResolution,
extendedMarketHours,
configurations.IsCustomData(),
configuration.DataNormalizationMode,
LeanData.GetCommonTickTypeForCommonDataTypes(configuration.Type, security.Type))
};
}
}
}