Skip to content
A Machina-based Grasshopper plugin for robot manipulation and control.
C#
Branch: master
Clone or download
Latest commit 3d9af5c Dec 20, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets README Dec 20, 2018
dist # v0.8.8 Dec 20, 2018
src # v0.8.8 Dec 20, 2018
.gitignore - [x] Improve `GH_MutableComponent` architecture to accept optional i… Aug 1, 2018
CHANGELOG.md # v0.8.8 Dec 20, 2018
LICENSE.md PUBLIC v.0.4.1 Oct 31, 2017
README.md README Dec 20, 2018

README.md

Machina for Grasshopper

Thanks for downloading Machina for Grasshopper, a Machina-based Grasshopper package for robot control.

Installation (Expert)

Download the latest release. Just as with any other Grasshopper plugin, just drop the main .gha and .dll files in Grasshopper's Components library. Make sure to right-click on both files and unblock them if necessary. Also, if running Windows 10, make sure you have extracted the files from the .zip file with something other than Window's native extracter, such as 7Zip, WinRAR or similar (see below for reasons).

Installation (Beginner)

In order to install Machina for Grasshopper, you need to follow the following steps.

  • Go to the releases section and download the latest version of the distributable.

  • Extract the contents of the MachinaGrasshopper_vX.X.X.zip file somewhere in your computer: if you are running Windows 10, make sure extract the files from the .zip file with something other than Window's native shell extracter (the one you use when double clicking on the file or right-clicking and choosing Extract), such as 7Zip, WinRAR or similar. Failure to do so may cause Window's security settings to internally flag the .dll file as downloaded-from-internet-suspicious, and block it forever.

  • Paste these files in Grasshopper's Components folder: open Rhino and Grasshopper, and in GH, go to File > Special Fodlers > Components Folder. This should open a Windows Explorer window in a folder of the kind C:\Users\yourUsername\AppData\Roaming\Grasshopper\Libraries. Once in this folder, paste the previously extracted .gha and .dll files there. You are welcome to also paste the sample files there as well, or keep them somewhere for your reference.

  • Unblock the files: in your Components folder, right click on Machina's .gha and .dll files, choose Properties, and make sure they are unblocked in the lower right end of the popup menu.

  • Restart both Grasshopper and Rhino for the changes to take effect.

Tutorials

There are a bunch of Grasshopper files in the samples folder that comes with this package. These files will help you understand how to setup a Machina project. I will write a dedicated walkthrough section sometime soon...

A full set of tutorials on how to use the Machina framework can be found here:

MACHINA TUTORIALS Tutorials playlist: https://www.youtube.com/playlist?list=PLvxxYImPCApXj3tHVKmpTS_AuMPngnA47

Instructions on how to setup your machine to work with the Machina framework can be found here: https://www.youtube.com/playlist?list=PLvxxYImPCApUffcv_KtdR-sQydA4O4CPH.

Projects

A playlist of projects built by the community with different Machina flavors: https://www.youtube.com/playlist?list=PLvxxYImPCApXZ-yBCUtGzVWb2ZhduaSXR

🤖x❤️

Machina for Grasshopper is built on top of Machina, an open-source platform for action-based control of mechanical actuators.

Machina is also available for Autodesk's Dynamo. Their API and Actions list is 99% identical.

Here are some videos of things you can do with Machina:

Disclaimer

Working with robots is dangerous. Robotic actuators are very powerful machines, but for the most part extremely unaware of their environment; if it collides with something, including yourself, it will not detect it and try to keep going, posing a threat to itself and the operators surrounding it. This is particularly relevant when running in 'automatic' mode, where several security measures are bypassed for the sake of performance.

When using robots in a real-time interactive environment, please make sure:

  • You have been adequately trained to use that particular machine,
  • you are in good physical and mental condition,
  • you are operating the robot under the utmost security measures,
  • you are following the facility's and facility staff's security protocols,
  • and the robot has the appropriate guarding in place, including, but not reduced to, e-stops, physical barriers, light curtains, etc.

Machina is in a very early stage of development. You are using this software at your own risk, no warranties are provided herewith, and unexpected results/bugs may arise during its use. Always test and simulate your applications thoroughly before running them on a real device. The author/s shall not be liable for any injuries, damages or losses consequence of using this software in any way whatsoever.

Contribute

Want to help develop/document Machina for Grasshopper? Get in touch! :)

Acknowledgments

The development of Machina was sponsored by Autodesk, Inc, as part of a summer research residency project in Boston, 2016. Please take a look at the detailed list of acknowledgments

Machina was created and is maintained by Jose Luis Garcia del Castillo.

License

MIT License

You can’t perform that action at this time.