chore: import upstream snapshot with attribution

2026-07-13 13:02:50 +08:00
commit 0fc60fdcb1
5008 changed files with 910633 additions and 0 deletions
@@ -0,0 +1,110 @@
+/*
+ * 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.Collections.Generic;
+
+namespace QuantConnect.Indicators.CandlestickPatterns
+{
+    /// <summary>
+    /// Candle settings for all candlestick patterns
+    /// </summary>
+    public static class CandleSettings
+    {
+        /// <summary>
+        /// Default settings for all candle setting types
+        /// </summary>
+        private static readonly Dictionary<CandleSettingType, CandleSetting> DefaultSettings = new Dictionary<CandleSettingType, CandleSetting>
+        {
+            { CandleSettingType.BodyLong, new CandleSetting(CandleRangeType.RealBody, 10, 1m) },
+            { CandleSettingType.BodyVeryLong, new CandleSetting(CandleRangeType.RealBody, 10, 3m) },
+            { CandleSettingType.BodyShort, new CandleSetting(CandleRangeType.RealBody, 10, 1m) },
+            { CandleSettingType.BodyDoji, new CandleSetting(CandleRangeType.HighLow, 10, 0.1m) },
+            { CandleSettingType.ShadowLong, new CandleSetting(CandleRangeType.RealBody, 0, 1m) },
+            { CandleSettingType.ShadowVeryLong, new CandleSetting(CandleRangeType.RealBody, 0, 2m) },
+            { CandleSettingType.ShadowShort, new CandleSetting(CandleRangeType.Shadows, 10, 1m) },
+            { CandleSettingType.ShadowVeryShort, new CandleSetting(CandleRangeType.HighLow, 10, 0.1m) },
+            { CandleSettingType.Near, new CandleSetting(CandleRangeType.HighLow, 5, 0.2m) },
+            { CandleSettingType.Far, new CandleSetting(CandleRangeType.HighLow, 5, 0.6m) },
+            { CandleSettingType.Equal, new CandleSetting(CandleRangeType.HighLow, 5, 0.05m) }
+        };
+
+        /// <summary>
+        /// Returns the candle setting for the requested type
+        /// </summary>
+        /// <param name="type">The candle setting type</param>
+        public static CandleSetting Get(CandleSettingType type)
+        {
+            CandleSetting setting;
+            DefaultSettings.TryGetValue(type, out setting);
+            return setting;
+        }
+
+        /// <summary>
+        /// Changes the default candle setting for the requested type
+        /// </summary>
+        /// <param name="type">The candle setting type</param>
+        /// <param name="setting">The candle setting</param>
+        public static void Set(CandleSettingType type, CandleSetting setting)
+        {
+            DefaultSettings[type] = setting;
+        }
+    }
+
+    /// <summary>
+    /// Represents a candle setting
+    /// </summary>
+    public class CandleSetting
+    {
+        /// <summary>
+        /// The candle range type
+        /// </summary>
+        public CandleRangeType RangeType
+        {
+            get;
+            private set;
+        }
+
+        /// <summary>
+        /// The number of previous candles to average
+        /// </summary>
+        public int AveragePeriod
+        {
+            get;
+            private set;
+        }
+
+        /// <summary>
+        /// A multiplier to calculate candle ranges
+        /// </summary>
+        public decimal Factor
+        {
+            get;
+            private set;
+        }
+
+        /// <summary>
+        /// Creates an instance of the <see cref="CandleSetting"/> class
+        /// </summary>
+        /// <param name="rangeType">The range type</param>
+        /// <param name="averagePeriod">The average period</param>
+        /// <param name="factor">The factor</param>
+        public CandleSetting(CandleRangeType rangeType, int averagePeriod, decimal factor)
+        {
+            RangeType = rangeType;
+            AveragePeriod = averagePeriod;
+            Factor = factor;
+        }
+    }
+}