itasca.contact

Functions and classes for working with Itasca contacts.

Functions

itasca.contact.count(<process: str>, <type: TypeObject>, <all=False>) → int.

Get the number of contacts. All the arguments to this function are optional. The first argument is the contact class, this defaults to “mechanical”. If the (optional) keyword argument type is given the count is limited to that type. The type keyword argument should be a Python type object (itasca.BallBallContact, itasca.BallFacetContact, itasca.BallPebbleContact, itasca.PebblePebbleContact or itasca.PebbleFacetContact). If the (optional) keyword argument all is given, virtual contacts are included in the count.

itasca.contact.energy(energy_name: str, process="mechanical", type=TypeObject) → float.

Get energy values accumulated over contacts. The first argument should be the name of an energy quantity. Two optional keyword arguments are accepted, process which should be a string (defaults to “mechanical”) and type which should be a Python contact type object.

itasca.contact.find(type: TypeObject, id: int or (object1, object2)) → Contact object.

Get the contact of the given type, the second argument is either an integer ID or a length two tuple containing two objects (for example a wall object and a ball object).

itasca.contact.list(process_name="Mechanical", type=None, all=False) → Contact iterator object.

Get a contact iterator object. The optional argument is the name of a process, the default is “mechanical”. If the (optional) keyword argument type is given the returned contacts are limited to that type. The type keyword argument should be a Python type object (itasca.BallBallContact, itasca.BallFacetContact, itasca.BallPebbleContact, itasca.PebblePebbleContact or itasca.PebbleFacetContact). If the (optional) keyword argument all is given, virtual contacts are also returned.

Classes