track

Track Kinematics Module.

Provides a kinematic model for calculating the motion state of a tracked vehicle.

Classes:

Name	Description
`TrackKinematics`	Track kinematics class.

TrackKinematics

TrackKinematics(params: VehicleParams | None = None)

Track kinematics class.

Encapsulates global parameters within the class to avoid side effects during import and allows different instances to use different parameters.

Parameters:

Name	Type	Description	Default
`params`	`VehicleParams \| None`	Vehicle parameter configuration object. If not provided, it instantiates with default parameters.	`None`

Methods:

Name	Description
`step_track_kinematics`	Performs a single-step integration using the 4th-order Runge-Kutta (RK4) solver.

step_track_kinematics(state, Fx1, Fx2, Fy1, Fy2, Mr1, Mr2, Md1, Md2, R1, R2)

Performs a single-step integration using the 4th-order Runge-Kutta (RK4) solver.

Calculates the new kinematic state after a time step dt based on the input force parameters and the current state.

Parameters:

Name	Type	Description	Default
`state`	`list or ndarray`	Current state vector [vx, vy, omega].	required
`Fx1`	`float`	Left longitudinal force.	required
`Fx2`	`float`	Right longitudinal force.	required
`Fy1`	`float`	Left lateral force.	required
`Fy2`	`float`	Right lateral force.	required
`Mr1`	`float`	Left resistance moment.	required
`Mr2`	`float`	Right resistance moment.	required
`Md1`	`float`	Left driving moment.	required
`Md2`	`float`	Right driving moment.	required
`R1`	`float`	Left resistance.	required
`R2`	`float`	Right resistance.	required

Returns:

Type	Description
	np.ndarray: New state vector [vx, vy, omega] after dt time.