tgspcread

Считайте данные из файла SPC

Синтаксис

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

Описание

SPCStruct = tgspcread(File) читает Галактический файл SPC из Термо 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, который соответствует Термо Научной Универсальной Спецификации Формата данных. Если вы задаете только имя файла, тот файл должен быть на пути поиска файлов 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 — Информация о заголовке для субфайлов или сканирований, включая индекс сканирования, затем сканирует индекс и w значение данных.

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

X

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

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

Y

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

Если существует только одно сканирование, то Y является вектором. Если существует несколько сканирований, которые совместно используют те же x значения данных, то 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