openvmp / openvmp-models

CAD models for OpenVMP robots

Home Page:https://openvmp.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CAD models of OpenVMP robots

Disclaimer: This is a work in progress. Volunteers wanted to translate the existing FreeCAD models as well as photos of the real robot into CadQuery (Python) scripts. If you want to learn and practice CadQuery and help the community at the same time, please, reach out to openvmp@proton.me.

Introduction

This repository contains detailed blueprints of OpenVMP robots. Since it contains large files by design and it's not required in most cases, this repository is kept as a separate optional submodule.

This repository contains the catalog of all parts, how they look, how they can be manufactured or where they can be purchased. It also contains CadQuery scripts that codify the blueprints of entire robots, instructions how individual parts come together to form the robot.

Robot Preview
Don1 Don1

The default behavior of CadQuery scripts is extended to gerentate the following:

  • images and 3D models
  • bill of materials

Images and 3D models

The main OpenVMP repository already contains all the necessary images and 3D models. However, as OpenVMP robots evolve and improve, all these files need to be regenerated to be rendered in documentation files and in simulation environments.

Bill of materials

OpenVMP can generate the bill of materials for each robot to make purchasing and inventorying easier. For example, the bill of materials for Don1 can be found in ./generated_files/robots/don1/bom.md.

Getting Started

Rendering from command line

Install prerequisites:

sudo apt install -y python3-pip && pip3 install -r requirements.txt

Whenever the blueprints change, run python3 ./parts/render.py to generate updated part images. Run python3 ./robots/render.py to render robot images and STL files, including images and mesh files in ../platform/src/openvmp_robot_*.

Editing models in Visual Studio Code

In a terminal window, run cd models && cq-server run <path>, where path is either robots/<robot_name> or parts/<category>/<part>.

In VS Code, use the 'SimpleBrowser' extension to navigate to http://127.0.0.1:5000/ (to connect to the default port exposed by cq-server).

Also, the rendered SVG files can be seen in the markdown preview views.

Editing models in CadQuery Editor

cd models && CQ-editor robots/<robot_name>/robot.py

About

CAD models for OpenVMP robots

https://openvmp.com


Languages

Language:Python 100.0%