linearizeOutput

(To be removed) Specify outputs of linearized model

Since R2021b

collapse all in page

linearizeOutput will be removed.

Syntax

linearizeOutput(model,RegionType,RegionID)
linearizeOutput(model,RegionType,RegionID,"Component",xyz)
output = linearizeOutput(___)

Description

linearizeOutput(model,RegionType,RegionID) adds all degrees of freedom (DoFs) associated with the region defined by RegionType and RegionID to the output vector of the linearized model. For 3-D structural models, linearizeOutput adds all x-coordinates first, then all y-coordinates, then all z-coordinates. In the linearized model sys, use sys.OutputGroup to locate the sections associated with each coordinate.

Use linearizeInput and linearizeOutput together with the linearize function to extract sparse linear models from structural and thermal models.

example

linearizeOutput(model,RegionType,RegionID,"Component",xyz) specifies which of the coordinates to include.

output = linearizeOutput(___) returns a structure array output with the linearization output description. Use this syntax with any of the previous arguments.

Examples

collapse all

Open Live Script

Specify the regions of a 2-D thermal model for which linearize extracts sparse linear models used in Control System Toolbox™.

Create a transient thermal model.

thermalmodel = createpde("thermal","transient");

Add the block geometry to the thermal model by using the geometryFromEdges function. The geometry description file for this problem is called crackg.m.

geometryFromEdges(thermalmodel,@crackg);

Plot the geometry, displaying edge labels.

pdegplot(thermalmodel,"EdgeLabels","on")
ylim([-1,1])
axis equal

Figure contains an axes object. The axes object contains 9 objects of type line, text.

Generate a mesh.

generateMesh(thermalmodel);

Specify the thermal conductivity, mass density, and specific heat of the material.

thermalProperties(thermalmodel,"ThermalConductivity",1, ...
                               "MassDensity",1, ...
                               "SpecificHeat",1);

Specify the temperature on the left edge as 100, and constant heat flow to the exterior through the right edge as -10. Add a unique label to each boundary condition.

thermalBC(thermalmodel,"Edge",6,"Temperature",100,"Label","TempBC");
thermalBC(thermalmodel,"Edge",1,"HeatFlux",-10,"Label","FluxBC");

Specify that the entire geometry generates heat and add a unique label to this assignment.

internalHeatSource(thermalmodel,25,"Label","HeatSource");

Set an initial value of 0 for the temperature.

thermalIC(thermalmodel,0);

Call the linearizeInput function with the previously defined labels for the boundary conditions and the internal heat source to set the inputs for the linearize function. Add one label per function call.

linearizeInput(thermalmodel,"HeatSource");
linearizeInput(thermalmodel,"TempBC");
linearizeInput(thermalmodel,"FluxBC");

Call the linearizeOutput function to specify the regions for which you want linearize to extract sparse linear models. Specify one region per function call.

linearizeOutput(thermalmodel,"Edge",2)
ans = struct with fields:
    RegionType: 'Edge'
      RegionID: 2

Input Arguments

collapse all

Structural or linear thermal model, specified as a StructuralModel object or a ThermalModel object. The linearize function does not support nonlinear thermal analysis.

Geometric region type, specified as "Cell" (for a 3-D model only), "Face", "Edge", or "Vertex".

Data Types: char

Geometric region ID, specified as a positive integer. Find the region IDs by using pdegplot with the "CellLabels", "FaceLabels", "EdgeLabels", or "VertexLabels" value set to "on".

Data Types: double

Coordinates to include, specified as a character vector or a string of x-, y-, and z-coordinates to include.

Example: linearizeOutput(pdemodel,"Face",10,"Component","xz") selects the x and z DoFs for face 10

Data Types: char | string

Output Arguments

collapse all

Linearization output description, returned as a structure array.

Version History

Introduced in R2021b

collapse all

See Also

|