ProteinMotion
Reference navigation
On this page

CLASS · v0.9.1

Representation

Transition between cartoon, ribbon, ball-and-stick, and surface.

python
from proteinmotion import Representation

Constructor

python
Representation(protein, representation, **kwargs)

Parameters

ParameterDefaultDescription
proteinRequiredProtein object to read or animate.
representationRequired"cartoon", "ribbon", "ball_and_stick", or "surface".
**kwargsAdditional keyword options described below or in the linked constructor.

Additional keyword arguments

ParameterDefaultDescription
rate_funckeyword onlysmoothCallable that maps progress in [0, 1] to a finite value in [0, 1].

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
python
p = ubiquitin().surface(resolution=0.7).cartoon()
frame(self, p)
self.wait(1)
for name in ("ribbon", "ball_and_stick", "surface"):
    self.play(Representation(p, name), run_time=1.2)
    self.play(Rotate(p, 0.45), run_time=1.5)
Output Preview · 9.1 s · 60 fps
Representation changes

Cartoon, ribbon, ball-and-stick, and SES surface.

Methods and properties

NameDescription
bind()methodCapture starting values when the scene schedules the animation.
apply()methodEvaluate the animation at eased progress alpha. Called by the timeline.
targetsproperty · inherited from AnimationObjects whose state this animation changes.
python
Representation.bind()

Capture starting values when the scene schedules the animation.

Returns: None

Called by ProteinScene.play(). An animation instance can be bound once.

python
Representation.apply(alpha)

Evaluate the animation at eased progress alpha. Called by the timeline.

ParameterDefaultDescription
alphaRequiredEased animation progress in [0, 1].

Returns: None

Inherited from animation.Animation.

python
Representation.targets

Objects whose state this animation changes.