COMSOL Multiphysics Programming Reference Manual

C o n t a c t I n f o r m a t i o n

Visit the Contact COMSOL page at www.comsol.com/contact to submit general inquiries, contact Technical Support, or search for an address and phone number. You can also visit the Worldwide Sales Offices page at www.comsol.com/contact/offices for address and contact information.

If you need to contact Support, an online request form is located at the COMSOL Access page at www.comsol.com/support/case. Other useful links include:

• Support Center: www.comsol.com/support

• Product Download: www.comsol.com/product-download

• Product Updates: www.comsol.com/support/updates

• COMSOL Blog: www.comsol.com/blogs

• Discussion Forum: www.comsol.com/community

• Events: www.comsol.com/events

• COMSOL Video Gallery: www.comsol.com/video

• Support Knowledge Base: www.comsol.com/support/knowledgebase

Part number: CM020007

C O M S O L M u l t i p h y s i c s ® P r o g r a m m i n g R e f e r e n c e M a n u a l© 1998–2018 COMSOL

Protected by patents listed on www.comsol.com/patents, and U.S. Patents 7,519,518; 7,596,474; 7,623,991; 8,457,932; 8,954,302; 9,098,106; 9,146,652; 9,323,503; 9,372,673; and 9,454,625. Patents pending.

This Documentation and the Programs described herein are furnished under the COMSOL Software License Agreement (www.comsol.com/comsol-license-agreement) and may be used or copied only under the terms of the license agreement.

COMSOL, the COMSOL logo, COMSOL Multiphysics, COMSOL Desktop, COMSOL Server, and LiveLink are either registered trademarks or trademarks of COMSOL AB. All other trademarks are the property of their respective owners, and COMSOL AB and its subsidiaries and products are not affiliated with, endorsed by, sponsored by, or supported by those trademark owners. For a list of such trademark owners, see www.comsol.com/trademarks.

Version: COMSOL 5.4

www.comsol.com/patents/http://www.comsol.com/comsol-license-agreement/http://www.comsol.com/contact/http://www.comsol.com/contact/offices/http://www.comsol.com/support/case/http://www.comsol.com/support/http://www.comsol.com/product-download/http://www.comsol.com/support/updates/http://www.comsol.com/trademarks/http://www.comsol.com/blogs/http://www.comsol.com/community/http://www.comsol.com/events/http://www.comsol.com/video/http://www.comsol.com/support/knowledgebase/

C o n t e n t s

C h a p t e r 1 : I n t r o d u c t i o n

About the COMSOL API 16

Where Do I Find More Information? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Getting Started 18

The Model Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Compiling a Model File for Java® . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18The Model File for Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Running a Compiled Model File for Java from the Desktop . . . . . . . . . . . . . . . . . . . . . . 20

Running a Compiled Model File as a Batch Job from the Desktop . . . . . . . . . . . . . . . . . . . 20

Running a Compiled Model File with the COMSOL Batch Command . . . . . . . . . . . . . . . . . . 20

Getting the COMSOL Installation Path from the Windows Registry . . . . . . . . . . . . . . . . . . 20

Setting up Eclipse for Compiling and Running a Java® File . . . . . . . . . . . . . . . . . . . . . . 20

C h a p t e r 2 : G e n e r a l C o m m a n d s

About General Commands 24

Overview of General-Purpose Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

get* and Selection Access Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

set() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

setEntry(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

setIndex() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Methods Associated to Set, SetIndex, and the Various Get Methods . . . . . . . . . . . . . . . . . . 29

Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Selection Color Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

The loadFile and saveFile Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Inserting Features from Other Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

ModelUtil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

model.attr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

model.attr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

model.batch() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

model.bem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

model.capeopen() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

model.coeff() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

model.common() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

model.component() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

model.constr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

model.coordSystem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

model.cpl() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

model.elem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

model.elementSet() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

model.extraDim() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

model.field(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

model.form() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

model.frame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

model.func(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

C O N T E N T S | 3

model.geom() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

model.group() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

model.init() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

model.intRule() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

model.massProp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

model.material() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

model.mesh() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

model.methodCall() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

model.modelNode(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

model.multiphysics() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

model.nodeGroup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

model.ode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

model.opt() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Least-Squares Objective Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

model.pair() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

model.param() and model.result().param() . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

model.physics() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

model.probe() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

model.reduced() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

model.result() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

model.savePoint() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

model.selection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

model.shape() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

model.sol() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

model.solverEvent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

model.study() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

model.unitSystem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

model.variable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

model.view() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

model.weak() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Plotting and Exporting Images 177

Errors and Warnings 180

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Retrieving Problem Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

C h a p t e r 3 : G e o m e t r y

About Geometry Commands 184

Features for Creating Geometric Primitives . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Features for Geometric Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Selection Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Features for Virtual Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Features for Mesh Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Geometry Object Information Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Working with a Geometry Sequence 190

Adding a Model Component (Geometry). . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Adding a Geometry Feature. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Editing a Geometry Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Building Geometry Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

4 | C O N T E N T S

Feature Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Accessing Geometry Object Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Deleting and Disabling Geometry Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Deleting Geometry Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Moving and Scaling Geometry Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Plotting a Geometry Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Geometry Settings 195

Length Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Angular Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Scale Values When Changing Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Geometry Representation in 3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Default Repair Tolerances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Automatic Rebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Work Planes 198

Selections of Geometric Entities 199

Named Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Using Selection Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Cumulative Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Virtual Operations 201

About Virtual Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Mesh Control Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Geometry Object Information 202

General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Geometric Entity Counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

Adjacency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

Evaluation on an Edge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Evaluation on a Face. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Geometry Representation Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Measurements 207

Measuring Geometric Entities in Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Measuring Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Inserting Geometry Sequences from File 208

Example of Importing Geometry Sequences. . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Exporting Geometry to File 209

Exporting to an ACIS File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Exporting to a Parasolid File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Exporting to an STL File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

Compatibility for mphbin/mphtxt in 2D and 3D . . . . . . . . . . . . . . . . . . . . . . . . . 210

Using Geometry Parts 211

Geometry Commands 213

AdjacentSelection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

BallSelection, BoxSelection, CylinderSelection, Disk Selection . . . . . . . . . . . . . . . . . . . . 217

BezierPolygon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

C O N T E N T S | 5

Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Chamfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Circle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

CollapseEdges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

CollapseFaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

CollapseFaceRegions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

Compose, Union, Intersection, Difference . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

CompositeDomains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

CompositeEdges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

CompositeFaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Cone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

ConvertToSolid, ConvertToSurface, ConvertToCurve, ConvertToPoint. . . . . . . . . . . . . . . . 235

CrossSection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Cylinder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

ECone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

EditObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Ellipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Ellipsoid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

ExplicitSelection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Extrude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Fillet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Finalize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

FromMesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Helix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

Hexahedron. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

If, ElseIf, Else, EndIf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

IgnoreEdges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

IgnoreFaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

IgnoreVertices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Import DXF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Import Geometry Sequence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Import Mesh Part or Meshing Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Import mphbin/mphtxt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

Interpolation Curve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

LineSegment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

MergeEdges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

MergeVertices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

MeshControlDomains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

MeshControlEdges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

MeshControlFaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

MeshControlVertices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

Mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Move, Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

ParameterCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

ParametricCurve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

ParametricSurface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

PartInstance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

PartitionDomains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

PartitionEdges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

PartitionFaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

6 | C O N T E N T S

Polygon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

Pyramid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Rectangle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

RemoveDetails. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Revolve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

Rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

Sphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

Split . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

Square . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Tangent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Tetrahedron . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Torus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

UnionSelection, IntersectionSelection, DifferenceSelection, ComplementSelection . . . . . . . . . . . . 314

WorkPlane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

C h a p t e r 4 : M e s h

About Mesh Commands 324

Operation Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Attribute Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Features for Imported Meshes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Working with a Meshing Sequence 326

Adding a Meshing Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

Adding a Mesh Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

Editing a Mesh Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

Building Mesh Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

Using Mesh Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Feature Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Deleting Mesh Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Disabling Mesh Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

Clearing Meshes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

Physics-Controlled Meshing 331

Mesh Sequence Methods for Physics Contributing to the Mesh Control Suggestions . . . . . . . . . . . 331

Adaptively Refined Meshes 333

Information and Statistics 334

Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Number and Types of Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

Quality of Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

Volume of Elements and Mesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Growth Rate in Mesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

Mesh Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

Getting and Setting Mesh Data 338

Accessing Mesh Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

C O N T E N T S | 7

Setting or Modifying Mesh Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Block Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Mesh Element Numbering Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Errors and Warnings 343

Continuing Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Stopping Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

The MeshError Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

The MeshWarning Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Exporting Meshes to Files 344

Exporting Mesh to a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

Exporting Mesh to a COMSOL Multiphysics File . . . . . . . . . . . . . . . . . . . . . . . . . 344

Exporting Mesh to a NASTRAN® File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

Mesh Commands 346

Adapt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Ball . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

BndLayer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

BndLayerProp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

Convert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

CopyEdge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

CopyFace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

CopyDomain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

CornerRefinement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

CreateVertex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Cylinder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

DeleteEntities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

DetectFaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

Edge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

EdgeGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

EdgeMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

FreeQuad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

FreeTet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

FreeTri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

JoinEntities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

LogicalExpression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

OnePointMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Refine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

SizeExpression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

TwoPointMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

8 | C O N T E N T S

C h a p t e r 5 : E l e m e n t s a n d S h a p e F u n c t i o n P r o g r a m m i n g

Shape Functions and Element Types 392

Shape Function Types (Elements) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

C h a p t e r 6 : S o l v e r s a n d S t u d y S t e p s

About Solver Commands 400

Features Producing and Manipulating Solutions . . . . . . . . . . . . . . . . . . . . . . . . . 400

Features with Solver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Solution Object Information Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Solution Feature Information Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403

Solution Object Data 404

General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

Solution Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

SolutionInfo Object and Its Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

Solution Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

General Matrix Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

Matrix Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

Matrix Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Adaption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

Advanced. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

Assemble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

AutoRemesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

AWE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417

CombineSolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

CopySolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Eigenvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

EigenvalueParam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

FFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

For, EndFor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426

FullyCoupled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

InputMatrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

Linear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

Lower Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

Lumped Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

Modal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443

Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

Parametric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

PlugFlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

Previous Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

Segregated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

SegregatedStep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

Sensitivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

StatAcceleration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

StateSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

Stationary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

StopCondition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457

StoreSolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

StudyStep. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

C O N T E N T S | 9

TimeAdaption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

TimeDiscrete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

TimeExplicit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

TimeParametric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

XmeshInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

Studies and Study Steps 476

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

Batch Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

Bidirectionally Coupled Particle Tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479

Bidirectionally Coupled Ray Tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481

Cluster Computing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

Cluster Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

Eigenfrequency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

Eigenvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

Frequency Domain and Frequency Domain Perturbation . . . . . . . . . . . . . . . . . . . . . . 491

Frequency to Time FFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

Function Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

Material Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

Model Reduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497

Multigrid Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499

Parametric Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

Ray Tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501

Schrödinger-Poisson . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

Sensitivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

Stationary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507

Time Dependent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510

Time Discrete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512

Time to Frequency FFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514

C h a p t e r 7 : R e s u l t s

About Results Commands 518

Commands Grouped by Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

Use of Data Sets 525

Extracting and Storing Plot Data 528

Retrieving Plot Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

Retrieving Numerical Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

Storing and Clearing Plot Data in the Model . . . . . . . . . . . . . . . . . . . . . . . . . . 530

Solution Selection 531

About Selecting Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

Selecting Solutions by Solution Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

Selecting Solutions by Solution Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

Choosing Solution Selection Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

Results Commands 533

Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533

10 | C O N T E N T S

Annotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537

AnnotationData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

Array 1D, Array 2D, Array3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541

ArrowData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542

ArrowVolume, ArrowSurface, ArrowLine, ArrowPoint . . . . . . . . . . . . . . . . . . . . . . 545

AvVolume, AvSurface, AvLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548

Average, Integral, Maximum, Minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552

Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553

Contour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

Contour (Data Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558

CoordSysLine, CoordSysSurface, CoordSysVolume . . . . . . . . . . . . . . . . . . . . . . . . 559

CutLine2D, CutLine3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

CutPlane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

CutPoint1D, CutPoint2D, CutPoint3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566

Deform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

Directivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

Edge2D, Edge3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

Eval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

EvalAberration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

EvalGlobal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577

EvalGlobalMatrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

EvalPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583

EvalPointMatrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

EvaluationGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

Extrude1D, Extrude2D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

Filter (Particle Tracing, Point Trajectories, Ray Tracing,) . . . . . . . . . . . . . . . . . . . . . . 592

Global (Numerical) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

Global (Plot) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595

Grid1D, Grid2D, Grid3D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

Height, AberrationHeight, HistogramHeight, TableHeight . . . . . . . . . . . . . . . . . . . . . 600

Histogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602

Image1D, Image2D, Image3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606

ImpulseResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

InterferencePattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

Interp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614

IntersectionPoint2D, IntersectionPoint3D . . . . . . . . . . . . . . . . . . . . . . . . . . . 616

IntVolume, IntSurface, IntLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618

Isosurface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621

Isosurface (Data Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625

Join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625

LayeredShell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626

LayeredShellSlice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627

Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630

LineData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635

LineGraph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637

MatrixHistogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641

MaxMinVolume, MaxMinSurface, MaxMinLine, MaxMinPoint . . . . . . . . . . . . . . . . . . . . 644

MaxVolume, MaxSurface, MaxLine, MinVolume, MinSurface, MinLine . . . . . . . . . . . . . . . . . 646

Mesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

Mesh (Data Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650

Mesh (Export) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651

C O N T E N T S | 11

Mirror2D, Mirror3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652

Multislice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653

Nyquist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657

OctaveBand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660

OpticalAberration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663

Parametric1D, Parametric2D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665

ParCurve2D, ParCurve3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

ParSurface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667

Particle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668

Particle (1D Plot) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673

Particle (Data Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676

Particle (Evaluation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677

ParticleBin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679

ParticleMass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680

ParticleTrajectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

PhasePortrait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689

Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691

PlotGroup1D, PlotGroup2D, PlotGroup3D. . . . . . . . . . . . . . . . . . . . . . . . . . . 692

PoincareMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699

PointData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701

PointGraph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703

PointTrajectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707

PolarGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

PrincipalLine, PrincipalSurface, PrincipalVolume . . . . . . . . . . . . . . . . . . . . . . . . . 713

RadiationPattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716

Ray (1D Plot) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721

Ray (Data Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

Ray (Evaluation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

RayBin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

RayTrajectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

Receiver2D, Receiver3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

ReflectionGraph, ImpedanceGraph, AdmittanceGraph . . . . . . . . . . . . . . . . . . . . . . . 732

ResponseSpectrum2D, ResponseSpectrum3D . . . . . . . . . . . . . . . . . . . . . . . . . . 736

Revolve1D, Revolve2D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738

ScatterVolume, ScatterSurface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739

Sector2D, Sector3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743

Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744

Shell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745

Slice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745

SmithGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751

Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753

Streamline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754

StreamlineSurface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760

Surface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764

Surface (Data Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769

SurfaceData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769

SurfaceSlit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772

SystemMatrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777

Table (Export) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780

Table (Plot) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781

TableSurface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783

TimeAverage, TimeIntegral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786

ThroughThickness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787

12 | C O N T E N T S

TubeData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792

Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794

Waterfall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797

Whirl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 800

C h a p t e r 8 : G r a p h i c a l U s e r I n t e r f a c e s

Getting Started 804

Example Graphical User Interface 805

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805

Downloading Extra Material. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 806

Creating the Code for the Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 806

Construction of the Initial GUI with Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . 807

Handling of Progress Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 809

Setting Up Inputs From the GUI to the Model . . . . . . . . . . . . . . . . . . . . . . . . . . 810

Displaying Results in the GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812

Other Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 813

GUI Classes 817

ProgressContext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817

ProgressWorker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817

SWTGraphicsPanel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818

SwingGraphicsPanel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818

C h a p t e r 9 : T h e C O M S O L F i l e F o r m a t s

File Formats 820

Data Formats 821

Spreadsheet Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821

Grid Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822

Sectionwise Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822

Supported Microsoft Excel File Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

Color Tables, Cycle Colors, and Color Themes 824

About Color Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

Continuous Color Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

Discrete Color Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

About Cycle Colors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

About Color Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

Binary Data Files and Text Data Files 827

File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 827

Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828

Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828

Text File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828

Binary File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 829

Serializable Types 830

Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830

C O N T E N T S | 13

BezierCurve. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831

BezierMfd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832

BezierSurf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

BezierTri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

BSplineCurve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 834

BSplineMfd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835

BSplineSurf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 836

Ellipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837

Geom0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838

Geom1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839

Geom2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839

Geom3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

Manifold . . . . . . . . . . . . . . . . . . . . . . . . .