commtest. ErrorRate

Создайте тестовую консоль коэффициента ошибок

Синтаксис

h = commtest.ErrorRate
h = commtest.ErrorRate(sys)
h = commtest.ErrorRate(sys,'PropertyName',PropertyValue,...)
h = commtest.ErrorRate('PropertyName',PropertyValue,...)

Описание

h = commtest.ErrorRate возвращает тестовую консоль коэффициента ошибок, h. Тестовая консоль коэффициента ошибок запускает симуляции системы под тестом, чтобы получить коэффициенты ошибок.

h = commtest.ErrorRate(sys) возвращает тестовую консоль коэффициента ошибок, тестовую консоль коэффициента ошибок, h, с каждым заданным набором свойств к h, с присоединенной системой под тестом, SYS.

h = commtest.ErrorRate(sys,'PropertyName',PropertyValue,...) возвращает тестовую консоль коэффициента ошибок, h, с присоединенной системой под тестом, sys. Каждое заданное свойство, 'PropertyName', установлено в заданное значение, PropertyValue.

h = commtest.ErrorRate('PropertyName',PropertyValue,...) возвращает тестовую консоль коэффициента ошибок, h, с каждым заданным свойством 'PropertyName', набором к заданному значению, PropertyValue.

Свойства

Тестовый консольный объект коэффициента ошибок имеет свойства в следующей таблице. Установка любого свойства сбрасывает объект. Свойство, которое является irrelevant, является тем, которое можно установить, но его значение не влияет на измерения. Точно так же вы не можете отобразить несоответствующие свойства с помощью метода disp. Можно записать во все свойства, за исключением тех явным образом отмеченных в противном случае.

СвойствоОписание
Описание'Тестовая консоль коэффициента ошибок'. Только для чтения.
SystemUnderTestNameСистема под тестовым именем. Только для чтения.
FrameLength

Задайте длину кадра передачи в каждой итерации. Это свойство становится релевантным только, когда система под тестом указывает допустимое тестовое воздействие.

  • Если система под тестом указывает тестовое воздействие NumTransmissions и вызывает его метод getInput, тестовая консоль коэффициента ошибок возвращает значение, сохраненное в FrameLength. Используя внутренний источник данных, система под тестом использует это значение, чтобы сгенерировать кадр передачи заданной длины.

  • Если система под тестом указывает тестовое воздействие DiscreteRandomSource и вызывает его метод getInput, тестовая консоль генерирует и возвращает кадр символов. Длина кадра символов совпадает со свойством FrameLength. Это свойство значения по умолчанию к 500.

IterationMode

Задайте, как объект определяет точки симуляции.

  • Если установлено в Combinatorial, объект выполняет симуляции для всех возможных комбинаций зарегистрированных тестовых значений развертки параметра.

  • Если установлено в Indexed, объект выполняет симуляции для всех индексируемых наборов значений развертки. Набор значений развертки th i состоит из элемента th i каждого вектора значения развертки для каждого зарегистрированного тестового параметра. Все векторы значения развертки должны иметь равную длину, за исключением значений, которые являются единичной длиной.

Обратите внимание на то, что для следующих установок параметров развертки:

  • Parameter1 = [a1 a2]

  • Parameter2 = [b1 b2]

  • Parameter3 = [c1]

В Индексируемом Режиме тестовая консоль выполняет симуляции для следующих наборов параметра развертки:

(a1, b1, c1)

(a2, b2, c1)

В Комбинаторном Режиме тестовая консоль выполняет симуляции для следующих наборов параметра развертки:

(a1, b1, c1)

(a1, b2, c1)

(a2, b1, c1)

(a2, b2, c1)

SystemResetMode

Задайте этап симуляции, запущенной, в котором система сбрасывает.

  • Установка на Reset at new simulation point сбрасывает систему под тестом в начале новой точки симуляции.

  • Установка на Reset at every iteration сбрасывает систему под тестом в каждой итерации.

SimulationLimitOption

Задайте, как остановить симуляцию для каждой точки параметра развертки.

  • Если установлено в Number of transmissions симуляция для параметра развертки указывает остановки, когда количество передач равняется значению для MaxNumTransmissions.

    • Установите TransmissionCountTestPoint на имя зарегистрированной тестовой точки, содержащей количество передачи, которое вы по сравнению с MaxNumTransmissions.

  • Если установлено в Number of errors симуляция для параметра развертки указывает остановки, когда количество ошибок равняется значению для MinNumErrors.

    • Установите ErrorCountTestPoint на имя зарегистрированной тестовой точки, содержащей ошибочное количество, которое вы по сравнению с MinNumErrors.

  • Установка на Number of errors or transmissions останавливает симуляцию для точки параметра развертки при удовлетворении одному из двух условий.

    • Симуляция останавливается, когда количество передач равняется значению для MaxNumTransmissions.

    • Симуляция останавливается при получении количества ошибок, совпадающих с NumErrors.

  • Установка этого свойства к Number of errors and transmissions останавливает симуляцию для точки параметра развертки при отвечании следующему условию.

    • Симуляция останавливается, когда количество передач и ошибок номера, по крайней мере, достигло значений в MinNumTransmissions и MinNumErrors.

Установите TransmissionCountTestPoint на имя зарегистрированной тестовой точки, которая содержит количество передачи, которое вы по сравнению со свойством MaxNumTransmissions.

Чтобы управлять продолжительностью симуляции, установите ErrorCountTestPoint на имя зарегистрированной тестовой точки, содержащей ошибочное количество, которое вы по сравнению с MinNumErrors.

Вызовите метод info тестовой консоли коэффициента ошибок, чтобы видеть допустимые зарегистрированные имена тестовой точки.

MaxNumTransmissions

Задайте максимальное количество передач числа объектов прежде, чем остановить симуляцию для точки параметра развертки. Это свойство становится релевантным только, когда SimulationLimitOption является Number of transmissions или Number of errors or transmissions.

  • Когда установка SimulationLimitOption к Number of transmissions симуляция для каждой точки параметра развертки остановки при достижении количества передач MaxNumTransmissions задает.

  • Установка SimulationLimitOption к Number of errors or transmissions останавливает симуляцию для каждой точки параметра развертки для одного из двух условий.

    • Остановки симуляции при завершении количества передач MaxNumTransmissions задают.

    • Остановки симуляции при получении количества ошибок MinNumErrors задают.

Свойство TransmissionCountTestPoint предоставляет имя зарегистрированной тестовой точки, содержащей тип передачи количества. Вызов метода info тестовой консоли коэффициента ошибок отображает допустимые зарегистрированные тестовые точки. Если это свойство содержит указанные тестовые точки, тестовые консольные итерации выполнений, равные значению для MaxNumTransmissions для каждой точки параметра развертки. Если это свойство не имеет никаких зарегистрированных тестовых параметров, тестовая консоль запускает количество итераций, равных значению для MaxNumTransmissions и остановок. Значения по умолчанию значения к 1 000.

MinNumErrors

Задайте минимальное количество ошибок числа объектов прежде, чем остановить симуляцию для точки параметра развертки. Это свойство становится релевантным только при установке SimulationLimitOption на Number of errors или Number of errors or transmissions.

  • Когда установка SimulationLimitOption к Number of errors, который симуляция для каждого параметра указывает остановкам при достижении количества ошибок, которые вы задаете для свойства MinNumErrors.

  • Когда установка свойства SimulationLimitOption к Number of errors or transmissions симуляция для каждого параметра развертки указывает остановки для одного из двух условий.

    • Симуляция останавливается при достижении количества ошибок, которые вы задаете для свойства MaxNumTransmissions.

    • Симуляция останавливается при достижении количества ошибок, которые вы задаете для свойства MinNumErrors.

Задайте тип ошибок ошибочное использование количества путем установки свойства ErrorCountTestPoint на имя зарегистрированной тестовой точки, содержащей количество. Вызовите метод info тестовой консоли коэффициента ошибок, чтобы видеть допустимые зарегистрированные имена тестовой точки. Это значение значения по умолчанию к 100.

TransmissionCountTestPoint

Задайте и укажите тестовую точку, содержащую количество передачи, которое управляет тестовым консольным механизмом остановки симуляции. Это свойство становится релевантным только когда установка SimulationLimitOption к Number of transmissions, Number of errors or transmissions или Number of errors and transmissions. В этом сценарии, если вы указываете тестовую точку, и TransmissionCountTestPoint равняется Not set, значение этого свойства автоматически обновляет к тому из зарегистрированного имени тестовой точки. Вызовите метод info, чтобы видеть допустимые имена тестовой точки.

ErrorCountTestPoint

Задайте и укажите имя тестовой точки, содержащей ошибочное количество, которое управляет механизмом остановки симуляции. Это свойство только релевантно при установке свойства SimulationLimitOption на Number of errors, Number of errors or transmissions или Number of errors and transmissions. В этом сценарии, если вы указываете тестовую точку, и ErrorCountTestPoint равняется Not set, значение этого свойства автоматически обновляет к тому из зарегистрированного имени тестовой точки. Вызовите метод info, чтобы видеть допустимые имена тестовой точки.

Методы

Тестовый консольный объект коэффициента ошибок имеет следующие методы:

запущенный

Запускает симуляцию.

Запускает количество симуляций коэффициента ошибок, которые вы задаете для системы под тестом с заданным набором значений параметров. Если лицензия Parallel Computing Toolbox™ доступна, и parpool открыт, то объект распределяет итерации среди количества доступных рабочих.

getResults

Возвращает результаты симуляции.

r = getResults (h) возвращает результаты симуляции, r, для тестовой консоли, h. r является объектом типа, вы задаете использование testconsole. Результаты. Это содержит данные моделирования для всех зарегистрированных тестовых точек и методов, чтобы проанализировать данные и построить его.

информация

Возвращает отчет текущих тестовых консольных настроек.

информация (h) отображает текущие тестовые консольные настройки, такие как указанные тестовые параметры и указанные тестовые точки.

сброс

Сбрасывает тестовую консоль коэффициента ошибок.

сбросьте (h) тестовые параметры сброса и протестируйте зонды и затем очистите все результаты симуляции тестовой консоли, h.

attachSystem

Присоединяет систему, чтобы протестировать консоль.

attachSystem (ho, sys) присоединяет допустимую пользовательскую систему, sys, к тестовой консоли, h.

detachSystem

Отсоединяет систему от тестовой консоли.

detachSystem (h) отсоединяет систему от тестовой консоли, h. Этот метод также очищает зарегистрированные тестовые воздействия, тестовые параметры, тестовые зонды и тестовые точки.

setTestParameterSweepValues

Устанавливает тестовые значения развертки параметра.

setTestParameterSweepValues (h, имя, развертка) задает набор значений развертки, 'развертки', для зарегистрированного тестового параметра, 'имени', в тестовой консоли, h. Вы только задаете значения развертки для зарегистрированных тестовых параметров. развертка должна иметь значения в заданной области значений тестового параметра. Это может быть вектор - строка из числовых значений или массив ячеек символьных значений. Отобразите допустимые области значений с помощью getTestParameterValidRanges метода.

setTestParameterSweepValues (h, name1, sweep1, name2, sweep2...) одновременно задает значения развертки для нескольких зарегистрированных тестовых параметров.

getTestParameterSweepValues

Возвращает тестовые значения развертки параметра.

getTestParameterSweepValues (h, имя) получает значения развертки, в настоящее время заданные для зарегистрированного тестового параметра, имени, в тестовой консоли, h.

getTestParameterValidRanges

Возвращает тестовый параметр допустимые области значений.

getTestParameterValidRanges (h, имя) получает допустимые области значений для зарегистрированного тестового параметра, имени, в тестовой консоли, h.

registerTestPoint

Указывает тестовую точку.

registerTestPoint (h, имя, actprobe, expprobe) указывает новый объект тестовой точки, имя, к тестовой консоли коэффициента ошибок, h. Тестовая точка должна содержать пару зарегистрированных тестовых зондов, actprobe, и expprobe. actprobe содержит фактические данные, и expprobe содержит ожидаемые данные. Объект сравнивает данные из этих зондов и получает значения коэффициента ошибок. Вычисление коэффициента ошибок использует функцию калькулятора коэффициента ошибок по умолчанию, которая просто выполняет непосредственные сравнения векторов данных, доступных в зондах.

registerTestPoint (h, имя, actprobe, expprobe, указатель) добавляет указатель, указатель, к пользовательской ошибочной функции вычисления, которая сравнивает данные в зондах и затем получает результаты коэффициента ошибок.

Пользовательская ошибочная функция вычисления должна выполнить следующий синтаксис: [ecnt tcnt] = functionName (действие, exp, udata), где

  • ecnt вывод соответствует ошибочному количеству

  • tcnt вывод является количеством передач, раньше получал ошибочное количество

  • действуйте и exp соответствуют фактическим и ожидаемым данным

Тестовая консоль коэффициента ошибок устанавливает входные параметры на доступные данные в паре зондов тестовой точки, actprobe, и expprobe.

udata является вводом данных, который система под тестом передает тестовой консоли во время выполнения, с помощью setUserData метода. udata содержит данные, необходимые, чтобы вычислить ошибки, такие как задержки и буферы данных.

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

unregisterTestPoint

Не укажите тестовую точку.

unregisterTestPoint (h, имя) удаляет тестовую точку, имя, от тестовой консоли, h.

Примеры

% Obtain bit error rate and  symbol error rate of an M-PSK system
% for different modulation orders and EbNo values. 
  
% Instantiate an ErrorRate test console. The default error rate
% test console has an M-PSK system attached. 
       h = commtest.ErrorRate; 
  
% Set sweep values for simulation test parameters
setTestParameterSweepValues(h,'M',2.^[1 2 3 4])
setTestParameterSweepValues(h,'EbNo',(-5:5))
    
% Register test points 
registerTestPoint(h,'SymbolErrorRate','TxInputSymbols',...,
'RxOutputSymbols')
registerTestPoint(h,'BitErrorRate','TxInputBits','RxOutputBits')
       
% Set simulation stop criteria.
h.TransmissionCountTestPoint = 'SymbolErrorRate';
 
% Get information about the simulation settings
info(h)
 
% Run the MPSK simulations 
run(h)
  
% Get the results
R = getResults(h);
       
% Plot EbNo versus bit error rate for different values of modulation
% order M
R.TestParameter2 = 'M';
plot(R)
Этот пример генерирует фигуру, подобную следующему:

Представленный в R2009b