Install
Pyugvswarm runs on Ubuntu Linux in one of the following configurations:
Ubuntu |
Python |
ROS |
20.04 |
3.7 |
Noetic |
18.04 |
2.7 |
Melodic |
Install dependencies for real experiment:
# If you use mocap for positioning, then you should install vrpn
# change 'noetic' into 'melodic' for ubuntu18:
sudo apt install -y ros-noetic-vrpn-client-ros
# If you use UWB for positioning, then you should build `nlink_parser` (https://www.nooploop.com/download) ROS package for nooploop UWB module:
cd ~
mkdir -p nlink_parser_ws/src
cd nlink_parser_ws/src
git clone --recursive https://gitee.com/shu-peixuan/nlink_parser.git
cd ../
catkin_make
catkin_make
echo "source ~/nlink_parser_ws/devel/setup.bash" >> ~/.bashrc
There are three methods to install pyugvswarm python package:
Install pyugvswarm
python package from source:
git clone https://gitee.com/shu-peixuan/pyugvswarm.git
cd pyugvswarm/
pip install -e . # use pip3 if you use python3 in ubuntu18
Check you have pyugvswarm package in your PYTHON environment:
pip show pyugvswarm # use pip3 if you use python3 in ubuntu18
Then you can import pyugvswarm
class in your python scripts in any folders.
To uninstall pyugvswarm:
pip uninstall pyugvswarm # use pip3 if you use python3 in ubuntu18
You can simply copy the pyugvswarm/pyugvwarm/
folder and optionally config/
folder into your project:
git clone https://gitee.com/shu-peixuan/pyugvswarm.git
cp -r pyugvswarm/pyugvswarm ${your_scripts_path}
cp -r pyugvswarm/config ${your_scripts_path} # optional
The folder structure should be like this:
|__ Your scripts folder
|_ pyugvswarm/
|_ config/
| |_ ugvs.yaml
|_ your_python_script.py
Write your python scripts directly in this repository like the example.py
.
git clone https://gitee.com/shu-peixuan/pyugvswarm.git
cd pyugvswarm/
touch your_python_script.py