KOMPAS-3D v23

Step-by-step instructions

1.Prepare the parametric model, which will be Template family, and create family table.

2.Invoke the Model family command in the template.

3.Click on the name of the Table field on the Parameters toolbar. In the dialog box that appears, choose the family table file and click Open.
If the table contains at least two rows - a header and a row with instance parameters - the Specimens of the family field will appear on the Parameter panel. In this field, a list of instances will be displayed, the parameters of which are extracted from the specified table. For each item in the list, the number (enclosed in parentheses) and the file name are indicated. Instances are numbered automatically: the first row after the header row of the table is considered to belong to instance №1, the second row to instance №2, and so on.
Please note: Instances where only the number is displayed in the Specimens of the family field cannot be created, as no file name is defined for them.
Instance parameters are extracted from the family table and included in the family template file.

4.Setup file instances placement. If the family table is specified, the folder containing the instance table is automatically selected for saving instances — the path to it is displayed in the Directory of family field. Regardless of whether a table is set, you can choose any folder as a family catalog. To do this, click the name of the Directory of family field and specify the required folder.
Clicking the icon in the Directory of family field means selecting a folder containing the family table if specified, and removing the path if the table is not specified.

5.If necessary, perform the following actions by clicking the required button on the Parameter panel:

•Reread — repeated extraction of data from the table. Rereading is required if the table was modified during the current session with the Model Family command.

•Check — checking correctness of parameters specified in the table for the instances selected in the list. If none of the instances is selected, then all are checked. After the end of the check, a dialog appears on the screen with the message "Check completed successfully" or with a list of found errors.

•Apply — application to the parameter template of the selected instance in the list. This allows you to preview a future instance. If no instance is selected or multiple are selected, the button is unavailable.

6.Select the instance rows whose files need to be created and click Generate . The files are stored in the folder specified in the Directory of family field. If no single line is selected, all instances are generated.
Instance generation involves applying the specified parameters for it — values of variables and properties — to the family template and saving it in this form. Parameters not set in the table retain the values they had in the template at the moment the generation was initiated.
If at the moment of starting the generation there are already model files in the family catalog with names identical to the instance names, they will be overwritten.

7.To confirm the changes and finish the command, click .

8.To cancel the changes and finish the command, click . If instances of a family were created while working with the command, they will not be deleted.

Errors in the family table identified during checking. Recommendations on fixing

If the family table check results in errors, a dialog appears on the screen indicating the numbers of instances with errors and descriptions of these errors.

•Undefined one or several parameters — means that one or several cells of the table, which are supposed to contain parameter values, are empty.
This error does not prevent the generation of the file instance. The parameters that are not set for it in the table will have the same values as they had in the template model at the time of generation.
To correct the error, check the table and fill the empty cells. If the table contains empty rows or columns, delete them.

•The file name contains invalid characters means that the cell(s) under the "File name" column header contain characters that are not allowed for use in file names (\ / : * ? " < > |).
This error prevents generation of instance file.
To fix the error, check the 'File name' column in the table and remove forbidden characters from it.

•File name of the family instance is not unique — means that two or more cells in the column with the header 'File Name' contain the same value.
This error prevents the generation of the instance file.
To correct the error, check the 'File Name' column in the table and resolve any duplicates.

After correcting the table, save it, return to editing the template and run the Model family command, if it was completed. In the command, click Reread to get the new parameter values from the family table, and then click Check to verify the parameter corrections. If no new errors are detected, generate all instances or only those that had errors.

See Also

Model family: Overview

Model family: Example

Update family