AccelerationConsortium / ac-training-lab

Codebase for controlling and managing the Acceleration Consortium (AC) Training Lab.
https://ac-training-lab.readthedocs.io/
MIT License
8 stars 2 forks source link

Documentation / links / instructions for MyCobot 280 demos by Yang Cao #18

Open sgbaird opened 2 months ago

sgbaird commented 2 months ago

Based on the following demo videos by Yang: https://www.youtube.com/playlist?list=PLKFxDV1Aoxg7gdBsbIH7mB6FjYu3F57uj

Add an Accelerated Discovery post related to this and a device page.

Likely based on the following docs:

  1. First Time Use
  2. drag-and-record, playback
  3. Gripper via blockly
  4. Suction pump via blockly

I believe Yang mentioned he primarily used blockly when he was testing things out - should be a one-to-one correspondence in terms of Python functions.

Yang also mentioned watching some videos:

  1. https://youtu.be/b4H-C8rZ9vQ
  2. https://www.youtube.com/@ElephantRobotics

From here on, the bulk will likely be directly in Python: https://docs.elephantrobotics.com/docs/gitbook-en/7-ApplicationBasePython/.

sgbaird commented 1 month ago

This primarily is geared towards module 4 and 5 from https://ac-microcourses.readthedocs.io/en/latest/courses/robotics/overview.html#modules

gursi26 commented 1 month ago

Hey @sgbaird , just a few questions.

  1. Any example Accelerated Discovery Posts I can look at to see what a post for the cobot should entail?
  2. Seems like the device page should contain instructions for how to setup the MyCobot 280. Is that accurate?
sgbaird commented 1 month ago

Some examples:

  1. https://accelerated-discovery.org/t/building-the-high-resolution-motorized-openflexure-microscope-v7-using-the-rodeostat-kit/231/16
  2. https://accelerated-discovery.org/t/improvements-to-the-digital-pipette/236/8
  3. https://accelerated-discovery.org/t/science-jubilee-adapter-for-the-digital-pipette/255/3
  4. https://accelerated-discovery.org/t/automated-microfluidics-programming-an-electronic-pressure-regulator/252/5
  5. https://accelerated-discovery.org/t/building-the-open-flexure-delta-stage-reflection-and-transmission-microscopes/254

I'm still working out a few details on what device pages should contain, but it should have some kind of brief intro to what the device is, links to the original websites and documentation (e.g., like the links above), a short description of why this is relevant to scientific lab automation, a link to the corresponding accelerated discovery post, and links to related code within the AC Training Lab repo.

The intent is to not replicate existing documentation, but link out to it where possible, and clarify any differences or specifics to the current demo.

I think Yang is going to make an accelerated discovery post to start out since he was working on it a bit before, and that will be used as a sort of hand-off to you.

Adding some of this to https://ac-training-lab.readthedocs.io/en/latest/contributing.html

sgbaird commented 1 month ago

@gursi26 you can go ahead and make the Accelerated Discovery post (here are examples: https://accelerated-discovery.org/tag/ac-training-lab).

gursi26 commented 2 weeks ago

I have made the post, should this issue be closed (unless you also have something else in mind)?

sgbaird commented 2 weeks ago

Just saw - nice! https://accelerated-discovery.org/t/making-the-mycobot-280-accessible-over-mqtt-in-a-hugging-face-space/430

Any thoughts on what a "device page" might look like? This idea isn't fully fleshed out. Curious to hear your opinions (the idea being a focus on replicability)

https://ac-training-lab.readthedocs.io/en/latest/devices/setup_iolt_devices.html#docs-page-and-tutorial-bom-setup-etc

sgbaird commented 1 week ago

Since the LEGO connectors can be a pain and a bit flimsy, I flipped the base and used a 3 mm Allen key to screw the embedded screws into the cobot (4 internal screws). Much more stable now, without having to put lots of Lego connectors and make it really difficult to get off.

PXL_20241026_182404750.jpg

Not sure what we'll want to do when we're thinking about the MyAGV, but shouldn't matter for now.

sgbaird commented 1 week ago

Unfortunately it's neither particularly stable nor very well centered (i.e., the benefits of extra clearance as a "pedestal" are not exactly realized). Not sure if it's worth using these. May come in handy for another demo.

PXL_20241026_185514815.jpg

gursi26 commented 3 days ago

For a device page, would a README in src/ac_training_lab/cobot280pi/ be the appropriate place to put it? I have a set of setup instructions I wrote down while I was setting up the second cobot.

sgbaird commented 3 days ago

The original intention was to have these in https://github.com/AccelerationConsortium/ac-training-lab/tree/main/docs/devices and have a "devices" drop-down on the left sidebar or similar. I hadn't considered putting it in src as much. Thoughts on the two?

gursi26 commented 3 days ago

Yep, either is fine, Ill add the markdown file to that directory in my PR.