gather

Gather properties of linear or generalized linear regression model

collapse all in page

    Syntax

    gatheredMdl = gather(mdl)

    Description

    example

    gatheredMdl = gather(mdl) gathers all properties of the input linear or generalized linear model mdl and returns the gathered model gatheredMdl. All properties of the output model are stored as regular arrays.

    Use gather to create a linear or generalized linear model with properties stored as regular arrays from a model fitted using data stored as a GPU array. For more details on GPU arrays, see gpuArray (Parallel Computing Toolbox).

    Examples

    collapse all

    This example uses:

    Open Live Script

    Gather the properties of a linear regression model fitted with GPU array data.

    Load the carsmall data set. Create X as a numeric matrix that contains three car performance metrics. Create Y as a numeric vector that contains the corresponding miles per gallon.

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

    Convert the predictor X and response Y to gpuArray (Parallel Computing Toolbox) objects.

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

    Fit a linear regression model mdl by using fitlm. 

    mdl = fitlm(X,MPG);

    Display the coefficients of mdl and determine whether the estimated coefficient values are GPU arrays.

    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

    Gather the properties of the linear regression model. 

    gatheredMdl = gather(mdl);

    Display the coefficients of gatheredMdl and determine whether the estimated coefficient values are GPU arrays.

    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

    Input Arguments

    collapse all

    Linear or generalized linear regression model, specified as a LinearModel, CompactLinearModel, GeneralizedLinearModel, or CompactGeneralizedLinearModel object.

    You can create a linear or generalized linear regression model that supports GPU arrays in these ways:

    • Use fitlm to create a LinearModel object fitted with GPU array input arguments.

    • Use compact to create a CompactLinearModel object from a LinearModel object fitted with GPU array input arguments.

    • Use fitglm to create a GeneralizedLinearModel object fitted with GPU array input arguments.

    • Use compact to create a CompactGeneralizedLinearModel object from a GeneralizedLinearModel object fitted with GPU array input arguments.

    Extended Capabilities

    See Also

    | | | | (Parallel Computing Toolbox) | (Parallel Computing Toolbox)

    Topics

    Introduced in R2020b

    Statistics and Machine Learning Toolbox Documentation

    Support