Create Параметризация.md

Author: Stivo182

docs/Параметризация.md

@@ -0,0 +1,100 @@
+# Параметризация
+
+С помощью аннотации `&Параметры` можно задать параметры для полей класса и методов бенчмарков.
+
+**API**
+
+```bsl
+// Поле класса
+Конфигурация.ДобавитьПараметр("ИмяПоля", 100);
+```
+
+```bsl
+// Параметры метода бенчмарка
+Параметры = Новый Массив();
+Параметры.Добавить(100);
+Параметры.Добавить(Ложь);
+ДескрипторБенчмарка.ДобавитьПараметры(Параметры);
+```
+
+### Пример
+
+```bsl
+&Параметры(5, 0)
+Перем ДобавляемаяЗадержка Экспорт; // Число
+
+&Бенчмарк
+&Параметры(100, 10)
+&Параметры(100, 20)
+&Параметры(200, 10)
+&Параметры(200, 20)
+Процедура Бенчмарк(Задержка1, Задержка2) Экспорт
+	Приостановить(Задержка1 + Задержка2 + ДобавляемаяЗадержка);
+КонецПроцедуры
+```
+
+### Вывод
+
+```md
+// Бенчмарк: МойКласс.Бенчмарк
+// Параметры: ДобавляемаяЗадержка=5, Задержка1=100, Задержка2=10
+
+Оценка     1 : 4 op, 464.1 ms, 116.0 ms/op
+Оценка     2 : 4 op, 463.9 ms, 116.0 ms/op
+
+Прогрев    1 : 4 op, 463.3 ms, 115.8 ms/op
+Прогрев    2 : 4 op, 463.8 ms, 116.0 ms/op
+Прогрев    3 : 4 op, 463.7 ms, 115.9 ms/op
+Прогрев    4 : 4 op, 463.1 ms, 115.8 ms/op
+Прогрев    5 : 4 op, 463.8 ms, 115.9 ms/op
+Прогрев    6 : 4 op, 463.6 ms, 115.9 ms/op
+
+Измерение  1 : 4 op, 464.1 ms, 116.0 ms/op
+Измерение  2 : 4 op, 463.5 ms, 115.9 ms/op
+Измерение  3 : 4 op, 463.0 ms, 115.8 ms/op
+Измерение  4 : 4 op, 463.7 ms, 115.9 ms/op
+Измерение  5 : 4 op, 463.3 ms, 115.8 ms/op
+Измерение  6 : 4 op, 462.9 ms, 115.7 ms/op
+Измерение  7 : 4 op, 463.8 ms, 115.9 ms/op
+Измерение  8 : 4 op, 463.4 ms, 115.9 ms/op
+Измерение  9 : 4 op, 464.1 ms, 116.0 ms/op
+Измерение  10: 4 op, 463.7 ms, 115.9 ms/op
+Измерение  11: 4 op, 463.7 ms, 115.9 ms/op
+Измерение  12: 4 op, 464.0 ms, 116.0 ms/op
+Измерение  13: 4 op, 463.6 ms, 115.9 ms/op
+Измерение  14: 4 op, 463.1 ms, 115.8 ms/op
+Измерение  15: 4 op, 463.8 ms, 116.0 ms/op
+
+// Бенчмарк: МойКласс.Бенчмарк
+// Параметры: ДобавляемаяЗадержка=0, Задержка1=100, Задержка2=10
+
+...
+
+// Сводка
+
+BenchmarkOneScript v0.1.0, OneScript v2.0.0.567-rc7-29039316, Microsoft Windows NT 10.0.20348.0 \
+Intel Core i7-8700 CPU 3.20GHz (Max: 3.19GHz) (Coffee Lake), 1 CPU, 12 logical and 6 physical cores
+
+| Method   | ДобавляемаяЗадержка | Задержка1 | Задержка2 |     Mean |   StdErr |   StdDev |   Median |  Op/s |
+|----------|--------------------:|----------:|----------:|---------:|---------:|---------:|---------:|------:|
+| Бенчмарк |                   0 |       100 |        10 | 110.9 ms | 5.608 us | 21.72 us | 110.9 ms | 9.018 |
+| Бенчмарк |                   0 |       100 |        20 | 120.9 ms | 6.286 us | 24.35 us | 120.9 ms | 8.272 |
+| Бенчмарк |                   0 |       200 |        10 | 210.8 ms | 9.394 us | 36.38 us | 210.8 ms | 4.743 |
+| Бенчмарк |                   0 |       200 |        20 | 220.9 ms | 5.035 us | 19.50 us | 220.9 ms | 4.526 |
+| Бенчмарк |                   5 |       100 |        10 | 115.9 ms | 6.362 us | 24.64 us | 115.9 ms | 8.628 |
+| Бенчмарк |                   5 |       100 |        20 | 126.0 ms | 4.250 us | 16.46 us | 126.0 ms | 7.939 |
+| Бенчмарк |                   5 |       200 |        10 | 215.9 ms | 8.525 us | 33.02 us | 215.9 ms | 4.632 |
+| Бенчмарк |                   5 |       200 |        20 | 225.9 ms | 5.786 us | 22.41 us | 225.9 ms | 4.427 |
+
+// Легенда
+ДобавляемаяЗадержка : Значение параметра 'ДобавляемаяЗадержка'
+Задержка1           : Значение параметра 'Задержка1'
+Задержка2           : Значение параметра 'Задержка2'
+Mean                : Арифметическое среднее всех измерений
+StdErr              : Стандартная ошибка всех измерений
+StdDev              : Стандартное отклонение всех измерений
+Median              : Значение, разделяющее упорядоченные измерения на две равные части
+Op/s                : Операций в секунду
+1 ms                : 1 Миллисекунда
+1 us                : 1 Микросекунда
+```