exponenta event banner

dspdata

Информация о параметрах данных DSP

Синтаксис

Hs = dspdata.dataobj(input1,...)

Описание

Примечание

Использование dspdata.dataobj не рекомендуется. Вместо этого используйте соответствующий функциональный интерфейс.

Hs = dspdata.dataobj(input1,...) возвращает dspdata объект Hs типа dataobj. Этот объект содержит всю информацию о параметрах, необходимую для указанного типа dataobj. Каждый dataobj принимает один или несколько входных данных, которые описаны на отдельных страницах ссылок. Если входные значения не указаны, возвращаемый объект имеет значения свойств по умолчанию, соответствующие конкретному dataobj тип.

Примечание

Необходимо использовать dataobj с dspdata.

Объекты данных

Объект данных, dataobj, для dspdata указывает тип данных, хранящихся в объекте. Доступный dataobj типы для dspdata показаны ниже.

dspdata.dataobj

Описание

Соответствующие функции

dspdata.msspectrum

Среднеквадратические данные спектра (мощность)

periodogram

pwelch

dspdata.psd

Данные спектральной плотности мощности (мощность/частота)

pburg

pcov

periodogram

pmcov

pmtm

pwelch

pyulear

dspdata.pseudospectrum

Данные псевдоспектра (мощность)

peig

pmusic

Для получения дополнительной информации о каждом dataobj введите, используйте синтаксис help dspdata.dataobj в подсказке MATLAB ® или обратитесь к его справочной странице.

Методы

Методы обеспечивают способы выполнения функций непосредственно на вашем dspdata объект. Эти методы можно применять непосредственно к переменной, назначенной dspdata объект.

Метод

Описание

avgpower

Этот метод применяется только к dspdata.psd объекты.

avgpower(Hs) вычисляет среднюю мощность сигнала, Hs, в данной полосе частот. Методика использует прямоугольное приближение интеграла спектральной плотности мощности сигнала (PSD). Если сигнал является матрицей, вычисление выполняется для каждого столбца. Средняя мощность - это общая мощность сигнала. SpectrumType определяет, содержится ли общая средняя мощность в одностороннем или двустороннем спектре. Для одностороннего спектра диапазон равен [0, pi], если число частотных точек четное, и [0, pi), если он нечетный. Для двустороннего спектра диапазон равен [0,2pi).

avgpower(Hs,freqrange) задает диапазон частот, по которому вычисляется средняя мощность. freqrange - двухэлементный вектор, содержащий нижнюю и верхнюю границы частотного диапазона. Если значение частоты не совпадает точно с частотой в Hs, используется следующее ближайшее значение. Первое значение частоты в freqrange включается в расчет, и второе значение исключается.

centerdc

centerdc(Hs) или centerdc(Hs,true) сдвигает значения данных и частоты таким образом, что компонент постоянного тока находится в центре спектра. Если SpectrumType свойство - 'onesided', он изменяется на 'twosided' и затем компонент постоянного тока центрируется.

centerdc(Hs,'false') сдвигает значения данных и частоты таким образом, что компонент постоянного тока находится на левом краю спектра.

findpeaks

findpeaks(Hs) находит локальные максимумы или пики. Если пики не найдены, findpeaks возвращает пустой вектор.

[pks,frqs] = findpeaks(x) возвращает значения пиков, pksи частоты, frqs, при которых они происходят.

findpeaks(x,'minpeakheight',mph) возвращает только пики, превышающие минимальную высоту пика mph, где mph - действительный скаляр. Значение по умолчанию: -Inf.

findpeaks(x,'minpeakdistance',mpd) возвращает только пики, разделенные минимальным расстоянием в единицах частоты mpd, что является положительным целым числом. При установке минимального пикового расстояния игнорируются меньшие пики, которые могут возникать вблизи более крупных локальных пиков. Значение по умолчанию - 1.

findpeaks(x,'threshold',th) возвращает только пики, превышающие их соседи по крайней мере на пороговое значение, th, которое является действительным скалярным значением, большим или равным 0. Значение по умолчанию - 0.

findpeaks(x,'npeaks',np) возвращает максимальное значение, равное np количество пиков. Когда np найдены пики, поиск прекращается. По умолчанию возвращаются все пики.

findpeaks(x,'sortstr',str) определяет порядок сортировки, где str является 'ascend', 'descend', или 'none'. Когда str имеет значение 'ascend', пики сортируются от наименьшего к наибольшему. Когда str имеет значение 'descend' пики сортируются в порядке убывания. Когда str имеет значение 'none', пики возвращаются в том порядке, в котором они имеют место.

halfrange

halfrange(Hs) преобразует спектр Hs к спектру, рассчитанному в течение половины интервала Найквиста. Все связанные свойства, на которые влияет новый диапазон частот, корректируются автоматически. Этот метод используется для dspdata.pseudospectrum объекты.

Предполагается, что спектр исходит из реального сигнала. То есть halfrange использует половину точек данных независимо от того, являются ли данные симметричными.

normalizefreq

normalizefreq(Hs) или normalizefreq(Hs,true) нормализует спецификации частоты в Hs объект в Fs таким образом, частоты находятся в диапазоне от 0 до 1. Он также устанавливает NormalizedFrequency свойство для true.

normalizefreq(Hs,false) преобразует частоты в линейные частоты.

normalizefreq(Hs,false,Fs) устанавливает новую частоту дискретизации, Fs. Это можно использовать только с false.

onesided

onesided(Hs) преобразует спектр Hs к спектру, вычисленному в течение половины интервала Найквиста и содержащему общую мощность сигнала. Все связанные свойства, на которые влияет новый диапазон частот, корректируются автоматически. Этот метод используется для dspdata.psd и dspdata.msspectrum объекты.

Предполагается, что спектр исходит из реального сигнала. То есть onesided использует половину точек данных независимо от того, являются ли данные симметричными.

plot

Графическое отображение данных в окне текущего рисунка.

Для dspdata.psd объект отображает спектральную плотность мощности в дБ/Гц.

Для dspdata.msspectrum объект отображает среднеквадратичное значение в дБ.

Для dspdata.pseudospectrum объект отображает псевдоспектр в дБ.

sfdr

Этот метод применяется только к dspdata.msspectrum объекты.

sfdr(Hs) вычисляет беспорочный динамический диапазон (SFDR) в дБ объекта среднего квадратного спектра Hs. SFDR - это полезный диапазон до того, как ложный шум будет мешать сигналу.

[sfd,spur,frq] = sfdr(Hs) возвращает величину наивысшего spur и периодичность frq при котором происходит.

sfdr(Hs,'minspurlevel',msl) игнорирует шпоры ниже минимального уровня шпоры msl, который является действительным скаляром в дБ.

sfdr(Hs,'minspurdistance',msd) включает шпоры, только если они разделены по крайней мере минимальным расстоянием шпоры msd, который является действительным положительным скаляром в единицах частоты.

twosided

twosided(Hs) преобразует Hs спектр к спектру, рассчитанному по всему интервалу Найквиста. Все связанные свойства, на которые влияет новый диапазон частот, корректируются автоматически. Этот метод используется для dspdata.psd и dspdata.msspectrum объекты.

Если выполняется неравномерная выборка данных, преобразование из onesided кому twosided может привести к неправильным результатам.

wholerange

wholerange(Hs) преобразует Hs спектр к спектру, рассчитанному по всему интервалу Найквиста. Все связанные свойства, на которые влияет новый диапазон частот, корректируются автоматически. Этот метод используется для dspdata.pseudospectrum объекты.

Если выполняется неравномерная выборка данных, преобразование из half кому wholerange может привести к неправильным результатам.

Для получения дополнительной информации о каждом методе используйте синтаксис help dspdata/method по запросу MATLAB.

Печать dspdata Объект

Метод печати отображает dspdata спектр объекта в отдельном окне фигуры.

Изменение dspdata Объект

После создания dspdata для изменения свойств объекта можно использовать любой из методов в таблице выше. Например, чтобы изменить объект, Hs, от двустороннего к одностороннему, использовать onesided(Hs).

Примеры

См. раздел dspdata.msspectrum, dspdata.psd, и dspdata.pseudospectrum справочные страницы для конкретных примеров.

См. также

| | | | | | | |

Представлен до R2006a