exponenta event banner

cghfreqplot

Частота отображения изменений числа копий ДНК в нескольких образцах

Синтаксис

FreqStruct = cghfreqplot(CGHData)
FreqStruct = cghfreqplot(CGHData, ...'Threshold', ThresholdValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Group', GroupValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Subgrp', SubgrpValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Subplot', SubplotValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Cutoff', CutoffValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Chromosome', ChromosomeValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'IncludeX', IncludeXValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'IncludeY', IncludeYValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Chrominfo', ChrominfoValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'ShowCentr', ShowCentrValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Color', ColorValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'YLim', YLimValue, ...)
FreqStruct = cghfreqplot(CGHData, ...'Titles', TitlesValue, ...)

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

CGHData

Данные сравнительной геномной гибридизации (aCGH) на основе массива в любой из следующих форм:

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

    • Sample - массив ячеек символьных векторов или строковых векторов, содержащих имена образцов (необязательно).

    • Chromosome - Вектор, содержащий номера хромосом, на которых расположены клоны.

    • GenomicPosition - Вектор, содержащий геномные позиции (в единицах bp, kb или mb), на которые отображены клоны.

    • Log2Ratio - Матрица, содержащая отношение log2 теста к интенсивности опорного сигнала для каждого клона. Каждая строка соответствует клону, и каждый столбец соответствует образцу.

  • Матрица, в которой каждая строка соответствует клону. Первая колонка содержит номер хромосомы, вторая колонка содержит геномное положение, а остальные колонки содержат отношение log2 теста к интенсивности опорного сигнала для образца.

ThresholdValue

Положительный скаляр или вектор, задающий порог усиления/потерь. Клон считается усилением, если его отношение log2 выше ThresholdValueи потери, если его отношение log2 ниже отрицательного ThresholdValue.

ThresholdValue применяется следующим образом:

  • Если положительный скаляр, это порог усиления и потерь для всех выборок.

  • Если двухэлементный вектор, первый элемент является порогом усиления для всех выборок, а второй элемент является порогом потерь для всех выборок.

  • Если вектор той же длины, что и число выборок, каждый элемент в векторе рассматривается как уникальный порог усиления и потерь для каждой выборки.

По умолчанию: 0.25.

GroupValue

Указывает группы образцов для вычисления частоты. Возможны следующие варианты:

  • Вектор индексов выборочных столбцов (для данных только с одной группой). Выборки, указанные в векторе, считаются группой.

  • Клеточный массив векторов индексов выборочных столбцов (для данных, разделенных на несколько групп). Каждый элемент в массиве ячеек считается группой.

По умолчанию - это одна группа всех выборок в CGHData.

SubgrpValueУправляет анализом проб по подгруппам. Варианты: true (по умолчанию) или false.
SubplotValueУправляет отображением всех графиков в одном окне фигуры при анализе нескольких подгрупп. Варианты: true (по умолчанию) или false (отображает графики в отдельных окнах).
CutoffValueСкалярный или двухэлементный числовой вектор, задающий отсечение, который управляет выводом на печать только клонов с частотным усилением или потерями, большими или равными CutoffValue. Если двухэлементный вектор, первый элемент является отсечкой для коэффициентов усиления, а второй элемент - для потерь. По умолчанию: 0.
ChromosomeValueЕдинственное число хромосом или вектор чисел хромосом, которые определяют хромосомы, для которых отображают графики частоты. По умолчанию все хромосомы в CGHData.
IncludeXValueКонтролирует включение X-хромосомы в анализ. Варианты: true (по умолчанию) или false.
IncludeYValueКонтролирует включение Y-хромосомы в анализ. Варианты: true или false (по умолчанию).
ChrominfoValue

Информация о цитогенетической связке, указанная одним из следующих:

  • Структура, возвращенная cytobandread функция

  • Символьный вектор или строка, указывающая имя файла текстового файла идеограммы NCBI или текстового файла цитобанда браузера генома UCSC

По умолчанию используется информация о цитогенетических полосах Homo sapiens из браузера генома UCSC, NCBI Build 36.1 (https://genome.UCSC.edu).

ShowCentrValue

Управление отображением положений центромер в виде вертикальных пунктирных линий на графике частоты. Варианты: true (по умолчанию) или false.

Совет

Положения центромер получены из ChrominfoValue.

ColorValue

Цветовая схема для вертикальных линий на графике, указывающая частоту выигрышей и потерь, заданную одним из следующих параметров:

  • Имя или дескриптор функции, возвращающей карту цвета

  • M-by-3 матрица, содержащая значения RGB. Если M равно 1, то этот единственный цвет используется для всех выигрышей и потерь. Если M равно 2 или более, то первая строка используется для коэффициентов усиления, вторая строка используется для потерь, а остальные строки игнорируются. Например, [0 1 0;1 0 0] указывает зеленый цвет для усиления и красный цвет для потерь.

Цветовая схема по умолчанию - это диапазон цветов от чисто зеленого (коэффициент усиления = 1) до желтого (0) и чистого красного (потеря = -1).

YLimValueДвухэлементный вектор, задающий минимальное и максимальное значения на вертикальной оси. По умолчанию: [1, -1].
TitlesValueСимвольный вектор, строка, строковый вектор или массив ячеек символьных векторов, указывающих названия групп, которые добавляются к вершинам графика (графиков).

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

FreqStructСтруктура, содержащая частотные данные в следующих полях:
  • Group - структурный массив, причем каждая структура представляет группу выборок. Каждая структура содержит следующие поля:

    • Sample - массив ячеек, содержащий имена образцов в группе.

    • GainFrequency - Вектор столбца, содержащий среднее усиление для каждого клона для группы образцов.

    • LossFrequency - Вектор столбца, содержащий средние потери для каждого клона для группы образцов.

  • Chromosome - Вектор-колонка, содержащий номера хромосом, на которых расположены клоны.

  • GenomicPosition - Вектор-колонка, содержащий геномные положения клонов.

Совет

Эту структуру вывода можно использовать в качестве входных данных для cghfreqplot функция.

Описание

FreqStruct = cghfreqplot(CGHData) отображает частоту увеличения или потери числа копий для нескольких образцов для каждого клона на массиве в сравнении с их геномным положением вдоль хромосом.

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

FreqStruct = cghfreqplot(CGHData, ...'Threshold', ThresholdValue, ...) определяет порог прибылей/убытков. Клон считается усилением, если его отношение log2 выше ThresholdValueи потери, если его отношение log2 ниже отрицательного ThresholdValue.

ThresholdValue применяется следующим образом:

  • Если положительный скаляр, это порог усиления и потерь для всех выборок.

  • Если двухэлементный вектор, первый элемент является порогом усиления для всех выборок, а второй элемент является порогом потерь для всех выборок.

  • Если вектор той же длины, что и число выборок, каждый элемент в векторе рассматривается как уникальный порог усиления и потерь для каждой выборки.

По умолчанию: 0.25.

FreqStruct = cghfreqplot(CGHData, ...'Group', GroupValue, ...) задает группы выборок для вычисления частоты. Возможны следующие варианты:

  • Вектор индексов выборочных столбцов (для данных только с одной группой). Выборки, указанные в векторе, считаются группой.

  • Клеточный массив векторов индексов выборочных столбцов (для данных, разделенных на несколько групп). Каждый элемент в массиве ячеек считается группой.

По умолчанию - это одна группа всех выборок в CGHData.

FreqStruct = cghfreqplot(CGHData, ...'Subgrp', SubgrpValue, ...) контролирует анализ проб по подгруппам. Варианты: true (по умолчанию) или false.

FreqStruct = cghfreqplot(CGHData, ...'Subplot', SubplotValue, ...) управляет отображением всех графиков в одном окне фигуры при анализе нескольких подгрупп. Варианты: true (по умолчанию) или false (отображает графики в отдельных окнах).

FreqStruct = cghfreqplot(CGHData, ...'Cutoff', CutoffValue, ...) задает значение отсечки, которое управляет выводом на печать только клонов с частотным усилением или потерями, большими или равными CutoffValue. CutoffValue является скалярным или двухэлементным числовым вектором. Если двухэлементный числовой вектор, первый элемент является отсечением для коэффициентов усиления, а второй элемент - для потерь. По умолчанию: 0.

FreqStruct = cghfreqplot(CGHData, ...'Chromosome', ChromosomeValue, ...) отображает графики частоты только хромосом (хромосом), указанных ChromosomeValue, которое может быть единственным числом хромосом или вектором чисел хромосом. По умолчанию все хромосомы в CGHData.

FreqStruct = cghfreqplot(CGHData, ...'IncludeX', IncludeXValue, ...) контролирует включение X-хромосомы в анализ. Варианты: true (по умолчанию) или false.

FreqStruct = cghfreqplot(CGHData, ...'IncludeY', IncludeYValue, ...) контролирует включение Y-хромосомы в анализ. Варианты: true или false (по умолчанию).

FreqStruct = cghfreqplot(CGHData, ...'Chrominfo', ChrominfoValue, ...) определяет информацию о цитогенетической связке для хромосом. ChrominfoValue может быть одним из следующих

  • Структура, возвращенная cytobandread функция

  • Символьный вектор или строка, указывающая имя файла текстового файла идеограммы NCBI или текстового файла цитобанда браузера генома UCSC

По умолчанию используется информация о цитогенетических полосах Homo sapiens из браузера генома UCSC, NCBI Build 36.1 (https://genome.UCSC.edu).

Совет

Файлы, содержащие цитогенетические данные G-banding, можно загрузить с ftp-сайта NCBI или UCSC Genome Browser. Например, можно загрузить данные цитогенетического связывания для Homo sapiens из:

FreqStruct = cghfreqplot(CGHData, ...'ShowCentr', ShowCentrValue, ...) управляет отображением положений центромер в виде вертикальных пунктирных линий на графике частоты. Варианты: true (по умолчанию) или false.

Совет

Положения центромер получены из ChrominfoValue.

FreqStruct = cghfreqplot(CGHData, ...'Color', ColorValue, ...) задает цветовую схему для вертикальных линий на графике, указывающую частоту выигрышей и потерь. Возможны следующие варианты:

  • Имя или дескриптор функции, возвращающей карту цветов.

  • M-by-3 матрица, содержащая значения RGB. Если M равно 1, то этот единственный цвет используется для всех выигрышей и потерь. Если M равно 2 или более, то первая строка используется для коэффициентов усиления, вторая строка используется для потерь, а остальные строки игнорируются. Например, [0 1 0;1 0 0] указывает зеленый цвет для усиления и красный цвет для потерь.

Цветовая схема по умолчанию - это диапазон цветов от чисто зеленого (коэффициент усиления = 1) до желтого (0) и чистого красного (потеря = -1).

FreqStruct = cghfreqplot(CGHData, ...'YLim', YLimValue, ...) задает вертикальные пределы y для графика частоты. YLimValue - двухэлементный вектор, задающий минимальное и максимальное значения на вертикальной оси. По умолчанию: [1, -1].

FreqStruct = cghfreqplot(CGHData, ...'Titles', TitlesValue, ...) задает заголовки для групп, которые добавляются к вершинам графика (графиков ).TitlesValue может быть символьным вектором, строковым вектором или массивом ячеек символьных векторов.

Примеры

свернуть все

Данные графика исследования клеточной линии Coriell

Загрузить данные CGH (aCGH) на основе массива из исследования клеточной линии Кориелла (Snijders, A. et al., 2001).

load coriell_baccgh

Отображение графика частоты изменений номера копии для всех выборок.

Struct = cghfreqplot(coriell_data);

Figure contains an axes. The axes contains 1018 objects of type line, text. These objects represent Gain, Loss, Chromosomes, Centromere.

Просмотрите советы по данным, хромосомам и центромерам. Сначала нажмите кнопку «Курсор данных» на панели инструментов, затем щелкните черную линию границы хромосомы или пунктирную линию центромеры на графике. Чтобы удалить эту подсказку, щелкните ее правой кнопкой мыши и выберите Удалить текущую информацию.

Отобразите цветовую полосу, указывающую степень выигрыша или потери, нажав кнопку «Вставить цветовую панель» на панели инструментов.

Данные графика исследования рака поджелудочной железы

Загрузить данные aCGH из исследования рака поджелудочной железы (Aguirre, A. et al., 2004).

load pancrea_oligocgh

Отображение графика частоты изменений количества копий во всех образцах с использованием зеленой и красной цветовой схемы.

cghfreqplot(pancrea_data, 'Color', [0 1 0; 1 0 0])

Figure contains an axes. The axes contains 21310 objects of type line, text. These objects represent Gain, Loss, Chromosomes, Centromere.

Печать групп данных aCGH

Определите две группы данных.

grp1 = strncmp('PA.C', pancrea_data.Sample,4);
grp1_ind = find(grp1);
grp2 = strncmp('PA.T', pancrea_data.Sample,4);
grp2_ind = find(grp2);

Отображение графика частоты изменений числа копий для всех выборок в двух группах и ограничение графика только клонами с частотным усилением или потерями, превышающими или равными 0,25.

SP = cghfreqplot(pancrea_data, 'Group', {grp1_ind, grp2_ind},...
                 'Title', {'CL', 'PT'}, 'Cutoff', 0.25);

Figure contains 2 axes. Axes 1 with title CL contains 6923 objects of type line, text. These objects represent Gain, Loss, Chromosomes, Centromere. Axes 2 with title PT contains 3571 objects of type line, text. These objects represent Gain, Loss, Chromosomes, Centromere.

Отображение графика частоты изменений числа копий для всех образцов в первой группе и ограничение графика только хромосомой 4.

SP = cghfreqplot(pancrea_data, 'Group', grp1_ind, ...
                 'Title', 'CL Group on Chr 4', 'Chromosome', 4);

Figure contains an axes. The axes with title CL Group on Chr 4 contains 690 objects of type line, text. These objects represent Gain, Loss, Centromere.

Используйте chromosomeplot функции с помощью 'addtoplot' возможность добавления идеограммы хромосомы 4 для Homo sapiens к этому частотному графику. Поскольку график частотных данных из исследования рака поджелудочной железы находится в кб, используйте 'Unit' для преобразования данных идеограммы в единицы КБ.

chromosomeplot('hs_cytoBand.txt', 4, 'addtoplot', gca, 'Unit', 2);

Figure contains an axes. The axes with title CL Group on Chr 4 contains 690 objects of type line, text. These objects represent Gain, Loss, Centromere.

Ссылки

[1] Снайдерс, А.М., Новак, Н., Сегрейвс, Р., Блэквуд, С., Браун, Н., Конрой, Дж., Гамильтон, Г., Хиндл, А.К., Хьюи, Б., Кимура, К., Ло, С., Мямбо, К., Палмер, Дж. Грей, Джей У., Джейн, А.Н., Пинкел, Д. и Альбертсон, Д.Г. (2001). Сборка микрочипов для измерения числа копий ДНК по всему геному. Генетика природы 29, 263-264.

[2] Агирре, А.Дж., Бреннан, К., Бейли, Г., Синха, Р., Фэн, Б., Лео, К., Чжан, Я., Чжан, Дж., Ганс, Дж. Д., Бардизи, Н., Коувелс, К., Кордон-Кардо, К., Редстон, М. С., ДеПиньо, Р.А., и Чин, Л. (2004). Характеристика высокого разрешения генома аденокарциномы поджелудочной железы. ПНАС 101, 24, 9067-9072.

См. также

| |

Представлен в R2008a