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

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