Exponenta Banner
exponenta event banner

tgspcread

Чтение данных из файла SPC

Синтаксис

SPCStruct = tgspcread(File)
tgspcread(..., 'ZRange', ZRangeValue, ...)
tgspcread(..., 'ScanIndices', ScanIndicesValue, ...)
tgspcread(..., 'Verbose', VerboseValue, ...)

Описание

SPCStruct = tgspcread(File) читает файл Galactic SPC из Thermo Scientific®, и возвращает данные в MATLAB® структура.

tgspcread (..., 'PropertyName', PropertyValue, ...) вызывает tgspcread с необязательными свойствами, которые используют пары имя/значение свойства. Можно задать одно или несколько свойств в любом порядке. Заключайте каждую PropertyName в одинарных кавычках. Каждый PropertyName является нечувствительным к регистру. Эти имена свойства/пары значения свойств следующие:

tgspcread(..., 'ZRange', ZRangeValue, ...) задает область значений значений данных z в файле SPC, из которого нужно извлечь сканы.

tgspcread(..., 'ScanIndices', ScanIndicesValue, ...) задает скан, несколько сканы или область значений сканов в файле SPC для чтения.

tgspcread(..., 'Verbose', VerboseValue, ...) управляет отображением прогресса чтения файла SPC. Варианты true (по умолчанию) или false.

Входные параметры

File

Вектор символов или строка, задающая имя файла или путь и имя файла SPC, который соответствует спецификации Thermo Scientific Universal Формат. Если вы задаете только имя файла, этот файл должен быть в пути поиска файлов MATLAB или в текущей папке.

ZRangeValue

Двухэлементный числовой массив [Start End] который задает область значений значений данных z в File читать. Start и End должны быть положительными скалярными величинами, и Start должно быть меньше End. По умолчанию требуется извлечь все сканы.

Совет

Для получения сводной информации о значениях данных z в файле SPC используйте tgspcinfo функция.

Примечание

Если вы задаете ZRangeValue, вы не можете задать ScanIndicesValue.

ScanIndicesValue

Положительное целое число, вектор целых чисел или двухэлементный числовой массив [Start_Ind: End_Ind] который задает скан, несколько сканов или область значений сканов в File читать. Start_Ind и End_Ind - каждые положительные целые числа, указывающее индекс скана. Start_Ind должно быть меньше End_Ind. По умолчанию считываются все сканы.

Совет

Для получения сводной информации об индексах скана в файле SPC проверьте NumScans поле в структуре, возвращенной tgspcinfo функция.

Примечание

Если вы задаете ScanIndicesValue, вы не можете задать ZRangeValue.

VerboseValue

Управляет отображением прогресса чтения File. Варианты true (по умолчанию) или false.

Выходные аргументы

SPCStruct

Структура, содержащая информацию из файла SPC. Структура содержит следующие поля.

ОбластьОписание
Header

Структура, содержащая следующие поля:

  • Filename - Имя файла SPC.

  • FileSize - Размер файла SPC в байтах.

  • ExperimentType - Экспериментальный метод, используемый для создания данных.

  • NumDataPoints - Количество точек данных (значения данных y) в файле SPC.

  • XFirst - Первое значение x данных в файле SPC.

  • XLast - Последнее значение x данных в файле SPC.

  • NumScans - Количество сканов или подфайлов в файле SPC.

  • XLabel - Пометьте значения данных x.

  • YLabel - Пометьте значения данных y.

  • ZLabel - Пометьте значения данных z.

  • CollectionTime - Дата и время сбора данных скана.

  • CollectionTimeDatenum - Дата и время сбора данных скана в формате последовательного номера даты. Для получения дополнительной информации см. datenum.

  • Resolution - Разрешение инструмента.

  • SourceInstrument - Имя или модель прибора, используемого для сбора данных.

  • InterferogramPeakPointNumber - Пиковое число точек для интерферограмм. Это 0 для сканов, которые не являются интерферограммами.

  • Comment - Предоставленные пользователем комментарии.

  • CustomAxisUnitLabel - Пользовательские метки для модулей измерения оси.

  • SubScanHeaders - Информация о заголовках для подфайлов или сканов, включая индекс скана, индекс следующего сканирования и значение данных.

  • ZValues - Вектор, содержащий значения z данных всех сканов в файле SPC.

X

Вектор или массив ячеек, содержащий значения данных x.

Если все сканы имеют одинаковые значения данных x, то X является вектором. Если сканы имеют различные значения данных x, то X - массив ячеек.

Y

Вектор, матрица или массив ячеек, содержащий значения данных y.

Если существует только один скан, то Y является вектором. Если существуют несколько сканов, которые имеют одинаковые значения данных, то Y является матрицей. Если существуют несколько сканы, имеющих различные значения данных x, то Y - массив ячеек.

Z

Вектор, содержащий значения z данных сканов, считанных из файла SPC

Примеры

Этот пример предполагает, что у вас уже есть файл SPC для использования. sample.spc файл не поставляется с программным обеспечением Bioinformatics Toolbox™.

Чтение файла SPC:

% Read the contents of an SPC file into a MATLAB structure
out = tgspcread('results.spc')

File contains 1 scans

out = 

    Header: [1x1 struct]
         X: [12031x1 single]
         Y: [12031x1 double]
         Z: 0

Постройте график файла SPC:

% Plot the first scan in the SPC file:
plot(out.X,out.Y(:,1));

См. также

| | | | | | | |

Введенный в R2009b

Документация по Bioinformatics Toolbox

Поддержка