Agitation

agit(...) represents mixing or agitation applied to an existing sample, container, or carrier-like target.

It is separate from transfer. Use << for material movement and agit(...) for actions such as vortexing, inversion, shaking, or stirring. It still belongs near material mutation because it changes how a material state is physically handled without creating readout data or an environment scope.

Examples

agit(sample = tube, mode = vortex, duration = 30s, rate = 2000rpm);

agit(sample = tube, mode = invert, cycles = 10);

agit(sample = tube, mode = stir, duration = 60s, rate = 500rpm);

Arguments

Argument	Required	Meaning
sample	yes	Container or group being agitated.
mode	yes	vortex, invert, shake, or stir.
duration	mode-dependent	Time duration.
rate	mode-dependent	Agitation intensity, commonly rpm.
cycles	mode-dependent	Count for inversion-style agitation.

Mode Rules

Mode	Allowed fields	Not allowed
vortex	duration, rate	cycles
invert	cycles	duration, rate
shake	duration, rate	cycles
stir	duration, rate	cycles

cycles is not combined with duration or rate.

Environment Interaction

agit.duration and env.duration are different.

• agit.duration is how long the agitation action lasts.
• env.duration is the duration of the environmental condition.

When an agitation step is inside an environment block, the action duration must fit within the environment duration.