Deform

Interpolate coordinates toward the result of a user-supplied function.

View source Guide and examplesInherits Morph

from proteinmotion import Deform

Constructor

Deform(protein, function, **kwargs)

Parameters

Parameter	Default	Description
`protein`	Required	Protein object to read or animate.
`function`	Required	Callable receiving a copy of the coordinates and returning an array of the same shape.
`**kwargs`	—	Additional keyword options described below or in the linked constructor.

Additional keyword arguments

Parameter	Default	Description
`rate_func`keyword only	`smooth`	Callable that maps progress in [0, 1] to a finite value in [0, 1].

Notes

The function runs when the animation is scheduled. It must return finite coordinates with the original shape. This operation creates an illustrative shape change.

Example and output

This excerpt runs inside a scene’s construct() method. The full example file includes imports, structure loading, and camera setup. Run it from a repository checkout.

Code Scene excerpt

p = ubiquitin()
frame(self, p, margin=1.05)
rest = p.positions.copy()

def stretch(xyz):
    center = xyz.mean(axis=0)
    return center + (xyz - center) * [1.4, 1, 1]

self.play(Deform(p, stretch), run_time=2)
self.wait(0.5)
self.play(Morph(p, rest, align=False), run_time=2)
self.wait(0.5)

Output Preview · 5.0 s · 60 fps

Deformation and morph

A synthetic stretch followed by a return to the original coordinates.

Full source: Deformation Download MP4

Methods and properties

Name	Description
bind()method	Capture starting values when the scene schedules the animation.
apply()method · inherited from Morph	Evaluate the animation at eased progress alpha. Called by the timeline.
targetsproperty · inherited from Animation	Objects whose state this animation changes.