Part Instance
Use a Part Instance node to call and instantiate a geometry part in the model component’s geometry sequence. The geometry part can be a global part defined under one Global>Parts of a locally defined part. To create an instance of a geometry part, right-click a geometry and select one of the global parts from the Parts submenu. This adds a Part Instance node (), which builds an instance of the part with new values of its input parameters (arguments). Enter the properties of the part instance using the following sections:
Part
Choose the part to create an instance of from the Part list. You can choose among the parts defined under Global>Parts. You can also choose Local part (the default if no other parts exist), which means that the part is defined by the Local Part node ( in 3D) beneath the Part Instance node. To choose the part from the Part Libraries, click Choose from Library. You can then choose a part and click Add to Geometry. The part then also appears under Global>Parts.
Input Parameters
The Name column of the table contains the input parameters required by the part. In the Expression column, enter the corresponding expressions. The expressions can contain parameters defined under Global Definitions. The defaults are the default expressions defined in the Input Parameters section for the part that you create an instance of. The values of the expressions appear in the Value column. The Description column contains the descriptions given by the part.
You can import or load data in files from a spreadsheet program, for example, with the Load from file button () and the Load dialog box that appears. You can also click the downward arrow beside the Load from File button and choose Load From () to open the fullscreen Select File window. Data must be separated by spaces or tabs. If the license includes LiveLink™ for Excel® you can also load input parameters from a Microsoft Excel Workbook spreadsheet.
Thumbnail
This section contains the associated descriptive image of the part, if available in the loaded part contains a thumbnail image. See Creating a Part for information about adding thumbnail images to parts.
Position and Orientation of Output
Use this section to specify the translation and rotation to apply to the output objects (not in 1D).
In 3D, this transformation is done in two steps:
In 2D, only the second step of the transformation is available.
Coordinate system in part
Choose the coordinate system from the part from the Work plane in part list. You can choose among all work planes defined in the part. You can also choose xy-plane, which corresponds to the global coordinate system (this is the default). The selected work plane becomes the “base plane” for the part instance’s position.
Coordinate system to match
To choose the coordinate system to match, first make a choice in the Take work plane from list. The default is This sequence, which means that you can select a work plane feature from this sequence. You can also choose another Part Instance above this one in the geometry sequence, which means that you take the work plane from the other Part Instance node. In both cases, you select the work plane to match in the Work plane list. The default is xy-plane, which corresponds to the global coordinate system. The work plane to match is visualized in the graphics.
Displacement
Enter values or expressions for the xw, yw, and zw coordinates (SI unit: m) to add a displacement vector relative to the coordinate system to match.
Rotation
In 3D, from the Specify list, choose Axis of rotation (the default), Euler angles (Z-X-Z), or Edge as the way to specify the rotation.
For Axis of rotation, select an Axis type: xw-axis, yw-axis, zw-axis (the default), Cartesian, or Spherical. For any choice, enter a Rotation angle (SI unit: degrees; default 0) to specify the rotation. If Cartesian is selected, enter Cartesian coordinates values for xw, yw, and zw (default values 0, 0, and 1, respectively, corresponding to the global zw-axis) to specify the axis vector. If Spherical is selected, specify the axis vector using spherical angles theta and phi in degrees (default: 0).
For Euler angles (Z-X-Z), enter values for the intrinsic Z-X-Z Euler angles α, β, and γ in the corresponding text fields (in degrees; the default values are 0).
For Edge, select a straight edge in the Graphics window by first enabling the selection in the Straight edge list. Using a preselection, you can add it using the Add to Selection button (). Use the Clear Selection button () to remove the selected straight edge and the Zoom to Selection button () to zoom into the selected straight edge.
In 2D, you can specify a displacement vector in the x-displacement and y-displacement fields and a rotation angle (in degrees) in the Rotation angle field.
Object Selections
When you have built the Part Instance feature, the table shows the names of the output object selections that are defined by the part and there set to show in instances of the part. When you click a row in the table, the corresponding selection is highlighted in the graphics. These selections are available for use as input to following geometry features if kept, and also, optionally, available in the physics and materials, for example. You can unite selections from several Part Instance nodes using a cumulative selection. If you want a selection to contribute to a cumulative selection, choose that cumulative selection from the corresponding list in the Contribute to column. To contribute to a new cumulative selection, click the selection in the table and then the New Cumulative Selection button. This opens a dialog box where you can specify the name of the cumulative selection. Select the Keep check box to keep the selection for use in other nodes in the geometry sequence below this node.
Domain/Boundary/Edge/Point Selections
These sections are similar to the Object Selections section. If the Keep check box is selected, the Physics (Instances when used in another geometry part; 3D when used in a plane geometry for a work plane) check box, when selected (which it is by default), makes that selection also available when defining, for example, physics and materials (Physics), in the part instances (Instances), or in 3D (3D).
Selection Settings
Select the Keep noncontributing selections check box to disable the Keep column and keep all selections that do not contribute to a cumulative selection. This setting is the default in the COMSOL API and corresponds to the behavior in earlier COMSOL versions.
Assigned Attributes
Select the Construction geometry check box to make the resulting objects available only in the feature’s geometry sequence. For more information, see Construction Geometry.