/* * 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)) }; } } }