Surfaces

class SurfaceHandle

TODO

Attach(entity, cutoff)

Attach an EntityHandle or EntityView to a molecular surface. For each vertex of the surface, the atom which is closest to this vertex and within the cutoff distance is attached. Like this, the atom and its properties can be retrieved efficiently, which is e.g. used for coloring a surface according to the underlying entity (see gfx.Surface.ColorBy()).

Be aware that increasing the cutoff distance will significantly increase the time needed to attach an entity to the surface.

Parameters:
  • entity (EntityHandle, EntityView) – entity to be attached to the surface

  • cutoff (float) – distance cutoff

Return type:

None

FindWithin(position, cutoff)

Returns all surface vertices within a certain cutoff distance of a specified position.

Parameters:
  • position (Vec3) – position

  • cutoff (float) – distance cutoff

Return type:

SurfaceVertexList

GetTriIDList()

Returns a list containing all IDs of all triangles of a surface.

Return type:

list of ints

GetVertex(id)

Returns a SurfaceVertex with the specified ID.

Parameters:

id (int) – vertex id

Return type:

SurfaceVertex

GetVertexIDList()

Returns a list containing all IDs of all vertices of a surface.

Return type:

list of ints

Invert()

Does an in place inversion of all vertex normal vectors.

Return type:

None

class SurfaceVertex

TODO

SurfaceVertex()
SurfaceVertex(pos, norm, type, atom)

Creates a new SurfaceVertex.

Parameters:
  • pos (geom.Vec3) – vertex position

  • norm (geom.Vec3) – vertex normal vector

  • type (int) – vertex type

  • atom (AtomHandle) – attached atom

Atom

AtomHandle attached to the surface vertex.

The AtomHandle is invalid, if no EntityHandle has been attached or if no atom was found within the cutoff distance.

See SurfaceHandle.Attach() for further details.

Type:

AtomHandle

Normal

Normal vector of the surface vertex.

Type:

Vec3

Position

Spatial position of the surface vertex.

Type:

Vec3

class SurfaceVertexList
append(vertex)

Add a single surface vertex.

Parameters:

vertex (SurfaceVertex) – surface vertex

Return type:

None

extend(list)

Add a list of surface vertices.

Parameters:

list (SurfaceVertexList) – list of surface vertices

Return type:

None

class SurfaceTriIDList
append(id)

Add a single triangle ID.

Parameters:

id (int) – trinangle vertex id

Return type:

None

extend(list)

Add a list of triangle IDs.

Parameters:

list (list of ints) – list of triangle vertex ids

Return type:

None