ProteinMotion
Reference navigation
On this page

Conceal

Close the open cutaway.

View sourceGuide and examplesInherits Reveal
python
from proteinmotion import Conceal

Constructor

python
Conceal(
    camera,
    region=None,
    *,
    window=None,
    softness=None,
    band=None,
    shape=None,
    wall=None,
    rings=None,
    padding=None,
    surface_keep=None,
    rim=None,
    **kwargs,
)

Parameters

ParameterDefaultDescription
cameraRequiredThe scene camera that owns the cutaway.
regionNoneRegion selection attached to a protein.
windowkeyword onlyNoneWindow radius, as a multiple of the region's bounding radius.
softnesskeyword onlyNoneFraction of the window used for its fading edge, in (0, 1].
bandkeyword onlyNoneDepth in Å over which geometry just in front of the region fades back in.
shapekeyword onlyNone"cone" for a window that faces the camera, or "tunnel" for a depth tunnel fixed to the molecule.
wallkeyword onlyNoneTunnel wall opacity.
ringskeyword onlyNoneTunnel ring spacing in Å, measured from where the tunnel meets open space.
paddingkeyword onlyNoneExtra highlight size in ångströms. None selects a default for the highlight style.
surface_keepkeyword onlyNoneFraction of the inner kept region for the cutaway surface, in [0, 1].
rimkeyword onlyNoneRim-light intensity, or a cutaway rim RGB/hex color for Reveal.
**kwargs—Additional keyword options described below or in the linked constructor.

Example and output

Run this command from a repository checkout.

Code Render command
bash
proteinmotion render examples/depth_tunnels.py DepthTunnels \
  --fps 60 -o tunnels.mp4
Output Preview · 64.4 s · 60 fps
How deep is it?

Tunnels into GroEL–GroES, with a ring every 5 Å, compare the ADP pocket 21 Å beneath the outer surface with residues on the ring's inner wall 44 Å down. A ghosted side view, a fly-down, and a carved surface follow.

Full source: DepthTunnels Download MP4

Methods and properties

NameDescription
bind()method · inherited from RevealCapture starting values when the scene schedules the animation.
apply()method · inherited from RevealEvaluate the animation at eased progress alpha. Called by the timeline.
during()method · inherited from AnimationSet this animation duration and start delay in seconds.
targetsproperty · inherited from AnimationObjects whose state this animation changes.

bind()

View source

Inherited from animation.Reveal.

python
Conceal.bind()

Capture starting values when the scene schedules the animation.

Returns: None

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

apply()

View source

Inherited from animation.Reveal.

python
Conceal.apply(alpha)

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

ParameterDefaultDescription
alphaRequiredEased animation progress in [0, 1].

Returns: None

during()

View source

Inherited from animation.Animation.

python
Conceal.during(seconds, *, delay=0)

Set this animation duration and start delay in seconds.

ParameterDefaultDescription
secondsRequiredPositive animation duration in seconds.
delaykeyword only0Nonnegative animation start delay in seconds.

targets

View source

Inherited from animation.Animation.

python
Conceal.targets

Objects whose state this animation changes.