findInitialConditions

Locate active initial conditions

Syntax

ic = findInitialConditions(ics,RegionType,RegionID)

Description

ic = findInitialConditions(ics,RegionType,RegionID) returns the active initial condition assignment ic for the initial conditions in the specified region.

Examples

Find the Active Initial Conditions

This example shows find the active initial conditions for a region.

Create a PDE model that has a few subdomains.

model = createpde();
geometryFromEdges(model,@lshapeg);
pdegplot(model,"FaceLabels","on")
ylim([-1.1,1.1])
axis equal

Set initial conditions on each pair of regions.

setInitialConditions(model,12,"Face",[1,2]);
setInitialConditions(model,13,"Face",[1,3]);
setInitialConditions(model,23,"Face",[2,3]);

Check the initial conditions specification for region 1.

ics = model.InitialConditions;
ic = findInitialConditions(ics,"Face",1)

ic = 
  GeometricInitialConditions with properties:

           RegionType: 'face'
             RegionID: [1 3]
         InitialValue: 13
    InitialDerivative: []

Input Arguments

ics — Model initial conditions

InitialConditions property of a PDE model

Model initial conditions, specified as the InitialConditions property of a PDE model. Initial conditions can be complex numbers.

Example: model.InitialConditions

RegionType — Geometric region type

"Edge" for a 2-D model | "Face" for a 2-D model or 3-D model | "Cell" for a 3-D model

Geometric region type, specified as "Edge" for a 2-D model, "Face" for a 2-D model or 3-D model, or "Cell" for a 3-D model.

Example: ca = findInitialConditions(ics,"Face",[1,3])

Data Types: char | string

RegionID — Region ID

vector of positive integers

Region ID, specified as a vector of positive integers. View the subdomain labels for a 2-D model using pdegplot(model,"FaceLabels","on"). Currently, there are no subdomains for 3-D models, so the only acceptable value for a 3-D model is 1.

Example: ca = findInitialConditions(ics,"Face",[1,3])

Data Types: double

Output Arguments

ic — Initial condition assignment

GeometricInitialConditions object | NodalInitialConditions object

Initial condition assignment, returned as a GeometricInitialConditions Properties or NodalInitialConditions Properties object.

Version History

Introduced in R2016a