createpde

Create model

Syntax

structuralmodel = createpde('structural',StructuralAnalysisType)

thermalmodel = createpde('thermal',ThermalAnalysisType)

emagmodel = createpde('electromagnetic',ElectromagneticAnalysisType)

model = createpde(N)

Description

structuralmodel = createpde('structural',StructuralAnalysisType) returns a structural analysis model for the specified analysis type. This model lets you solve small-strain linear elasticity problems.

thermalmodel = createpde('thermal',ThermalAnalysisType) returns a thermal analysis model for the specified analysis type.

emagmodel = createpde('electromagnetic',ElectromagneticAnalysisType) returns an electromagnetic analysis model for the specified analysis type.

model = createpde(N) returns a PDE model object for a system of N equations. A complete PDE model object contains a description of the problem you want to solve, including the geometry, mesh, and boundary conditions.

Examples

Create Structural Model

Create a static structural model for solving a solid (3-D) problem.

staticStructural = createpde('structural','static-solid')

staticStructural = 
  StructuralModel with properties:

              AnalysisType: 'static-solid'
                  Geometry: []
        MaterialProperties: []
                 BodyLoads: []
        BoundaryConditions: []
      ReferenceTemperature: []
    SuperelementInterfaces: []
                      Mesh: []
             SolverOptions: [1x1 pde.PDESolverOptions]

Create a transient structural model for solving a plane-stress (2-D) problem.

transientStructural = createpde('structural','transient-planestress')

transientStructural = 
  StructuralModel with properties:

              AnalysisType: 'transient-planestress'
                  Geometry: []
        MaterialProperties: []
                 BodyLoads: []
        BoundaryConditions: []
             DampingModels: []
         InitialConditions: []
    SuperelementInterfaces: []
                      Mesh: []
             SolverOptions: [1x1 pde.PDESolverOptions]

Create a modal analysis structural model for solving a plane-strain (2-D) problem.

modalStructural = createpde('structural','modal-planestrain')

modalStructural = 
  StructuralModel with properties:

              AnalysisType: 'modal-planestrain'
                  Geometry: []
        MaterialProperties: []
        BoundaryConditions: []
    SuperelementInterfaces: []
                      Mesh: []
             SolverOptions: [1x1 pde.PDESolverOptions]

Create a frequency response analysis structural model for solving an axisymmetric problem. An axisymmetric model simplifies a 3-D problem to a 2-D problem using symmetry around the axis of rotation.

frStructural = createpde('structural','frequency-axisymmetric')

frStructural = 
  StructuralModel with properties:

              AnalysisType: 'frequency-axisymmetric'
                  Geometry: []
        MaterialProperties: []
                 BodyLoads: []
        BoundaryConditions: []
             DampingModels: []
    SuperelementInterfaces: []
                      Mesh: []
             SolverOptions: [1x1 pde.PDESolverOptions]

Create Thermal Model

Create a model for a steady-state thermal problem.

thermalmodel = createpde('thermal','steadystate')

thermalmodel = 
  ThermalModel with properties:

               AnalysisType: "steadystate"
                   Geometry: []
         MaterialProperties: []
                HeatSources: []
    StefanBoltzmannConstant: []
         BoundaryConditions: []
          InitialConditions: []
                       Mesh: []
              SolverOptions: [1x1 pde.PDESolverOptions]

Create a model for a transient thermal problem.

thermalmodel = createpde('thermal','transient')

thermalmodel = 
  ThermalModel with properties:

               AnalysisType: "transient"
                   Geometry: []
         MaterialProperties: []
                HeatSources: []
    StefanBoltzmannConstant: []
         BoundaryConditions: []
          InitialConditions: []
                       Mesh: []
              SolverOptions: [1x1 pde.PDESolverOptions]

Create a transient thermal model for solving an axisymmetric problem. An axisymmetric model simplifies a 3-D problem to a 2-D problem using symmetry around the axis of rotation.

thermalmodel = createpde('thermal','transient-axisymmetric')

thermalmodel = 
  ThermalModel with properties:

               AnalysisType: "transient-axisymmetric"
                   Geometry: []
         MaterialProperties: []
                HeatSources: []
    StefanBoltzmannConstant: []
         BoundaryConditions: []
          InitialConditions: []
                       Mesh: []
              SolverOptions: [1x1 pde.PDESolverOptions]

Create Electromagnetic Model

Create a 2-D model for electrostatic analysis.

emagE = createpde('electromagnetic','electrostatic')

emagE = 
  ElectromagneticModel with properties:

          AnalysisType: 'electrostatic'
              Geometry: []
    MaterialProperties: []
               Sources: []
    BoundaryConditions: []
    VacuumPermittivity: []
                  Mesh: []

Create an axisymmetric model for magnetostatic analysis. An axisymmetric model simplifies a 3-D problem to a 2-D problem using symmetry around the axis of rotation.

emagMA = createpde('electromagnetic','magnetostatic-axisymmetric')

emagMA = 
  ElectromagneticModel with properties:

          AnalysisType: 'magnetostatic-axisymmetric'
              Geometry: []
    MaterialProperties: []
               Sources: []
    BoundaryConditions: []
    VacuumPermeability: []
                  Mesh: []

Create General PDE Model

Create a model for a general linear or nonlinear single (scalar) PDE.

model = createpde

model = 
  PDEModel with properties:

           PDESystemSize: 1
         IsTimeDependent: 0
                Geometry: []
    EquationCoefficients: []
      BoundaryConditions: []
       InitialConditions: []
                    Mesh: []
           SolverOptions: [1x1 pde.PDESolverOptions]

Create a PDE model for a system of three equations.

model = createpde(3)

model = 
  PDEModel with properties:

           PDESystemSize: 3
         IsTimeDependent: 0
                Geometry: []
    EquationCoefficients: []
      BoundaryConditions: []
       InitialConditions: []
                    Mesh: []
           SolverOptions: [1x1 pde.PDESolverOptions]

Input Arguments

StructuralAnalysisType — Type of structural analysis

'static-solid' | 'static-planestress' | 'static-planestrain' | 'static-axisymmetric' | 'transient-solid' | 'transient-planestress' | 'transient-planestrain' | 'transient-axisymmetric' | 'modal-solid' | 'modal-planestress' | 'modal-planestrain' | 'modal-axisymmetric' | 'frequency-solid' | 'frequency-planestress' | 'frequency-planestrain' | 'frequency-axisymmetric'

Type of analysis, specified as one of the following values.

For static analysis, use these values:

• 'static-solid' to create a structural model for static analysis of a solid (3-D) problem.

• 'static-planestress' to create a structural model for static analysis of a plane-stress problem.

• 'static-planestrain' to create a structural model for static analysis of a plane-strain problem.

• 'static-axisymmetric' to create an axisymmetric (2-D) structural model for static analysis.

For transient analysis, use these values:

• 'transient-solid' to create a structural model for transient analysis of a solid (3-D) problem.

• 'transient-planestress' to create a structural model for transient analysis of a plane-stress problem.

• 'transient-planestrain' to create a structural model for transient analysis of a plane-strain problem.

• 'transient-axisymmetric' to create an axisymmetric (2-D) structural model for transient analysis.

For modal analysis, use these values:

• 'modal-solid' to create a structural model for modal analysis of a solid (3-D) problem.

• 'modal-planestress' to create a structural model for modal analysis of a plane-stress problem.

• 'modal-planestrain' to create a structural model for modal analysis of a plane-strain problem.

• 'modal-axisymmetric' to create an axisymmetric (2-D) structural model for modal analysis.

For frequency response analysis, use these values:

• 'frequency-solid' to create a structural model for frequency response analysis of a solid (3-D) problem.

• 'frequency-planestress' to create a structural model for frequency response analysis of a plane-stress problem.

• 'frequency-planestrain' to create a structural model for frequency response analysis of a plane-strain problem.

• 'frequency-axisymmetric' to create an axisymmetric (2-D) structural model for frequency response analysis.

For axisymmetric models, the toolbox assumes that the axis of rotation is the vertical axis passing through r = 0.

Example: model = createpde('structural','static-solid')

Data Types: char | string

ThermalAnalysisType — Type of thermal analysis

'steadystate' | 'transient' | 'steadystate-axisymmetric' | 'transient-axisymmetric'

Type of thermal analysis, specified as one of the following values:

• 'steadystate' creates a steady-state thermal model. If you do not specify ThermalAnalysisType for a thermal model, createpde creates a steady-state model.

• 'transient' creates a transient thermal model.

• 'steadystate-axisymmetric' creates an axisymmetric (2-D) thermal model for steady-state analysis.

• 'transient-axisymmetric' creates an axisymmetric (2-D) thermal model for transient analysis.

For axisymmetric models, the toolbox assumes that the axis of rotation is the vertical axis passing through r = 0.

Example: model = createpde('thermal','transient')

Data Types: char | string

ElectromagneticAnalysisType — Type of electromagnetic analysis

'electrostatic' | 'magnetostatic' | 'electrostatic-axisymmetric' | 'magnetostatic-axisymmetric'

Type of electromagnetic analysis, specified as one of the following values:

• 'electrostatic' creates a 2-D model for electrostatic analysis.

• 'magnetostatic' creates a 2-D model for magnetostatic analysis.

• 'electrostatic-axisymmetric' creates an axisymmetric (2-D) model for electrostatic analysis.

• 'magnetostatic-axisymmetric' creates an axisymmetric (2-D) model for magnetostatic analysis.

Example: model = createpde('electromagnetic','electrostatic')

Data Types: char | string

N — Number of equations

1 (default) | positive integer

Number of equations, specified as a positive integer. You do not need to specify N for a model where N = 1.

Example: model = createpde

Example: model = createpde(3);

Data Types: double

Output Arguments

structuralmodel — Structural model

StructuralModel object

Structural model, returned as a StructuralModel object.

Example: structuralmodel = createpde('structural','static-solid')

thermalmodel — Thermal model

ThermalModel object

Thermal model, returned as a ThermalModel object.

Example: thermalmodel = createpde('thermal','transient')

emagmodel — Electromagnetic model

ElectromagneticModel object

Electromagnetic model, returned as an ElectromagneticModel object.

Example: thermalmodel = createpde('electromagnetic','magnetostatic')

model — PDE model

PDEModel object

PDE model, returned as a PDEModel object.

Example: model = createpde(2)