Acceleration and Deceleration Ramping

Acceleration and deceleration ramping lets the speed of the motion ramp cleanly between two different setpoints. The Automation1 controller uses acceleration and deceleration ramping when it creates the velocity profile for moves generated by MoveAbsolute(), MoveIncremental(), MoveFreerun(), MoveRapid(), MoveLinear(), MoveCw(), and MoveCcw(). The controller also uses acceleration and deceleration ramping during home moves and when it aborts moves.

Velocity Profile of a Move

When an axis is commanded to move, the controller generates a velocity profile, which is used to calculate position and velocity values at the time interval specified by the MotionUpdateRate Parameter and send these values to the position loop of the servo loop. The velocity profile usually includes the ramp segments that follow.

• Acceleration segment - the portion of the velocity profile in which the velocity ramps between the starting velocity and the target velocity.
• Constant velocity segment - the portion of the velocity profile during which the velocity stays at the target velocity.
• Deceleration segment - the portion of the velocity profile in which the velocity ramps between the target velocity and the ending velocity.

Figure: Acceleration and Deceleration

Ramp Types

The Automation1 controller lets you select one of three different ramp types to use when you generate a velocity profile for a move.

• Linear
• Sinusoidal (Half-Sine)
• S-Curve

Figure: Linear, Half-Sine, and S-curve Ramping

For each ramp type, the ramp rate that you specify is the average acceleration value of the full ramp. Thus, different ramp types have different peak accelerations, as in the above figure.

Linear Ramp Type

For a linear ramp, the controller uses a constant acceleration value, the configured ramp rate, to ramp the velocity from one setpoint to another. A linear ramp has these properties:

• The peak acceleration value is equal to the average acceleration value throughout the ramp.
• This type of ramping causes the lowest possible peak acceleration.
• The ramp immediately gets to peak acceleration.
• High jerk values can occur at the ramp boundaries.

To set the ramp type to Linear, specify the Linear ramp type in the SetupCoordinatedRampType() function.

SetupCoordinatedRampType(RampType.Linear)

Sinusoidal (Half-Sine) Ramp Type

A half-sine ramp type uses an acceleration value that follows a half-cycle of a sine wave whose amplitude is set so that the average value across the ramp is equal to the configured ramp rate. A half-sine ramp has these properties:

• The peak acceleration value is 1.57 times the average acceleration value.
• This type of ramping causes higher peak accelerations than the linear ramp type.
• The ramp gradually gets to peak acceleration.
• Jerk values are lower than those of the linear ramp type.

To set the ramp type to Sinusoidal, specify the Sine ramp type in the SetupCoordinatedRampType() function.

SetupCoordinatedRampType(RampType.Sine)

S-Curve Ramp Type

An S-Curve ramp type uses a percentage value to find how much of the acceleration ramp is non-constant acceleration.

Figure: Velocity Profile - S-CURVE 50

During the curved portions of the acceleration ramp, the jerk is constant. A larger S-Curve percentage causes a lower constant jerk value.

An S-Curve ramp with 0% curvature is the same as a Linear ramp and has a peak acceleration of 1.0 times the average acceleration. An S-Curve ramp with 100% curvature has a peak acceleration of 2.0 times the average acceleration.

An S-Curve ramp has these properties:

• The peak acceleration value is 2.0 times the average acceleration value at the maximum curvature percentage.
• This type of ramping causes higher peak accelerations than the linear ramp type.
• The ramp gradually gets to peak acceleration.
• The S-Curve percentage supplies some control over how high the jerk value will be.

To set the ramp type to S-Curve, specify the SCurve ramp type and the curvature percentage that you want in the SetupCoordinatedRampType() function.

SetupCoordinatedRampType(RampType.SCurve, 50.0)

Ramp Modes

The Automation1 controller supports two ramp modes:

• Rate-based ramping
• Time-based ramping

These modes affect how the controller generates acceleration and deceleration ramps.

SetupCoordinatedRampValue(RampMode.Rate, 2000.0)

SetupCoordinatedRampValue(RampMode.Time, 0.5)		

Ramping Functions and Parameters

The Automation1 controller supplies AeroScript API functions and controller parameters to configure the ramping behavior.

Configure Ramping for Independent Axis Motion

For independent axis moves such as MoveAbsolute(), MoveIncremental(), MoveFreerun(), and MoveRapid() use the functions at the end of this section to configure ramping. Because the controller does motion on each axis independently, you must configure ramping for each axis.

The controller also supplies the axis parameters that follow to configure the default ramping behavior of axis-based moves:

• DefaultAxisRampMode Parameter
• DefaultAxisRampRate Parameter
• DefaultAxisRampTime Parameter
• DefaultAxisRampType Parameter

Refer to Motion Setup Functions for more information on the available functions.

function SetupAxisRampValue($axis as axis, $rampMode as RampMode, $rampValue as real)

Sets a ramp value for both accelerations and decelerations simultaneously for an axis.

Arguments

$axis  The axis on which to set the ramp value.

$rampMode  The ramping mode to set.

$rampValue  The ramp value to set.

enum RampMode

enum RampMode    Rate = 0    Time = 1 end

function SetupAxisRampValue($axes[] as axis, $rampMode as RampMode, $rampValue as real)

Sets a ramp value for both accelerations and decelerations simultaneously for axes.

Arguments

$axes  The axes on which to set the ramp value.

$rampMode  The ramping mode to set.

$rampValue  The ramp value to set.

enum RampMode

enum RampMode    Rate = 0    Time = 1 end

function SetupAxisRampValue($axis as axis, $rampModeAccel as RampMode, $rampValueAccel as real, $rampModeDecel as RampMode, $rampValueDecel as real)

Sets a ramp value for accelerations and decelerations separately for an axis.

Arguments

$axis  The axis on which to set the ramp value.

$rampModeAccel  The ramping mode to set during accelerations.

$rampValueAccel  The ramp value to set during accelerations.

$rampModeDecel  The ramping mode to set during decelerations.

$rampValueDecel  The ramp value to set during decelerations.

enum RampMode

enum RampMode    Rate = 0    Time = 1 end

function SetupAxisRampValue($axes[] as axis, $rampModeAccel as RampMode, $rampValueAccel as real, $rampModeDecel as RampMode, $rampValueDecel as real)

Sets a ramp value for accelerations and decelerations separately for axes.

Arguments

$axes  The axes on which to set the ramp value.

$rampModeAccel  The ramping mode to set during accelerations.

$rampValueAccel  The ramp value to set during accelerations.

$rampModeDecel  The ramping mode to set during decelerations.

$rampValueDecel  The ramp value to set during decelerations.

enum RampMode

enum RampMode    Rate = 0    Time = 1 end

function SetupAxisRampType($axis as axis, $rampType as RampType)

Sets a ramp type for both accelerations and decelerations simultaneously for an axis.

Arguments

$axis  The axis on which to set the ramp type.

$rampType  The ramping type to set.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupAxisRampType($axes[] as axis, $rampType as RampType)

Sets a ramp type for both accelerations and decelerations simultaneously for an axis.

Arguments

$axes  The axes on which to set the ramp type.

$rampType  The ramping type to set.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupAxisRampType($axis as axis, $rampType as RampType, $rampTypeArg as real)

Sets a ramp type along with a ramp type value for both accelerations and decelerations simultaneously for an axis.

Arguments

$axis  The axis on which to set the ramp type.

$rampType  The ramping type to set.

$rampTypeArg  The ramping type additional argument. This is only used when $rampType is RampType.SCurve and represents the s-curve percentage.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupAxisRampType($axes[] as axis, $rampType as RampType, $rampTypeArg as real)

Sets a ramp type along with a ramp type value for both accelerations and decelerations simultaneously for axes.

Arguments

$axes  The axes on which to set the ramp type.

$rampType  The ramping type to set.

$rampTypeArg  The ramping type additional argument. This is only used when $rampType is RampType.SCurve and represents the s-curve percentage.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupAxisRampType($axis as axis, $rampTypeAccel as RampType, $rampTypeArgAccel as real, $rampTypeDecel as RampType, $rampTypeArgDecel as real)

Sets a ramp type along with a ramp type value for accelerations and decelerations separately for an axis.

Arguments

$axis  The axis on which to set the ramp type.

$rampTypeAccel  The ramping type to set during accelerations.

$rampTypeArgAccel  The ramping type additional argument for accelerations. This is only used when $rampTypeAccel is RampType.SCurve and represents the s-curve percentage.

$rampTypeDecel  The ramping type to set during decelerations.

$rampTypeArgDecel  The ramping type additional argument for decelerations. This is only used when $rampTypeDecel is RampType.SCurve and represents the s-curve percentage.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupAxisRampType($axes[] as axis, $rampTypeAccel as RampType, $rampTypeArgAccel as real, $rampTypeDecel as RampType, $rampTypeArgDecel as real)

Sets a ramp type along with a ramp type value for accelerations and decelerations separately for axes.

Arguments

$axes  The axes on which to set the ramp type.

$rampTypeAccel  The ramping type to set during accelerations.

$rampTypeArgAccel  The ramping type additional argument for accelerations. This is only used when $rampTypeAccel is RampType.SCurve and represents the s-curve percentage.

$rampTypeDecel  The ramping type to set during decelerations.

$rampTypeArgDecel  The ramping type additional argument for decelerations. This is only used when $rampTypeDecel is RampType.SCurve and represents the s-curve percentage.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

Configure Ramping for Coordinated Motion

For coordinated moves such as MoveLinear(), MoveCw(), MoveCcw(), use the functions in this section to configure ramping. Because coordinated motion synchronizes motions on multiple axes, you must configure ramping for each task instead of for each axis.

The controller supplies the task parameters that follow to configure the default ramping behavior of coordinated moves:

• DefaultCoordinatedRampMode Parameter
• DefaultCoordinatedRampRate Parameter
• DefaultCoordinatedRampTime Parameter
• DefaultCoordinatedRampType Parameter
• DefaultDependentCoordinatedRampRate Parameter

Refer to Motion Setup Functions for more information on the available functions.

function SetupCoordinatedRampValue($rampMode as RampMode, $rampValue as real)

Sets a coordinated ramp value for both accelerations and decelerations simultaneously for dominant axes on the current task.

Arguments

$rampMode  The ramping mode to set.

$rampValue  The ramp value to set.

enum RampMode

enum RampMode    Rate = 0    Time = 1 end

function SetupCoordinatedRampValue($rampModeAccel as RampMode, $rampValueAccel as real, $rampModeDecel as RampMode, $rampValueDecel as real)

Sets a coordinated ramp value for accelerations and decelerations separately for dominant axes on the current task.

Arguments

$rampModeAccel  The ramping mode to set during accelerations.

$rampValueAccel  The ramp value to set during accelerations.

$rampModeDecel  The ramping mode to set during decelerations.

$rampValueDecel  The ramp value to set during decelerations.

enum RampMode

enum RampMode    Rate = 0    Time = 1 end

function SetupCoordinatedRampType($rampType as RampType)

Sets a coordinated ramp type for both accelerations and decelerations simultaneously for dominant axes on the current task.

Arguments

$rampType  The ramping type to set.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupCoordinatedRampType($rampType as RampType, $rampTypeArg as real)

Sets a coordinated ramp type along with a ramp type value for both accelerations and decelerations simultaneously for dominant axes on the current task.

Arguments

$rampType  The ramping type to set.

$rampTypeArg  The ramping type additional argument. This is only used when $rampType is RampType.SCurve and represents the s-curve percentage.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end

function SetupCoordinatedRampType($rampTypeAccel as RampType, $rampTypeArgAccel as real, $rampTypeDecel as RampType, $rampTypeArgDecel as real)

Sets a coordinated ramp type along with a ramp type value for accelerations and decelerations separately for dominant axes on the current task.

Arguments

$rampTypeAccel  The ramping type to set during accelerations.

$rampTypeArgAccel  The ramping type additional argument for accelerations. This is only used when $rampTypeAccel is RampType.SCurve and represents the s-curve percentage.

$rampTypeDecel  The ramping type to set during decelerations.

$rampTypeArgDecel  The ramping type additional argument for decelerations. This is only used when $rampTypeDecel is RampType.SCurve and represents the s-curve percentage.

enum RampType

enum RampType    Linear = 0    SCurve = 1    Sine = 2 end