Добавлены алиасы и безопасные методы для IirBuilder

В IirSpecificationBuilder реализованы методы-алиасы BuildSpecification, TryGetSpecification, BuildFilter и CreateMany для удобного и безопасного получения спецификаций и экземпляров фильтра. В тестах добавлены проверки новых методов, включая сценарии с некорректной спецификацией. Улучшено удобство API и расширено тестовое покрытие.

Author: Infarh

MathCore.DSP/Filters/Builders/IirBuilder.cs

@@ -198,6 +198,36 @@ public bool TryCreate(out Filter? Filter)
     /// <summary>Выполнить неявное преобразование в фильтр</summary>
     /// <param name="Builder">Построитель фильтра</param>
     public static implicit operator Filter(IirSpecificationBuilder Builder) => Builder.Create();
+
+    /// <summary>Сформировать объект спецификации фильтра</summary>
+    /// <returns>Спецификация фильтра</returns>
+    public IirFilterSpecification BuildSpecification() => GetSpecification();
+
+    /// <summary>Попытаться сформировать объект спецификации фильтра без выброса исключения наружу</summary>
+    /// <param name="Specification">Сформированная спецификация фильтра или null</param>
+    /// <returns>True, если спецификация успешно сформирована</returns>
+    public bool TryGetSpecification(out IirFilterSpecification? Specification)
+    {
+        try
+        {
+            Specification = GetSpecification();
+            return true;
+        }
+        catch (ArgumentException)
+        {
+            Specification = null;
+            return false;
+        }
+        catch (InvalidOperationException)
+        {
+            Specification = null;
+            return false;
+        }
+    }
+
+    /// <summary>Сформировать экземпляр фильтра</summary>
+    /// <returns>Экземпляр IIR-фильтра</returns>
+    public Filter BuildFilter() => Create();
 }
 
 /// <summary>Построитель IIR-фильтров выбранного семейства</summary>
@@ -454,9 +484,52 @@ static double Require(double? Value, string Name)
     /// <returns>Спецификация фильтра</returns>
     public IirFilterSpecification GetSpecification() => ToSpecification().GetSpecification();
 
+    /// <summary>Сформировать объект спецификации фильтра</summary>
+    /// <returns>Спецификация фильтра</returns>
+    public IirFilterSpecification BuildSpecification() => GetSpecification();
+
+    /// <summary>Попытаться сформировать объект спецификации фильтра без выброса исключения наружу</summary>
+    /// <param name="Specification">Сформированная спецификация фильтра или null</param>
+    /// <returns>True, если спецификация успешно сформирована</returns>
+    public bool TryGetSpecification(out IirFilterSpecification? Specification)
+    {
+        try
+        {
+            Specification = GetSpecification();
+            return true;
+        }
+        catch (ArgumentException)
+        {
+            Specification = null;
+            return false;
+        }
+        catch (InvalidOperationException)
+        {
+            Specification = null;
+            return false;
+        }
+    }
+
     /// <summary>Создать фильтр на основе DSL-спецификации</summary>
     /// <returns>Экземпляр IIR-фильтра</returns>
     public Filter Create() => GetSpecification().CreateFilter();
+
+    /// <summary>Сформировать экземпляр фильтра</summary>
+    /// <returns>Экземпляр IIR-фильтра</returns>
+    public Filter BuildFilter() => Create();
+
+    /// <summary>Создать несколько независимых экземпляров фильтра</summary>
+    /// <param name="Count">Количество экземпляров</param>
+    /// <returns>Перечисление экземпляров фильтра</returns>
+    /// <exception cref="ArgumentOutOfRangeException">Количество экземпляров меньше единицы</exception>
+    public IEnumerable<Filter> CreateMany(int Count)
+    {
+        if (Count < 1)
+            throw new ArgumentOutOfRangeException(nameof(Count), Count, "Количество экземпляров должно быть больше нуля");
+
+        for (var i = 0; i < Count; i++)
+            yield return Create();
+    }
 }
 
 /// <summary>Построитель RC-фильтров</summary>

Tests/MathCore.DSP.Tests/Filters/IirFluentBuilderTests.cs

@@ -218,4 +218,45 @@ public void RcBuilderReturnsSpecificationAndBuildsFilter()
         Assert.IsInstanceOfType(specification, typeof(RcHighPassSpecification));
         Assert.IsInstanceOfType(filter, typeof(RCHighPass));
     }
+
+    [TestMethod]
+    public void BuildSpecificationAliasReturnsSpecification()
+    {
+        const double dt = 1d / 5_000;
+
+        var specification = Filter.IIR(dt)
+            .Butterworth
+            .LowPass(500, 1_500)
+            .BuildSpecification();
+
+        Assert.IsInstanceOfType(specification, typeof(ButterworthLowPassSpecification));
+    }
+
+    [TestMethod]
+    public void BuildFilterAliasReturnsFilter()
+    {
+        var filter = Filter.IIR()
+            .WithSamplingFrequency(10_000)
+            .Elliptic
+            .BandPass()
+            .WithPassband(1_000, 2_000)
+            .WithStopband(500, 2_500)
+            .BuildFilter();
+
+        Assert.IsInstanceOfType(filter, typeof(global::MathCore.DSP.Filters.EllipticBandPass));
+    }
+
+    [TestMethod]
+    public void TryGetSpecificationReturnsFalseForIncompleteDsl()
+    {
+        var success = Filter.IIR()
+            .WithSamplingFrequency(10_000)
+            .Butterworth
+            .LowPass()
+            .WithPassband(1_000)
+            .TryGetSpecification(out var specification);
+
+        Assert.IsFalse(success);
+        Assert.IsNull(specification);
+    }
 }