InstallationΒΆ

Crazyswarm runs on Ubuntu Linux in one of the following configurations:

Ubuntu

Python

ROS

20.04

3.7

Noetic

18.04

2.7

Melodic

For simulation-only operation, Mac OS is also supported. Click the appropriate tab(s) below to see the installation instructions for your desired configuration.

Note

You must set the environment variable $CSW_PYTHON to the name of your Python interpreter (e.g. python2 or python3) before building.

Warning

The Windows Subsystem for Linux (WSL) is not supported. You must install Ubuntu either directly on the computer (recommended) or in a VM.

You can write/debug pycrazyswarm scripts on a machine that does not have ROS installed. On Mac OS, Crazyswarm must run within an Anaconda environment. On Linux, using Anaconda is optional. Select your platform from the tabs below:

  1. Set the $CSW_PYTHON environment variable:

    $ export CSW_PYTHON=[python2 or python3]
    
  2. Install Anaconda Python 2.7 / 3.7 version (We have tested on version 2019.10).

  3. Clone the Crazyswarm git repository:

    $ git clone https://github.com/USC-ACTLab/crazyswarm.git
    
  4. Create the Anaconda environment with your desired Python version:

    $ cd crazyswarm
    $ conda create --name crazyswarm python=$CSW_PYTHON
    $ conda env update -f conda_env.yaml
    
  5. Activate the Anaconda environment:

    $ conda activate crazyswarm
    
  6. Run the build script:

    $ ./buildSimOnly.sh
    
  7. Verify the installation by running the unit tests:

    $ cd ros_ws/src/crazyswarm/scripts
    $ $CSW_PYTHON -m pytest
    

Once you have completed installation, move on to the Configuration section and configure Crazyswarm for your hardware.