Model.importdummyfrompositioningfile#

Model.importdummyfrompositioningfile(file)#

Creates a mechanism entity of config 3 by reading a positioner file that ends with the “.pos” extension. The “.pos” file is typically obtained from the Visual-Safe application to define a dummy for the PAM-CRASH 2G solver.

Expects only a single dummy per positioner file. The following requirements need to be met:

  1. One “GROUP…ENDGROUP” block exists with the “COR” followed by a valid node ID from the model.

  2. The lines that start with “ARTICULATION” must be followed by the lines that define the rotation angle limits.

  3. The joint elements referred to in the “ARTICULATION” line must be of “JOINT /” or “KJOIN /” type.

  4. The root to leaf body paths defined within the “DEFCONF…ENDDEFCONF” should not have multiple root bodies.

  5. The “ENDDEFSYSTEM” is treated as the end-of-file.

Parameters:

file (hwString) – The absolute path to the file with an extension “.pos” defining the dummy metadata.

Example#

Create a dummy by read the positioner file with the full file path “ C:/dummy.pos “ provided the relevant input decks have been imported in the session#
import hm
import hm.entities as ent

model = hm.Model()

model.importdummyfrompositioningfile(file="C:/dummy.pos")