Skip to main content

A lightweight Python Robot simulator

Project description

aitk.robots

PyPI version CI build status

A lightweight Python robot simulator for Jupyter Lab, Notebooks, and other environments.

Goals

  1. A lightweight mobile robotics simulator
  2. Usable in the classroom, research, or exploration
  3. Explore wheeled robots with range, cameras, and light sensors
  4. Operate quickly without a huge amount of resources
  5. Create reproducible experiments
  6. Designed for exposition, experimentation, and analysis
  7. Sensors designed for somewhat realistic problems (such as image recognition)
  8. Especially designed to work easily with Machine Learning and Artificial Intelligence systems

A duck robot

Examples

There are pre-designed simulations ready to run, like this:

import aitk.robots
import random

world = aitk.robots.load("two-scribblers")

for robot in world.robots:
    # Give each robot a desired speed:
    robot.forward(1)

def control(world):
    for robot in world.robots:
        if robot.stalled:
	    # If stuck, just reverse:
            robot.reverse()
	# Turn randomly:
        robot.turn(1 - random.random() * 2)

# Watch the robots move in real time, or faster:
world.watch()
world.run(control, show=True, real_time=False)
# Press Control+C or interrupt the kernel to stop

You can also easily assemble your own simulations, robots, and sensors.

import aitk.robots

world = aitk.robots.World(width=100, height=100)
world.watch()

robot = aitk.robots.Scribbler()

world.add_robot(robot)

robot.add_device(aitk.robots.RangeSensor())
robot.add_device(aitk.robots.Camera())

world.save_as("world-1")

Installation

For the core operations, you will need to install just aitk.robots:

pip install aitk.robots

For just image processing on top of of the core, you will need:

  • Pillow - Python Image Library (PIL)

For the full set of options, you will need:

  • Pillow - Python Image Library (PIL)
  • ipywidgets
  • IPython
  • bqplot

To use the Jupyter enhancements, you'll also need the browser-based extensions. You can install those with:

jupyter labextension install @jupyter-widgets/jupyterlab-manager ipycanvas

If not in a conda environment, then you will also need to:

jupyter nbextension enable --py widgetsnbextension

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

aitk.robots-0.7.3-py3-none-any.whl (93.6 kB view details)

Uploaded Python 3

File details

Details for the file aitk.robots-0.7.3-py3-none-any.whl.

File metadata

  • Download URL: aitk.robots-0.7.3-py3-none-any.whl
  • Upload date:
  • Size: 93.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.8.5

File hashes

Hashes for aitk.robots-0.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c89808b0658b043d1d7609da30c24e083b676e9b1c33f3f79a27708c6af1d1fa
MD5 4e3acd2302bc9dfee6f88e72db682b1c
BLAKE2b-256 ee5f12a187e3f8092d3a3e97071f553d2f03451b0f3f2d6e237e70528d5f52d4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page