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. Если указано только имя файла, он должен находиться в пути поиска 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

Документация по инструментарию биоинформатики

Поддержка