quadx88 0.3.1

QUADx88

Configurable dynamical model of quadcopter

API documentation

The Quadcopter Class

To construct a quadcopter object we can call the constructor

import quadx88 as qx

copter = qx.Quadcopter(mass=1.15, 
                       ts=0.0083,
                       prop_mass=0.01)

The following parameters can be provided to the above constructor

Getters

Setters

To initialise the state of the system the following methods are available

1. set_initial_quaternion(q), where q is the quaternion
2. set_initial_angular_velocity(w)
3. set_initial_motor_spin(spin)
4. set_initial_euler_angles(yaw, pitch, roll, angle_unit=ANGLE_UNITS.RADIANS), where yaw, pitch and roll and the three Euler angles (in this order) and angle_unit is the units of measurement. For example to construct a quadcopter object with an initial attitude of $\phi=0^\circ$, $\theta=1^\circ$ and $\psi=-5^\circ$ we can do

copter = qx.Quadcopter()
copter.set_initial_euler_angles(-5, 0, 1, ANGLE_UNITS.DEGREES)

System matrices

The methods continuous_linearised_matrices and discrete_linearised_matrices return a dictionary with the continuous-time and discrete-time matrices of the linearised system respectively. The discrete-time linearised system has the form $$\begin{aligned} x_{t+1} =& Ax_t + Bu_t, \ y_t =& Cx_t. \end{aligned}$$

Nonlinear dynamical system

To simulate the nonlinear model you can use move(u) which updates the system state following the application of a given control action for the duration of the sampling time.