itasca.ballballarray

Array interface for Itasca ball-ball contacts.

Functions

itasca.ballballarray.branch() → array float{contact,3}.

Get a numpy array of the contact branch vectors in the global coordinate system.

itasca.ballballarray.extra(slot: int) → array float{contact} or float{contact,3}.

Get the contact extra data in the given slot as an array. Extra variables accessed by array must be of type float or vec.

itasca.ballballarray.fill_branch(data: array float{contact, 3}) → None.

Fill an existing array with the contact branch vectors in the global coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_force_global(data: array float{contact, 3}) → None.

Fill an existing array with the contact force in the global coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_force_local(data: array float{contact, 3}) → None.

Fill an existing array with the contact force in the local coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_force_normal(data: array float{contact}) → None.

Fill an existing array with the contact normal force. The array must be the correct shape.

itasca.ballballarray.fill_force_shear(data: array float{contact}) → None.

Fill an existing array with the contact shear force magnitude. The array must be the correct shape.

itasca.ballballarray.fill_gap(data: array float{contact}) → None.

Fill an existing array with the contact gap. The array must be the correct shape.

itasca.ballballarray.fill_moment1_global(data: array float{contact, 3}) → None.

Fill an existing array with the contact moment acting on end 1 in the global coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_moment1_local(data: array float{contact, 3}) → None.

Fill an existing array with the contact moment acting on end 1 in the local coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_moment2_global(data: array float{contact, 3}) → None.

Fill an existing array with the contact moment acting on end 2 in the global coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_moment2_local(data: array float{contact, 3}) → None.

Fill an existing array with the contact moment acting on end 2 in the local coordinate system. The array must be the correct shape.

itasca.ballballarray.fill_normal(data: array float{contact, 3}) → None.

Fill an existing array with the contact normal. The array must be the correct shape.

itasca.ballballarray.fill_offset(data: array float{contact, 3}) → None.

Fill an existing array with the contact offset. The array must be the correct shape.

itasca.ballballarray.fill_pos(data: array float{contact, 3}) → None.

Fill an existing array with the contact position. The array must be the correct shape.

itasca.ballballarray.force_global() → array float{contact,3}.

Get a numpy array of the contact force in the global coordinate system.

itasca.ballballarray.force_local() → array float{contact,3}.

Get a numpy array of the contact force in the local coordinate system.

itasca.ballballarray.force_normal() → array float{contact}.

Get a numpy array of the contact normal force.

itasca.ballballarray.force_shear() → array float{contact}.

Get a numpy array of the contact shear force magnitude.

itasca.ballballarray.gap() → array float{contact}.

Get a numpy array of the contact gap.

itasca.ballballarray.ids() → array int{contact}.

Get the contact ids as an array.

itasca.ballballarray.in_group(group_name: str, slot=1) → array bool{contact}.

Return contact group membership as a Boolean array.

itasca.ballballarray.indices() → array int64{contact,2}.

Get a numpy array of the indices of the balls on end1 and end2 of the contacts. The ball indices are relative to the ball arrays returned by the itasca.ballarray module.

itasca.ballballarray.moment1_global() → array float{contact,3}.

Get a numpy array of the contact moment acting on end 1 in the global coordinate system.

itasca.ballballarray.moment1_local() → array float{contact,3}.

Get a numpy array of the contact moment acting on end 1 in the local coordinate system.

itasca.ballballarray.moment2_global() → array float{contact,3}.

Get a numpy array of the contact moment acting on end 2 in the global coordinate system.

itasca.ballballarray.moment2_local() → array float{contact,3}.

Get a numpy array of the contact moment acting on end 2 in the local coordinate system.

itasca.ballballarray.normal() → array float{contact,3}.

Get a numpy array of the contact normal.

itasca.ballballarray.offset() → array float{contact,3}.

Get a numpy array of the contact offset.

itasca.ballballarray.pos() → array float{contact,3}.

Get a numpy array of the contact position.

itasca.ballballarray.set_extra(slot: int, data: array float{contact} or float{contact, 3}) → None.

Set the contact extra data in the given slot with an array. Extra variables set by array must be of type float or vec.

itasca.ballballarray.set_group(membership: array bool{contact}, group_name: str, slot=1) → None.

Set contact group from an array. Where membership True set the corresponding contact to be a member of group group_name in the given slot.