*createentity

Create a new entity with specified data.

Syntax

*createentity entity_type ?modelname=<name_of_model>? ?name1=value1? ?name2=value2? ... ?name3=valueN?

Type

HyperMesh Tcl Modify Command

Description

Create a new entity with specified data. Data names only are allowed to be set. If the data name “name” is specified when creating an entity enabled for the name pool, the command uses the provided name to define the solver name.

There are also a few limitations to this command:
  • Attributes are not supported.
  • STATUS is not supported.

Inputs

entity_type
Entity type to create.
<name>=<value>
The name=value data name and/or attribute pairs that define the relevant data for the entity. For attributes, this can be either the attribute name or ID.
For entity attributes, both the entity type and the entity IDs must be provided. For example:
*setvalue elements id=7 3222={elems 3}
modelname=<name_of_model>
This is the optional model name to update when there are multiple models in the database. If not specified, the current model is used.

Examples

Create a set with a default set type and name.
*createentity sets
Create a set of type nodes and node IDs 1-4:
*createentity sets type=1 ids={1 2 3 4}
Create a set with name set1, cardimage GRNOD:
*createentity sets name=set1 cardimage=GRNOD

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

13.0

2020.1 - Added new option modelname.