Model.createipimpact#

Model.createipimpact(instrumentpanelids=hwIntList(), steeringwheelids=hwIntList(), windscreenids=hwIntList(), headerpartsids=hwIntList(), leftsrp=hwTriple(0.0, 0.0, 0.0), rightsrp=hwTriple(0.0, 0.0, 0.0), lhsarealimit=82.500000, rhsarealimit=127.0, armlenmin=736.0, armlenmax=840.0, armlenstepsize=0.0, armlength=800.0, headformdia=165.0, rotationstep=3.0, offsetvec=hwTriple(127.0, 0.0, 19.0), regulation=0, vehiclefrontaxis=hwTriple(1.0, 0.0, 0.0), targetpointsdistance=0.0, targetpointsmethod=0, ysectionpoints=3, driverside=0)#

Creates marking lines and impact points on the instrument panel of a vehicle. For correct export of the solver deck, the headform and the vehicle parts files should be imported as separate includes. Also, the headform and the vehicle must be aligned to global coordinate axes and vehicle front should be pointing in either +X or -X direction.

Parameters:
  • instrumentpanelids (hwIntList) – The list of component IDs of the instrument panel of the vehicle.

  • steeringwheelids (hwIntList) – The list of component IDs of the steering wheel of the vehicle.

  • windscreenids (hwIntList) – The list of component IDs of the windscreen of the vehicle.

  • headerpartsids (hwIntList) – The list of component IDs of the header parts of the vehicle.

  • leftsrp (hwTriple) – The hwTriple object defining the left seat reference point coordinates of the vehicle. User can also supply a Python list of three doubles.

  • rightsrp (hwTriple) – The hwTriple object defining the right seat reference point coordinates of the vehicle. User can also supply a Python list of three doubles. Either leftsrp or rightsrp must be specified.

  • lhsarealimit (double) – The distance offset from either the leftmost point on instrument panel or from the steering wheel (takes priority), if defined, beyond which impact points will not be created. Default value is 82.5.

  • rhsarealimit (double) – The distance offset from the rightmost extremum on the instrument panel beyond which impact points will not be created. Default value is 127.0.

  • armlenmin (double) – The minimum arm lengths which will define the impact zone. Default value is 736.0.

  • armlenmax (double) – The maximum arm lengths which will define the impact zone. Default value is 840.0

  • armlenstepsize (double) –

    The step size to create the marking lines between armlenmin and armlenmax. This is used to calculate the number of equidistant intermediate marking lines (\(x\)), where \(x\) is rounded down as following:

    \(x = \frac{armlenmax - armlenmin}{armlenstepsize}\)

    Default value is 0.0 which means no intermediate marking lines and impact points are created.

  • armlength (double) – The arm length to be used for creating the positioning entities. Default value is 800.0.

  • headformdia (double) – The diameter of the headform to be used for positioning. Default value is 165.0.

  • rotationstep (double) – The rotation step size as angle in degrees with which upon rotating around the seat reference point for a specific arm length and colliding the sphere on instrument panel will give impact points and the line joining these impact points will be the marking line. Default value is 3.0 degrees.

  • offsetvec (hwTriple) – The hwTriple object defining the travel vector to define the offset point to seat reference point. User can also supply a Python list of three doubles. This is the front seat reference point (left or right), which is used to create the front boundary zone line using armlenmax distance as arm length of the impactor/sphere. Default value is [127.0, 0, 19.0].

  • regulation (int) –

    The applied regulation.

    0 - FMVSS201 (default)

    1 - ECE-R21

  • vehiclefrontaxis (hwTriple) – The hwTriple object defining the vehicle front axis [-1, 0, 0] for -X direction and [1, 0, 0] for +X direction. User can also supply a Python list of three doubles. Default value is [1, 0, 0] (+X direction).

  • targetpointsdistance (double) – The distance to create points on marking line using distance method. After getting marking line with contact method the equidistant impact points are created along the line from center by given length targetpointsdistance. Default value is 0.

  • targetpointsmethod (int) – Reserved for future development.

  • ysectionpoints (int) – Reserved for future development.

  • driverside (int) – Reserved for future development.

Example#

Create mark lines and impact on the instrument panel#
import hm
import hm.entities as ent

model = hm.Model()

model.createipimpact(
    instrumentpanelids=[
            2000684,
            2000730,
            2000731,
            2000732,
            2000734,
            2000735,
            2000742,
            2000743,
    ],
    steeringwheelids=[2000675, 2000701, 2000702, 2000704],
    windscreenids=[2000290, 2000647, 2000648],
    headerpartsids=[2000019, 2000020, 2000182, 2000222, 2000277],
    leftsrp=[2300.0, -400.0, 500.0],
    rightsrp=[2300.0, -400.0, 500.0],
    vehiclefrontaxis=[-1.0, 0.0, 0.0],
)