Skip to main content

Additional robot models for RL simulations

Project description


Robot models for gym-ignition

These models have been mainly tuned and tested to work in Ignition Gazebo.


This repository can be installed with the pip package manager as follows:

# From PyPI
pip3 install gym-ignition-models

# From the repository (always containing the most recent changes)
pip3 install git+

Only GNU/Linux distributions are currently supported.


Standalone usage

If you use Ignition Gazebo, you need to specify where the models and their dependent resources are located in the filesystem. The simulator reads the IGN_GAZEBO_RESOURCE_PATH environment variable.

Execute the following commands from outside the directory where you cloned this repository to temporarily configure your environment:

PKG_DIR=$(python -c "import gym_ignition_models, inspect, os; print(os.path.dirname(inspect.getfile(gym_ignition_models)))")

If you want to make this change persistent, add the lines above to your ~/.bashrc.

Note: waiting an upstream fix, you also need to add to IGN_GAZEBO_RESOURCE_PATH all the directories containing model's meshes.

Note: Alternatively, instead of using IGN_GAZEBO_RESOURCE_PATH, you can use SDF_PATH for the models and IGN_FILE_PATH for the meshes.

Python usage

The environment variables are automatically exported when the package is imported. If your application imports also the scenario package, make sure to import gym_ignition_models first.


You can use these models either with the standalone simulators, or find and import them in your Python code. Here below an Python example of the utility functions provided by the package:

import gym_ignition_models as m

print(f"Models have been installed in {m.get_models_path()}")
print(f"Available robots: {m.get_robot_names()}")
print("\nModel files:")

for robot_name in m.get_robot_names():
    print(f"{robot_name}: {m.get_model_file(robot_name)}")

Supported models

Robot Name Screenshot

Project details

Download files

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

Files for gym-ignition-models, version 0.1.dev98
Filename, size File type Python version Upload date Hashes
Filename, size gym_ignition_models-0.1.dev98-py3-none-any.whl (15.1 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size gym-ignition-models-0.1.dev98.tar.gz (9.5 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page