/Mimic

An open-source Maya plugin for controlling Industrial Robots. Written in Python 3.

Primary LanguagePython

mimic_logo

What is Mimic?

An open-source Autodesk Maya plugin for controlling Industrial Robots.

Mimic is a free and open-source plugin for Autodesk Maya that enables simulation, programming, and control of 6-axis, Industrial Robots. Use Mimic to generate programs without writing any code, or extend Mimic to suit your project's needs. Written in Python 3.

Installation

Download the latest release and copy the contents of it to one of the following directories, depending on your operating system:

macOS   ~/Library/Preferences/Autodesk/maya/modules
Windows ~/Documents/maya/modules

-We only include a small set of rigs with the main download to save download size. If you need a rig that is otherwise supported, download the manufacturer-specific rigs, grab the rig you need, and drop it into the appropriate rigs folder in your mimic directory

When you're done, open Maya, click on the Mimic shelf tab, and click on the Mimic icon; that's it!

Installation tips:

  • If the modules directory above does not exist, create it.
  • If you're using Maya 2017 update 3 or earlier, you must manually load the Mimic shelf.
  • If you're running Windows and downloaded a release and/or rigs archive, confirm that it isn't "blocked" before unzipping and installing it (right click the archive, select Properties, check Unblock if necessary).
  • If you cloned this repository, download the latest robot rigs from releases. Replace the directory mimic3/rigs with the unzipped rigs folder.
  • See troubleshooting if you have trouble using or installing Mimic.

You can find tutorials, videos, and other media on our website and textual documentation in docs.

Currently supported robots

Let us know if what you need isn't listed and we'll try to help! (contact info provided below)

Mimic currently supports the following robots for animation (see rigs). You can download the Maya files for supported rigs here

|-- ABB
    |-- IRB 120-3-58
    |-- IRB 140-6-81
    |-- IRB 1100-4-58
    |-- IRB 1200-5-90
    |-- IRB 1200-7-70
    |-- IRB 1600-6-145
    |-- IRB 1600-10-145
    |-- IRB 2600-20-165
    |-- IRB 4400-45-196
    |-- IRB 4400-60-196
    |-- IRB 4600-20-250
    |-- IRB 4600-40-255
    |-- IRB 6640-180-255
    |-- IRB 6640-235-255
    |-- IRB 6700-150-320
    |-- IRB 6700-205-280
    |-- IRB 6700-245-300
    |-- IRB 8700-475-420
    |-- IRBT 4004-9000
|-- Kawasaki
    |-- RS010N-A
    |-- RS010N-B
    |-- RS020N
|-- KUKA
    |-- KL 100 6125
    |-- KL 1500-3 6000
    |-- KL 4000 5000
    |-- KR 3
    |-- KR 3 AGILUS
    |-- KR 5 R1400
    |-- KR 5-arc
    |-- KR 6 R700 sixx AGILUS
    |-- KR 6 R900 sixx AGILUS
    |-- KR 10 R900 sixx AGILUS
    |-- KR 10 R1100 sixx AGILUS
    |-- KR 10 R1100-2
    |-- KR 10 R1420
    |-- KR 12 R1800
    |-- KR 12 R1800-2
    |-- KR 16-2
    |-- KR 16 L6-2
    |-- KR 16 R1610
    |-- KR 16 R2010
    |-- KR 16 R2010-2
    |-- KR 16-arc HW
    |-- KR 20 R1810
    |-- KR 20 R1810-2
    |-- KR 20 R3100
    |-- KR 22 R1610
    |-- KR 30-3
    |-- KR 30 R2100
    |-- KR 50 R2100
    |-- KR 60-3
    |-- KR 60 L30-3
    |-- KR 70 R2100
    |-- KR 120 R2500 Pro
    |-- KR 120 R2700 HA
    |-- KR 120 R2700 press C
    |-- KR 150 R3100 Prime
    |-- KR 150
    |-- KR 150-2
    |-- KR 150 L110-2
    |-- KR 150 R3100 Prime
    |-- KR 180 R2900 Prime
    |-- KR 200 L140-2
    |-- KR 210-2
    |-- KR 210-2 K
    |-- KR 210 R2700 Prime
    |-- KR 210 R3100
    |-- KR 210 R3300 Ultra K-F
    |-- KR 240-2
    |-- KR 240 L180-2
    |-- KR 240 R2900 Ultra
    |-- KR 240 R2900 Ultra C
    |-- KR 250 R2700-2
    |-- KR 300 R2500 Ultra
    |-- KR 300 R2700-2
    |-- KR 300 R2700-2 C
    |-- KR 360-3
    |-- KR 500-2
    |-- KR 500-2 RC
    |-- KR 500 L340-3
    |-- KR 600 R2830
    |-- KR 1000 TITAN
|-- Motoman *
    |-- GP20HL
    |-- MH6
    |-- MH20 II-20
|-- Staubli *
    |-- RX160
    |-- RX160L
    |-- TX40
    |-- TX60
    |-- TX60L
    |-- TX90
    |-- TX90L
|-- Universal Robots *
    |-- UR3
    |-- UR3e
    |-- UR5
    |-- UR5e
    |-- UR10
    |-- UR10e

* post processor not yet supported

Mimic currently supports the following post processors (see postproc):

|-- ABB
    |-- RAPID
|-- KUKA
    |-- EntertainTech *
    |-- KRL
|-- Staubli
    |-- VAL3
|-- Genral
    |-- CSV

* external installation option required

Join the community!

Help us out and contribute to this repository! You may submit an issue or open a pull request for any bugs or improvements to this software. See CONTRIBUTING for programming guidelines.

Join the our slack channel! You may also contact us at mimic@autodesk.com.

Mimic was born at the Autodesk Robotics Lab 2018. It is now developed and contributed to by a community of animators, designers, engineers, architects, programmers, and more. See AUTHORS for details.

License

Mimic is licensed under the MIT license. See LICENSE for details.

Notes

  • Be careful out there! Mimic is not a safety certified monitoring tool. Users of this software are responsible for safe robot programming and operation.
  • Developed to work with Autodesk Maya 2016-2020; is not compatible with versions prior to Maya 2016 due to changes in Maya's Python API
  • Developed to work with macOS and Windows; Maya is not compatible with other operating systems but most of the Mimic backend is.
  • Do not modify names or hierarchies within robot rigs!
  • Use Maya's default units: Centimeters, Degrees
  • Use Maya's default coordinate system where the Y-axis points up.
  • Note this repository does not include robot rigs; download the latest release to access the latest rigs.