Cookbook
========

The PyLabRobot Cookbook is a curated collection of concise, modular code 
examples, called recipes, that demonstrate practical solutions to common lab  
automation challenges.
Each recipe is short, focused, and reusable - designed to help 
you apply specific PyLabRobot features in real-world contexts.
Rather than full experimental protocols, these recipes aim to inspire, 
teach, and accelerate your own automation workflows.

There is also a `community cookbook <https://chory-lab.github.io/plr-cookbook/>`_
from the Chory Lab with additional PyLabRobot examples.

------------------------------------------

.. raw:: html

   <div id="tutorial-cards-container">

     <div class="row">

.. Add recipe cards below this line

.. plrcard::
   :header: Move plate to Alpaqua magnet using CORE grippers
   :card_description: <ul>
      <li>Resource movement using CORE grippers</li>
      <li>Resource position check using grippers</li>
      <li>PLR autocorrection of plate placement onto PlateAdapter/magnet</li></ul>
   :link: star_movement_plate_to_alpaqua_core.html
   :tags: ResourceMovement PlateAdapter HamiltonSTAR

.. plrcard::
   :header: Send PyLabRobot notifications to Slack
   :card_description: <ul>
      <li>Post run start/finish/failure messages to a Slack channel</li>
      <li>Forward semantic PLR EventBus operations automatically</li>
      <li>Uses only the Python standard library (no extra deps)</li>
      <li>Webhook URL stored in a local file outside the repo</li></ul>
   :link: slack_notifications.html
   :tags: Notifications Slack Monitoring EventBus

.. plrcard::
   :header: Use ManualOperator in a Jupyter notebook
   :card_description: <ul>
      <li>Pause a notebook for an acknowledged manual handoff</li>
      <li>Reconcile a manually moved plate in PLR's resource model</li>
      <li>Observe incubator and ManualOperator lifecycle events</li></ul>
   :link: manual_operator_jupyter.html
   :tags: ResourceMovement EventBus

.. plrcardgrid::

.. End of tutorial card section

.. -----------------------------------------
.. Page TOC
.. -----------------------------------------
.. toctree::
   :maxdepth: 2
   :hidden:

   star_movement_plate_to_alpaqua_core
   slack_notifications
   manual_operator_jupyter