gather

Соберите свойства объекта Statistics and Machine Learning Toolbox от графического процессора

    Описание

    пример

    gatheredObj = gather(obj) собирает все свойства входного объекта obj и возвращает собранный объект gatheredObj. Все свойства выходного объекта хранятся в локальной рабочей области.

    Использование gather создать объект Statistics and Machine Learning Toolbox™ со свойствами, сохраненными в локальной рабочей области от объекта, адаптированного с помощью данных, хранимых как массив графического процессора. Для получения дополнительной информации о массивах графического процессора смотрите gpuArray (Parallel Computing Toolbox). Используя графический процессор требует Parallel Computing Toolbox™ и поддерживаемого устройства графического процессора. Для получения информации о поддерживаемых устройствах смотрите Поддержку графического процессора Релизом (Parallel Computing Toolbox).

    пример

    [gatheredObj1,gatheredObj2,...,gatheredObjn] = gather(obj1,obj2,...,objn) собирает свойства нескольких объектов obj1,obj2,...,objn и возвращает соответствующие собранные объекты gatheredObj1,gatheredObj2,...,gatheredObjn. Количество входных параметров и выходных аргументов должно соответствовать.

    Примеры

    свернуть все

    Соберите свойства модели линейной регрессии, подбиравшей с данными массива графического процессора.

    Загрузите carsmall набор данных. Создайте X как числовая матрица, которая содержит три автомобильных показателя производительности. Создайте Y как числовой вектор, который содержит соответствующие мили на галлон.

    load carsmall
    X = [Weight,Horsepower,Acceleration];
    Y = MPG;

    Преобразуйте предиктор X и ответ Y к gpuArray (Parallel Computing Toolbox) объекты.

    X = gpuArray(X);
    Y = gpuArray(Y);

    Соответствуйте модели mdl линейной регрессии при помощи fitlm.

    mdl = fitlm(X,Y);

    Отобразите коэффициенты mdl и определите, являются ли предполагаемые содействующие значения массивами графического процессора.

    mdl.Coefficients
    ans=4×4 table
                        Estimate        SE          tStat        pValue  
                       __________    _________    _________    __________
    
        (Intercept)        47.977       3.8785        12.37    4.8957e-21
        x1             -0.0065416    0.0011274      -5.8023    9.8742e-08
        x2              -0.042943     0.024313      -1.7663       0.08078
        x3              -0.011583      0.19333    -0.059913       0.95236
    
    
    isgpuarray(mdl.Coefficients.Estimate)
    ans = logical
       1
    
    

    Соберите свойства модели линейной регрессии.

    gatheredMdl = gather(mdl);

    Отобразите коэффициенты gatheredMdl и определите, являются ли предполагаемые содействующие значения массивами графического процессора.

    gatheredMdl.Coefficients
    ans=4×4 table
                        Estimate        SE          tStat        pValue  
                       __________    _________    _________    __________
    
        (Intercept)        47.977       3.8785        12.37    4.8957e-21
        x1             -0.0065416    0.0011274      -5.8023    9.8742e-08
        x2              -0.042943     0.024313      -1.7663       0.08078
        x3              -0.011583      0.19333    -0.059913       0.95236
    
    
    isgpuarray(gatheredMdl.Coefficients.Estimate)
    ans = logical
       0
    
    

    Соберите свойства модели линейной регрессии и классификатора k - ближайших соседей. Обе модели подбираются с помощью данных массива графического процессора.

    Загрузите carsmall набор данных. Создайте X как числовая матрица, которая содержит три автомобильных показателя производительности и преобразует предиктор X к gpuArray объект.

    load carsmall
    X = [Weight,Horsepower,Acceleration];
    X = gpuArray(X);

    Подбирайте модель линейной регрессии MPG (мили на галлон) в зависимости от предиктора X.

    mdlLinear = fitlm(X,MPG);

    Обучите 3-самый близкий соседний классификатор с помощью предиктора X и классы Cylinders. Стандартизируйте некатегориальные данные о предикторе.

    mdlKNN = fitcknn(X,Cylinders,'NumNeighbors',3,'Standardize',1);

    Соберите свойства mdLinear и mdlKNN модели.

    [gMdlLinear,gMdlKNN] = gather(mdlLinear,mdlKNN);

    Определите, тестирует ли p-значение Дербин-Уотсона на модель mdlLinear регрессии массив графического процессора.

    isgpuarray(dwtest(mdlLinear))
    ans = logical
       1
    
    

    Определите, тестирует ли p-значение Дербин-Уотсона на собранную модель gMdlLinear регрессии массив графического процессора.

    isgpuarray(dwtest(gMdlLinear))
    ans = logical
       0
    
    

    Определите ли потеря перезамены классификатора mdlKNN массив графического процессора.

    isgpuarray(resubLoss(mdlKNN))
    ans = logical
       1
    
    

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

    isgpuarray(resubLoss(gMdlKNN))
    ans = logical
       1
    
    

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

    свернуть все

    Объект снабжен массивами графического процессора или gpuArray объект в виде объекта модели регрессии, объекта модели классификации, объекта вероятностного распределения, cvpartition объект или gpuArray Объект (Parallel Computing Toolbox). gpuArray объект представляет массив, сохраненный на графическом процессоре.

    Для получения дополнительной информации об объектах Statistics and Machine Learning Toolbox, поддержанных gather, см. Поддерживаемые Модели Регрессии, Поддерживаемые Модели Классификации и Поддерживаемые Объекты Распределения вероятностей.

    Больше о

    свернуть все

    Поддерживаемые модели регрессии

    gather функция может собрать свойства следующих объектов модели регрессии.

    Тип моделиОбъект полной или компактной моделиФункция создания модели
    Полная обобщенная линейная модель регрессииGeneralizedLinearModel или CompactGeneralizedLinearModelfitglm или GeneralizedLinearModel объектная функция compact
    Полная модель линейной регрессииLinearModel или CompactLinearModelfitlm или LinearModel объектная функция compact
    Модель дерева регрессииRegressionTree или CompactRegressionTreefitrtree или RegressionTree объектная функция compact
    Перекрестная подтвержденная модель регрессииRegressionPartitionedModelfitrtree

    Если вы хотите создать компактную модель, подбиравшую с массивами графического процессора, входной параметр mdl из compact должен быть полный объект модели, снабженный входными параметрами графического процессора массивов.

    Поддерживаемые модели классификации

    gather функция может собрать свойства следующих объектов модели классификации.

    Тип моделиОбъект полной или компактной моделиФункция создания модели
    Модель Multiclass для машин опорных векторов или других классификаторовClassificationECOC или CompactClassificationECOCfitcecoc или ClassificationECOC объектная функция compact
    Ансамбль учеников для классификацииClassificationEnsemble, CompactClassificationEnsemble, или ClassificationBaggedEnsemblefitcensemble или ClassificationEnsemble объектная функция compact
    k- соседний классификаторClassificationKNNfitcknn
    Дерево выбора из двух альтернатив для классификации мультиклассовClassificationTree или CompactClassificationTreefitctree или ClassificationTree объектная функция compact
    Перекрестная подтвержденная модель ECOCClassificationPartitionedECOCfitcecoc
    Перекрестный подтвержденный ансамбль классификацииClassificationPartitionedEnsemblefitcensemble
    Перекрестная подтвержденная модель классификацииClassificationPartitionedModelfitcknn, fitcsvm, или fitctree

    Если вы хотите создать компактную модель, подбиравшую с массивами графического процессора, входной параметр mdl из compact должен быть полный объект модели, снабженный входными параметрами графического процессора массивов.

    Поддерживаемые Объекты Распределения вероятностей

    gather функция может собрать свойства следующих объектов вероятностного распределения.

    Вероятностное распределениеОбъект вероятностного распределенияФункция создания объекта
    Бета распределениеBetaDistributionfitdist с distname заданный как 'Beta'
    Биномиальное распределениеBinomialDistributionfitdist с distname заданный как 'Binomial'
    Распределение Бирнбаума-СондерсаBirnbaumSaundersDistributionfitdist с distname заданный как 'BirnbaumSaunders'
    Подпилите распределениеBurrDistributionfitdist с distname заданный как 'Burr'
    Экспоненциальное распределениеExponentialDistributionfitdist с distname заданный как 'Exponential'
    Распределение ЭкстремумаExtremeValueDistributionfitdist с distname заданный как 'ExtremeValue'
    Гамма распределениеGammaDistributionfitdist с distname заданный как 'Gamma'
    Обобщенное распределение ЭкстремумаGeneralizedExtremeValueDistributionfitdist с distname заданный как 'GeneralizedExtremeValue'
    Обобщенное распределение ПаретоGeneralizedParetoDistributionfitdist с distname заданный как 'GeneralizedPareto'
    Полунормальное распределениеHalfNormalDistributionfitdist с distname заданный как 'HalfNormal'
    Обратное Распределение ГауссаInverseGaussianDistributionfitdist с distname заданный как 'InverseGaussian'
    Ядерное распределениеKernelDistributionfitdist с distname заданный как 'Kernel'
    Логистическое распределениеLogisticDistributionfitdist с distname заданный как 'Logistic'
    Распределение LoglogisticLoglogisticDistributionfitdist с distname заданный как 'Loglogistic'
    Логарифмически нормальное распределениеLognormalDistributionfitdist с distname заданный как 'Lognormal'
    Распределение NakagamiNakagamiDistributionfitdist с distname заданный как 'Nakagami'
    Отрицательное Биномиальное распределениеNegativeBinomialDistributionfitdist с distname заданный как 'NegativeBinomial'
    Нормальное распределениеNormalDistributionfitdist с distname заданный как 'Normal'
    Распределение ПуассонаPoissonDistributionfitdist с distname заданный как 'Poisson'
    Распределение РелеяRayleighDistributionfitdist с distname заданный как 'Rayleigh'
    Распределение Шкалы Местоположения ttLocationScaleDistributionfitdist с distname заданный как 'tLocationScale'
    Распределение WeibullWeibullDistributionfitdist с distname заданный как 'Weibull'

    Советы

    • Сбор массивов графического процессора может быть дорогостоящим и является обычно не необходимым, если вы не должны использовать результаты с функциями, которые не поддерживают массивы графического процессора. Для полного списка функций Statistics and Machine Learning Toolbox, которые принимают массивы графического процессора, см. Функциональный Список (Массивы графического процессора).

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

    Расширенные возможности

    Введенный в R2020b