Hello!

Did you know that logged in users can see a lot more content?

Assign Sequential UDAs

Last updated October 18, 2018 by Area Finland Service tekla.support.fi@trimble.com

Software version: 
Not version-specific
Environment: 
Not environment-specific

Assign Sequential UDAs

Contents

This tool is used to assign sequential numbers to model parts. The numbers are stored as user defined attribute (UDAobject property created by the user in order to widen the range of predefined object properties

User-defined attributes are used when the predefined object properties are not sufficient but more properties are needed. For example, comment, locked, and erection status are user-defined attributes.

) values.

Tool can be found from macrosaved series of actions that includes instructions for a program

Macros are located in the applications and components catalog. They are recorded or created manually and stored as .cs file in a folder defined with the advanced option XS_MACRO_DIRECTORY.

Macros can, for example, be used for creating drawings or reports.

Macros are sometimes used to run an application.

cataloguser interface for displaying or modifying information in categorized lists

For example, profile catalog and shape catalog are catalogs.

(Tools -> Macros).

(From Tekla Structures version 2016 onwards this tool is available from Application and Components Catalog.)

Purpose and description
Using Assign Sequential UDAs
Additional information
Examples

Purpose and description

This tool is used as a helping tool for numberingprocess of assigning position numbers to parts, cast units, assemblies, or reinforcement

In Tekla Structures, the position numbers assigned in the numbering are shown in marks and templates, for example.

model objects.

The UDAs that are presented in the field “UDA” are read from Tekla Structures catalogs. The tool reads all UDA fields that are of the type INT or STRING. Note that the tool ignores Tekla Structures key fields

After extracting the attributes the tool orders them alphabetically and inserts them in the user interface.

Using Assign Sequential UDAs

To be able to use this tool user has to choose the work planeplane that the user has chosen in a model and that is currently active for working on in a model view

Newly created, copied, or moved model objects comply with the work plane. For example, shifting the work plane to follow a sloped plane makes it easier to model sloped structures.

where he wants to number the selected objects. The numbering is based on sorting the model objects by X and Y coordinates. If you are numbering parts in a wallplate that represents a structure such as a wall or roof panel

In Tekla Structures, a panel is created by picking two or more points.

, set the current work plane into wall plane. After the work plane setting you should select the desired model objects and press the ‘Number Selected’ button.

The sorting group defines the type of sorting the tool will do. Sort type defines what will be the points to be used by the sorting method:

  • If you choose ‘By Part Coordinates’ the tool uses the point (start or end point) that has the highest current coordinate system Z value. This numbering option can be used for example for numbering piles, anchor bolts or dowels.
  • If you choose ‘By Center of Gravity’ the sorting is based on the center of gravity point. This numbering option can be used for example for numbering wall elements.

The object numbering group information defines the way the numbering will appear in the chosen user defined attribute. Some user interface fields are disabled for integer type attributes as they can only store numbers, not for example prefix or group number.

 

In the example below user has chosen:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Numbering, Start numberfirst number of a numbering series

    : 1
  • Grouping, Start number: 1 

Picture: normal sequential numbering without a group number
Picture: normal sequential numbering without a group number

 

Picture: group numbering has been used, group 1 on the left and group 2 on the right
Picture: group numbering has been used, group 1 on the left and group 2 on the right
 

The numbering algorithm is the same if ‘Overwrite Existing UDA’ is ticked or not – the number is just not written to such objects that already have a value stored for this UDA.

Additional information

  • If you want to add user defined attributes to be loaded by this tool, add the attributes in to the objects.inp.

Examples

Below one can see an example where the user should sort the wall parts using the center of gravity.
 

In the example below:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Object Numbering, Start number: 1
  • Object Numbering, Prefix: A-
  • Object Numbering, Sorting tolerancepermissible amount by which the dimensions of a structure may vary from the work size specified

    Tolerance is usually stated as a plus or minus dimension.

    The term ’tolerance’ is used in its general sense in Tekla Structures.

    In a model the term ’tolerance’ should not be used to refer to a gap.

    : 510
     

In the example below:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Object Numbering, Start number: 1
  • Object Numbering, Prefix: A-
  • Object Numbering, Sorting tolerance: 490

The 2 examples showed above show us the usage of the sorting tolerance and its effects on numbering. In this case the smaller numbers have smaller X value. When the X value is the same it checks the Y value. In the example on top when we use a tolerance of 510mm the sorting method assumes that the top right panel and the bottom right panel COG are in the same location and it checks its Y coordinate value.

Below there is another example where it can be seen the importance of the sorting tolerance.

In the example below:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Object Numbering, Start number: 1
  • Object Numbering, Sorting tolerance: 190mm

In the example below:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Object Numbering, Start number: 1
  • Object Numbering, Sorting tolerance: 180mm

In the example below it is shown the effects of the sorting ‘Combine distance’:

Below:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Object Numbering, Start number: 001
  • Object Numbering, Combine distance: 2.4m

Below:

  • Sort order: First X, then Y
  • X: Ascending
  • Y: Ascending
  • Object Numbering, Start number: 001
  • Object Numbering, Combine distance: 2.2m

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our documentation.
We use this to prevent automated spam submissions.
Content rating: 
No votes yet

Comments

by Dave Renninger

We can't get this application to work in v2017i and newer versions. It shows in the Extension Manager, but not in the Applications and Components Catalog. Please advise.

by Area Finland Service

We haven't faced that issue here. Please remove the extension and reinstall it. If it doesn't help, please contact your local support for further assistance.

by Steven Burton

I cannot seem to get the numbering in Z direction to work. Is their any guidance on this available?

by Area Finland Service

On the "Sorting" -tab, select Z Sorting "by Assembly bottom",
then define correct Z levels (assembly bottom levels) for your objects.

Use "first level serie" to add that value (in case of numeric values) between different levels.

Br,
Juha Nieminen