|
| 1 | +--- |
| 2 | +title: Managing calibrations |
| 3 | +slug: /managing-calibrations |
| 4 | +hide_table_of_contents: true |
| 5 | +--- |
| 6 | + |
| 7 | +Once you have one or more calibrations (stirring, pumps, OD), you can set which one is active, export it, edit it, or share it. |
| 8 | + |
| 9 | +## Using calibrations in experiments |
| 10 | + |
| 11 | +Calibrations are applied automatically whenever a device has an active calibration. For OD readings, that means future experiments will use the post-calibration values in the UI and database. |
| 12 | + |
| 13 | +To change which calibration is active, visit the Calibrations page, select the calibration you want, and choose **Set active**. Only one calibration can be active per device on a Pioreactor at a time. You can disable calibrations by clearing the active calibration for that device. |
| 14 | + |
| 15 | +## Managing calibrations in the UI |
| 16 | + |
| 17 | + |
| 18 | + |
| 19 | +- Use the `Pioreactor` and `Device` filters at the top of the Calibrations page to focus on a specific unit and hardware type. Toggle **Only Active calibrations** to hide everything except the curve currently in use. |
| 20 | +- Click any calibration row to open its detail view. Use **Set active** to mark that calibration as the one the Pioreactor will use for that device (only one calibration can be active per device per Pioreactor). Use **Set inactive** to clear it and disable calibration for that device. |
| 21 | +- The chart in both the list view and detail view has a download icon. Click it to export a PNG of the calibration curve for lab notes. The top-level **Download all calibrations** button grabs all calibration YAML files for backup. |
| 22 | +- To edit a calibration, open its detail view and choose **View YAML**. Make small changes, save the YAML, and re-upload it via **Upload calibration** (or edit the YAML on-disk and use `pio calibrations display` to confirm before setting it active). |
| 23 | + |
| 24 | +## Managing calibrations from the command line |
| 25 | + |
| 26 | +- List what you have with `pio calibrations list` or scope to a single device with `pio calibrations list --device <device>`. |
| 27 | +- Set which calibration is active with `pio calibrations set-active --device <device> --name <calibration_name>`. Omit `--name` to clear the active calibration for that device. |
| 28 | + |
| 29 | +## Editing and sharing calibrations |
| 30 | + |
| 31 | +Calibrations are saved as YAML files on your Pioreactor. You can edit these files directly on the command line or in the UI. |
| 32 | + |
| 33 | +If you want to re-analyze an OD calibration dataset, use: |
| 34 | +``` |
| 35 | +pio calibrations analyze --device od --name <name of your calibration> |
| 36 | +``` |
| 37 | + |
| 38 | +Since the calibrations are just YAML files, you can easily share existing calibrations to other Pioreactors. |
0 commit comments