Руководство пользователя

Внимание

В текущей версии библиотеки ФБ работает некорректно. Для корректной работы необходимо отредактировать код ФБ следующим образом:

Функциональный блок ESR_COLLECT используется для сбора данных других ESR-модулей и сохранения их в массив. Входы ESR_0...ESR_7 используются как значения для входов-выходов ESR_Out других ESR-модулей. При обновлении информации ESR-модулей, данные заносятся в массив ESR_COLLECT.ESR_OUT, при этом значение входа-выхода pos инкрементируется. Массив ESR_COLLECT.ESR_OUT может хранить до 32-х элементов типа ESR_DATA. При превышении этого количества начинается перезапись элементов (начиная с нулевого). По переднему фронту на входе rst происходит удаление всех данных модуля, после чего pos принимает значение -1.

Функциональный блок ESR_MON_B8 применяется для мониторинга от одной до восьми переменных типа BOOL (s0...s7). На вход DT_in подается значение системного времени в формате DT (считанного с помощью одной из доступных пользователю библиотек). При изменении значения переменных s0…s7 данные мониторинга сохраняются в массив ESR_Out, элементы которого являются экземплярами структуры типа ESR_DATA. Массив содержит 4 элемента и, соответственно, позволяет хранить данные мониторинга для четырех одновременно изменившихся переменных. Иными словами, при одновременном (произошедшем в одном цикле ПЛК) изменении всех восьми переменных будет сохранена информация только о четырех (приоритет отдается сигналам с меньшим номером). Для ведения архива мониторинга можно использовать ФБ ESR_COLLECT. Выход ESR_flag принимает значение TRUE на один цикл при обновлении данных мониторинга.

Структура ESR_DATA включает следующую информацию:

Функциональный блок ESR_MON_R4 применяется для мониторинга от одной до четырех переменных типа REAL (R0...R3). На вход DT_in подается значение системного времени в формате DT (считанного с помощью одной из доступных пользователю библиотек). При изменении значения переменных R0...R3 на величину s0…s3 или выше данные мониторинга сохраняются в массив ESR_Out, элементы которого являются экземплярами структуры типа ESR_DATA. Массив содержит 4 элемента и, соответственно, позволяет хранить данные о последнем изменении для каждой переменной. Для ведения архива мониторинга можно использовать ФБ ESR_COLLECT. Выход ESR_flag принимает значение TRUE на один цикл при обновлении данных мониторинга.

Структура ESR_DATA включает следующую информацию:

Функциональный блок ESR_MON_X8 применяется для мониторинга от одной до восьми переменных типа BYTE (s0...s7), которые содержат информацию о состоянии других ФБ. Такие переменные обычно называются Status. В качестве примера можно привести выход Status ФБ SEQUENCE_4. На вход DT_in подается значение системного времени в формате DT (считанного с помощью одной из доступных пользователю библиотек). Вход Mode определяет режим работы блока:

• Mode=1 – обрабатываются только сообщения об ошибках;

• Mode=2 – обрабатываются сообщения об ошибках и состоянии ФБ;

• Mode=3 – обрабатываются сообщения об ошибках, состоянии ФБ.

При изменении значения переменных s0...s7 данные мониторинга сохраняются в массив ESR_Out, элементы которого являются экземплярами структуры типа ESR_DATA. Массив содержит 4 элемента и, соответственно, позволяет хранить данные мониторинга для четырех одновременно изменившихся переменных. Иными словами, при одновременном (произошедшем в одном цикле ПЛК) изменении всех восьми переменных будет сохранена информация только о четырех (приоритет отдается сигналам с меньшим номером). Для ведения архива мониторинга можно использовать ФБ ESR_COLLECT. Выход ESR_flag принимает значение TRUE на один цикл при обновлении данных мониторинга.

Структура ESR_DATA включает следующую информацию:

Функция OSCAT_VERSION возвращает версию библиотеки (в формате DWORD) при значении IN=FALSE и дату релиза данной версии (в формате DWORD) при значении IN=TRUE.

Функция STATUS_TO_ESR собирает элемент структуры ESR_DATA из отдельных переменных.

Коды статуса 1...99 соответствуют сообщениям об ошибках, 100…199 – состояниям ФБ, 200…255 – отладочным сообщениям.

Функция ACOSH возвращает значение гиперболического арккосинуса, вычисленное по формуле

Область определения:

Пример

Функция ACOTH возвращает значение гиперболического арккотангенса, вычисленное по формуле

Область определения:

Функция AGDF возвращает значение обратной функции Гудермана, вычисленное по формуле

Текущая реализация функции гарантирует приемлемую точность вычислений только для x, принадлежащих интервалу

Функция ASINH возвращает значение гиперболического арксинуса, вычисленное по формуле

Область определения:

Функция ATAN2 возвращает значение арктангенса для заданных координат X и Y. Арктангенс – это угол между осью X и линией, проведенной из начала координат (0,0) в точку с координатами (X,Y). Угол определяется в радианах в диапазоне

Функция ATANH возвращает значение гиперболического арктангенса, вычисленное по формуле

Область определения:

Функция BETA возвращает значение бета-функции, вычисленное по формуле,

где Г — гамма-функция.

Область определения:

Функция BINOM возвращает значение биномиального коэффициента из N по K, вычисленное по формуле

Функция возвращает корректные значения только для

Функция СAUCHY возвращает значение плотности вероятности для распределения Коши, вычисленное по формуле ,

Функция СAUCHYCD возвращает значение функции распределения Коши, вычисленное по формуле ,

Функция CEIL округляет переменную типа REAL в сторону ближайшего большего целого значения.

Примечание

Функция возвращает значение типа INT, что накладывает соответствующие ограничения на величину входной переменной (диапазон возможных значений для типа INT составляет –32768..32767).

Функция CEIL2 округляет переменную типа REAL в сторону ближайшего большего целого значения. В отличие от функции CEIL, данная функция возвращает значение типа DINT, что увеличивает диапазон возможных значений входной переменной.

Функция CMP сравнивает значения X и Y типа REAL и возвращает TRUE, если их первые N символов совпадают. В противном случае функция возвращает FALSE.

Необходимо отметить, что тип REAL обеспечивает относительную точность в 7-8 десятичных цифр после запятой в заданном диапазоне, поэтому нельзя гарантировать корректную работу функции в 100% случаев.

Функция COSH возвращает значение гиперболического косинуса, вычисленное по формуле

Область определения:

Функция COTH возвращает значение гиперболического котангенса, вычисленное по формуле

Область определения:

Функция D_TRUNC возвращает целую часть переменной типа REAL (обратите внимание, что речь идет не об округлении до ближайшего целочисленного значения). Функция TRUNC() из стандарта МЭК 61131-3 поддерживает тип DINT не во всех средах программирования; более того, даже преобразование REAL_TO_DINT на разных системах может приводить к разному результату. Функция D_TRUNC анализирует работу преобразования и возвращает корректное значение.

Функция DEC1 декрементирует значение переменной X. Если X = 0, то функция возвращает декрементированное значение переменной N.

Функция DEG преобразует значение угла из радиан в градусы. Если входная переменная rad превышает 2π, то из нее будет вычитаться по π до тех пор, пока ее значение не окажется в интервале 0< rad < 2π.

Функция DIFFER возвращает значение TRUE, если значения переменных in1 и in2 отличаются на величину, превышающую X. В противном случае функция возвращает FALSE.

Функция ERF возвращает значение функции ошибок для аргумента X, вычисленное по формуле

, где

Относительная ошибка вычисления не превышает 0.00013.

Функция ERFС возвращает значение дополнительной функции ошибок для аргумента X, вычисленное по формуле

Функция EVEN возвращает TRUE, если значение переменной in является четным, и FALSE — если нечетным.

Функция EXP10 возвращает значение показательной функции с основанием степени 10, вычисленное по формуле

Функция EXPN возвращает значение показательной функции c целочисленным основанием степени, вычисленное по формуле

Функция EXPN разработана специально для ПЛК без FPU (математического сопроцессора) и выполняется приблизительно в 30 раз быстрее функции EXPT, определенной стандартом МЭК 61131-3.

Функция FACT возвращает значение факториала X. Функция возвращает корректные значения при X, принадлежащем интервалу . Во всех остальных случаях функция возвращает -1.

Функция FIB возвращает значение X-го элемента последовательности Фибоначчи. Функция возвращает корректные значения при X, принадлежащему интервалу . Во всех остальных случаях функция возвращает -1.

Функция FLOOR округляет переменную типа REAL в сторону ближайшего меньшего целого значения. Обратите внимание, что функция возвращает значение типа INT, что накладывает соответствующие ограничения на величину входной переменной (диапазон возможных значений для типа INT составляет -32768..32767).

Пример

Функция FLOOR2 округляет переменную типа REAL в сторону ближайшего меньшего целого значения. В отличие от функции FLOOR, данная функция возвращает значение типа DINT, что увеличивает диапазон возможных значений входной переменной.

Пример

Функция FRACT возвращает дробную часть значения с плавающей точкой. Необходимо отметить, что тип REAL обеспечивает относительную точность в 7-8 десятичных цифр после запятой в заданном диапазоне, поэтому нельзя гарантировать корректную работу функции в 100% случаев.

Пример

Функция GAMMA возвращает значение гамма-функции, вычисленное по аппроксимирующей формуле Герго Немеса:

Область определения:

Функция может использоваться для приближенного вычисления факториалов чисел, что будет полезным в тех случаях, когда не может быть использована функция FACT. Следует помнить, что гамма-функция возвращает не факториал X, а факториал его декремента.

Пример

Функция GAUSS возвращает значение плотности вероятности для распределения Гаусса (нормального распределения), вычисленное по формуле

,

Пример

Функция GAUSSCD возвращает значение функции распределения Гаусса (нормального распределения), вычисленное по формуле

,

Пример

Функция GCD возвращает значение наибольшего общего делителя для чисел A и B.

Пример

Функция GDF возвращает значение функции Гудермана, вычисленное по формуле

Область определения:

Пример

Функция GOLD возвращает значение, вычисленное по формуле

При X=1 функция возвращает значение золотого сечения.

Пример

Функция HYPOT возвращает значение длины гипотенузы прямоугольного треугольника, вычисленное по теореме Пифагора

Пример

Функция INC складывает значения X и D, и проверяет результат. Если результат сложения превышает M, то функция возвращает 0. Если результат сложения отрицателен, то функция возвращает M. Во всех остальных случаях функция возвращает сумму X и D. Функция может быть полезной при работе с массивами и буферами, а также абсолютными энкодерами.

Пример

Функция INC1 инкрементирует значение переменной X до N-1, после чего на выход подается 0, и продолжается циклический инкремент.

Пример

Функция INC2складывает значения X и D, и проверяет результат. Если результат сложения превышает U, то функция возвращает L. Если результат сложения меньше L, то функция возвращает U. Во всех остальных случаях функция возвращает сумму X и D. Функция может оказаться полезной при работе с массивами и буферами, а также абсолютными энкодерами.

Пример

Функция INV возвращает обратное число для X.

Пример

Функция LAMBERT_W возвращает значение W-функции Ламберта, вычисленное по аппроксимационной формуле

Относительная точность вычисления по данной формуле превышает 10%.

Пример

Функция LANGEVIN возвращает значение функции Ланжевена, вычисленное по формуле

Пример

Функция MAX3 возвращает наибольшее из трех сравниваемых значений. Согласно стандарту МЭК 61131-3 оператор MAX() должен иметь настраиваемое число входов, но в некоторых средах разработки их число ограничено двумя – по этой причине в библиотеку OSCAT включена функция MAX3.

Пример

Функция MID3 возвращает среднее (но не усредненное) из трех сравниваемых значений.

Пример

Функция MIN3 возвращает наименьшее из трех сравниваемых значений. Согласно стандарту МЭК 61131-3 оператор MIN() должен иметь настраиваемое число входов, но в некоторых средах разработки их число ограничено двумя – по этой причине в библиотеку включена функция MIN3.

Пример

Функция MODR возвращает остаток от деления значения IN на значение DIVI. В отличие от стандартного оператора MOD(), в качестве аргументов используются переменные типа REAL. При DIVI=0 функция возвращает 0.

Пример

Функция MUL_ADD возвращает значение линейной функции с коэффициентом K и сдвигом O для аргумента X.

Пример

Функция NEGX возвращает значение аргумента с противоположным знаком.

Пример

Функция RAD преобразует значение угла в градусах в радианы. Если входная переменная DEGпревышает 2 π, то из нее будет вычитаться по π до тех пор, пока ее значение не окажется в интервале .

Пример

Функция RDM используется для генерации псевдослучайных чисел с плавающей точкой в диапазоне [0,1). В качестве источника энтропии используется системный таймер ПЛК. Поскольку модуль RDM представляет собой функцию, а не ФБ, он не содержит информацию о своем предыдущем вызове, и поэтому должен использоваться с осторожностью. Если функция вызывается более одного раза в течение цикла, то возвращает одинаковые числа, т.к. значение системного таймера остается тем же. Этого можно избежать, вызывая функцию с разным значением зерна last. В качестве зерна можно использовать значение функции, возвращенное при предыдущем вызове.

Пример

Функция RDM2 используется для генерации псевдослучайных целых чисел в диапазоне [low,high]. В качестве источника энтропии используется системный таймер ПЛК. Поскольку модуль RDM2 представляет собой функцию, а не ФБ, он не содержит информацию о своем предыдущем вызове, и поэтому должен использоваться с осторожностью. Если функция вызывается более одного раза в течение цикла, то возвращает одинаковые числа, т.к. значение системного таймера остается тем же. Этого можно избежать, вызывая функцию с разным значением зерна last. В качестве зерна можно использовать значение функции, возвращенное при предыдущем вызове.

Пример

Функция RDMDW используется для генерации псевдослучайных 32-битных наборов бит. В качестве источника энтропии используется системный таймер ПЛК. Поскольку модуль RDMDW представляет собой функцию, а не ФБ, он не содержит информацию о своем предыдущем вызове, и поэтому должен использоваться с осторожностью. Если функция вызывается более одного раза в течение цикла, то возвращает одинаковые числа, т.к. значение системного таймера остается тем же. Этого можно избежать, вызывая функцию с разным значением зерна last. В качестве зерна можно использовать значение функции, возвращенное при предыдущем вызове.

Пример

Функция REAL_TO_FRAC представляет значение переменной X типа REAL в виде дроби, знаменатель которой не превышает N. Возвращаемое значение представляет собой структуру типа FRACTION.

Пример

Функция RND возвращает число с плавающей точкой X, округленное до N значащих цифр. Для чисел 0-4 округление выполняется в меньшую сторону, для 5-9 – в большую. Для округления до заданного количества десятичных знаков может использоваться функция ROUND.

Пример

Функция ROUND возвращает число с плавающей точкой X, округленное до N знаков после запятой. Для чисел 0-4 округление выполняется в меньшую сторону, для 5-9 – в большую. Для округления до заданного количества значащих цифр может использоваться функция RND.

Пример

Функция SGN возвращает код знака переменной X.

Пример

Функция SIGMOID возвращает значение сигмоиды, вычисленное по формуле

Пример

Функция SIGN_I возвращает TRUE, если значение переменной in типа DINT является отрицательным, и FALSE – если положительным.

Пример

Функция SIGN_R возвращает TRUE, если значение переменной in типа REAL является отрицательным, и FALSE – если положительным.

Пример

Функция SINC возвращает значение ненормированной функции кардинального синуса, вычисленное по формуле

Пример

Функция SINH возвращает значение гиперболического синуса, вычисленное по формуле

Область определения:

Пример

Функция SQRTN возвращает значение корня N-й степени из X.

Пример

Функция TANC возвращает значение одноименной математической функции, вычисленное по формуле

Пример

Функция TANH возвращает значение гиперболического тангенса, вычисленное по формуле

Область определения:

Пример

Функция WINDOW возвращает TRUE, если значение X принадлежит интервалу (low, high). В противном случае функция возвращает FALSE.

Пример

Функция WINDOW2 возвращает TRUE, если значение X принадлежит интервалу [low, high]. В противном случае функция возвращает FALSE.

Пример

Функция _ARRAY_ABS вычисляет модули элементов входного массива. Результаты записываются в тот же массив по указателю. После окончания обработки выход функции принимает значение TRUE.

Пример: массив [-2, 12, -4, 8, 6] после обработки функцией примет вид [2, 12, 4, 8, 6].

Функция _ARRAY_ADD увеличивает значение каждого из элементов входного массива на заданное значение X. Результаты записываются в тот же массив по указателю. После окончания обработки выход функции принимает значение TRUE.

Пример: массив [-2, 12, -4, 8, 6] при X=10 после однократной обработки функцией примет вид [8, 22, 6, 18, 16].

Функция _ARRAY_INIT присваивает каждому из элементов входного массива заданное значение init. Результаты записываются в тот же массив по указателю. После окончания обработки выход функции принимает значение TRUE.

Пример: массив [-2, 12, -4, 8, 6] при init=0 после обработки функцией примет вид [0, 0, 0, 0, 0].

Функция _ARRAY_MEDIAN возвращает медиану массива, а также сортирует его по возрастанию.

Пример: массив [-2, 12, -4, 8, 6] после обработки функцией примет вид [-4, -2, 6, 8, 12].

Функция _ARRAY_MUL умножает значение каждого из элементов входного массива на заданное значение X. Результаты записываются в тот же массив по указателю. После окончания обработки выход функции принимает значение TRUE.

Пример: массив [-2, 12, -4, 8, 6] при X=3 после однократной обработки функцией примет вид [-6, 36, -12, 24, 18].

Функция _ARRAY_SHUFFLE переставляет элементы входного массива местами в случайном порядке. Результаты записываются в тот же массив по указателю. После окончания обработки выход функции принимает значение TRUE.

Пример

Функция _ARRAY_SORT сортирует входной массив, располагая его элементы в порядке возрастания. Результаты записываются в тот же массив по указателю. После окончания обработки выход функции принимает значение TRUE.

Пример: массив [-2, 12, -4, 8, 6] после обработки функцией примет вид [-4, -2, 6, 8, 12].

Функция ARRAY_AVG возвращает среднее арифметическое входного массива. Функция не изменяет содержимое входное массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 4.

Функция ARRAY_GAV возвращает среднее геометрическое входного массива. Функция не изменяет содержимое входного массива.

Пример: для массива [2, 12, 4, 8, 6] функция вернет значение 5.40383959.

Функция ARRAY_HAV возвращает среднее гармоническое массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение -13.333334.

Функция ARRAY_MAX возвращает значение наибольшего элемента входного массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 12.

Функция ARRAY_MIN возвращает значение наименьшего элемента входного массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение -4.

Функция ARRAY_SDV возвращает среднеквадратичное отклонение для входного массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 6.78233.

Функция ARRAY_SPR возвращает абсолютное отклонение для входного массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 16 (полученное следующим образом: 12 - (-4)).

Функция ARRAY_SUM возвращает сумму элементов входного массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 20.

Функция ARRAY_TREND возвращает значение тренда входного массива. Тренд представляет собой разность между средними значениями второй и первой половин массива. Если количество элементов в массиве является нечетным, то «центральный» элемент включается в обе половины. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 1.33333337.

Функция ARRAY_VAR возвращает значение дисперсии входного массива. Функция не изменяет содержимое массива.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет значение 46.

Функция IS_SORTED проверяет, отсортированы ли элементы входного массива по возрастанию. Функция возвращает TRUE, если массив отсортирован; во всех остальных случаях функция возвращает FALSE.

Пример: для массива [-2, 12, -4, 8, 6] функция вернет FALSE.

Функция CABS возвращает модуль комплексного числа X, вычисленный по формуле

Пример

Функция CACOS возвращает арккосинус комплексного числа X. Действительная часть полученного результата принадлежит интервалу [0, π], мнимая принадлежит интервалу [- Ꝏ,Ꝏ].

Пример

Функция CACOSH возвращает гиперболический арккосинус комплексного числа X. Мнимая часть полученного результата принадлежит интервалу [- π, π].

Пример

Функция CADD возвращает сумму комплексных чисел X и Y.

Пример

Функция CARG возвращает значение угла (в радианах) между осью действительных чисел и радиус-вектором геометрического представления комплексного числа X.

Пример

Функция CASIN возвращает арксинус комплексного числа X. Мнимая часть полученного результата принадлежит интервалу .

Пример

Функция CASINH возвращает гиперболический арксинус комплексного числа X. Мнимая часть полученного результата принадлежит интервалу [- π, π].

Пример

Функция CATAN возвращает арктангенс комплексного числа X. Мнимая часть полученного результата принадлежит интервалу .

Пример

Функция CATANH возвращает гиперболический арктангенс комплексного числа X. Мнимая часть полученного результата принадлежит интервалу .

Пример

Функция CCON возвращает сопряженное число для комплексного числа X.