findInitialConditions

R2026b

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])

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