Skip to main content

Live Controls

How to make real-time, ad-hoc adjustments to a live experiment.

Updated over 6 months ago

Introduction

While control setpoints are defined ahead of the start of the experiment throughout the creation of the Script and Experiment Plan, Live Controls provides users with the ability to make real-time, ad-hoc adjustments to the bio-process as needed. More specifically, users may override control setpoints, enable/disable process controls, and issue unscripted pumping commands.

To navigate to Live Controls from a live experiment, users must first navigate to the Experiment Dashboard for the experiment by selecting the experiment name from the live experiments list page located under the ‘Live Experiments’ tab of the Monitor section in the navigation menu. From the Experiment Dashboard, users may select ‘View Live Controls’ from the lower, right-hand side of the dashboard.

Adjusting pH Parameters using Live Controls

All available pH parameter controls are organized under the pH section of Live Controls, organized as the first section in the list. From the pH parameter section of Live Controls users are able to update the following parameters:

  • pH Control (enabled/disabled)

  • pH Control Setpoint

  • pH Control Negative Deadband

  • pH Control Positive Deadband

Additional pH control parameters may be accessed by selecting ‘Show advanced’ located on the right-hand side of the pH section. These advanced pH control parameters include:

  • pH Control Base Derivative Duration

  • pH Control Base Integral Duration

  • pH Control Base kd, decreasing

  • pH Control Base kd, increasing

  • pH Control Base ki

  • pH Control Base kp

  • pH Control CO2 Derivative Duration

  • pH Control CO2 Integral Duration

  • pH Control CO2 kd, decreasing

  • pH Control CO2 kd, increasing

  • pH Control CO2 ki

  • pH Control CO2 kp

  • pH Control CO2 Max Sparge Rate

  • pH Control CO2 Min Sparge Rate

Once the user has determined the pH control parameter(s) that they seek to update, the user may select the relevant cell(s) and update the value(s) as desired. For example, a user may seek to update the pH Control Setpoint value for a given run from 7 to 6.8 by selecting into the pH Control Setpoint cell, deleting the value 7, and replacing it with the value of 6.8. No adjustments to the process will be made at this time. Next, the user will be directed to review a summary of all changes made to process parameters. Once the user is ready to submit the changes to be enacted, the user may select ‘Submit.’ Only after the user submits the changes will the system be updated.

Following submission of any parameter changes, the user will be directed back to the controls page. Any values previously modified using Live Controls overrides will be annotated with a pencil icon.

To remove any process parameter overrides previously sent using Live Controls, users may delete the value within the relevant cell, review, and submit ‘No override.’ This will cause the system to default back to the value specified in the Script. Following submission of ‘No override’ for a given parameter, the user will be required to refresh the page in order to observe the Script value within the cell.

Adjusting Temperature Parameters using Live Controls

All available temperature parameter controls are organized under the temperature section of Live Controls, organized as the second section in the list. From the temperature parameter section of Live Controls users are able to update the following parameters:

  • Temperature Control (enabled/disabled)

  • Temperature Control Setpoint

Once the user has determined the temperature control parameter(s) that they seek to update, the user may select the relevant cell(s) and update the value(s) as desired. For example, a user may seek to update the Temperature Control Setpoint value for a given run from 37 degrees C to 35 by selecting into the Temperature Control Setpoint cell, deleting the value 37, and replacing it with the value of 35. No adjustments to the process will be made at this time. Next, the user will be directed to review a summary of all changes made to process parameters. Once the user is ready to submit the changes to be enacted, the user may select ‘Submit.’ Only after the user submits the changes will the system be updated.

Following submission of any parameter changes, the user will be directed back to the controls page. Any values previously modified using Live Controls overrides will be annotated with a pencil icon.

To remove any process parameter overrides previously sent using Live Controls, users may delete the value within the relevant cell, review, and submit ‘No override.’ This will cause the system to default back to the value specified in the Script. Following submission of ‘No override’ for a given parameter, the user will be required to refresh the page in order to observe the Script value within the cell.

Adjusting Dissolved Oxygen Parameters using Live Controls

All available dissolved oxygen parameter controls are organized under the DO section of Live Controls, organized as the third section in the list. From the DO parameter section of Live Controls users are able to update the following parameters:

  • DO Control (enabled/disabled)

  • DO Control Setpoint

  • Constant Agitation Setpoint

  • Primary Sparge Carrier Gas Rate Setpoint

  • Overlay Gas Rate Setpoint

Additional DO control parameters may be accessed by selecting ‘Show advanced’ located on the right-hand side of the DO section. These advanced DO control parameters include:

  • DO Control Derivative Duration

  • DO Control Integral Duration

  • DO Control O2 kd, decreasing

  • DO Control O2 kd, increasing

Once the user has determined the DO control parameter(s) that they seek to update, the user may select the relevant cell(s) and update the value(s) as desired. For example, a user may seek to update the DO Control Setpoint value for a given run from 40% to 50% by selecting into the DO Control Setpoint cell, deleting the value 40, and replacing it with the value of 50. No adjustments to the process will be made at this time. Next, the user will be directed to review a summary of all changes made to process parameters. Once the user is ready to submit the changes to be enacted, the user may select ‘Submit.’ Only after the user submits the changes will the system be updated.

Following submission of any parameter changes, the user will be directed back to the controls page. Any values previously modified using Live Controls overrides will be annotated with a pencil icon.

To remove any process parameter overrides previously sent using Live Controls, users may delete the value within the relevant cell, review, and submit ‘No override.’ This will cause the system to default back to the value specified in the Script. Following submission of ‘No override’ for a given parameter, the user will be required to refresh the page in order to observe the Script value within the cell.

Pumping with Live Controls

In addition to control over key process setpoints, users may also use Live Controls to command ad-hoc, real-time pumping commands. This functionality may be used to support ad-hoc antifoam addition throughout the course of the experiment or to prime the syringe lines prior to the start of the experiment.

All available pumping controls are organized under the Pumps section of Live Controls, organized at the bottom of the list. From the Pumps section of Live Controls users are able to perform the following pump actions from any syringe across any Run:

  • Bolus feed

  • Continuous feed

  • Cancel current pumping action

Before selecting the pump command from the user controlled pumping mode dropdown users must first update the ‘Script controlled pumping’ value to ‘Disabled’ to effectively disable pumping actions commanded from the Script and instead allow Live Controls pumping actions to be submitted. Once the user has updated the value of the ‘Script controlled pumping’ column for all syringes across any Runs that the user wishes to send a Live Controls command, the user may then proceed with selecting the desired pumping mode from the ‘User controlled pumping mode’ column before filling in the relevant pumping mode details.

If the user selects ‘Bolus’ as their pumping mode, the user will be required to define the bolus volume and bolus rate in the respective columns before reviewing and submitting the command. If the user selects ‘Continuous’ as their pumping mode, the user will be required to define the feed rate and feed duration before reviewing and submitting the command. Users may also use the ‘Cancel current pumping action’ to cancel a current Script pumping command or a recently submitted Live Controls command.

As is the case when updating other parameter setpoints using Live Controls, no adjustments to the process will be made until the values have been submitted. After entering all necessary pumping fields, the user will be directed to review a summary of all changes made to process parameters. Once the user is ready to submit the changes to be enacted, the user may select ‘Submit.’ Only after the user submits the changes will the system be updated.

Following submission of any parameter changes, the user will be directed back to the controls page. While the user may expect to see the Script controlled pumping value annotated with a pencil icon to reflect the value was updated with Live Controls, the user may not expect to see the most recent pumping command presented in the fields. This is to allow the user to command additional pumping actions. However, the user will be able to monitor the total volume pumped field in order to confirm the volume commanded is pumped. Additionally, users may navigate to workspaces and plot the following measurement topics to view a history of commands as well as monitor command progress:

Measurement Topic

Definition

Feed duration (min) - Nutrient (Syringe A)

Feed duration (min) - Glucose (Syringe B)

Feed duration (min) - Antifoam (Syringe C)

Feed duration (min) - Base (Syringe D)

Feed duration (min) - Additional (Syringe E)

Live control override for feed duration for a continuous pumping command

Feed rate (mL/min) - Nutrient (Syringe A)

Feed rate (mL/min) - Glucose (Syringe B)

Feed rate (mL/min) - Antifoam (Syringe C)

Feed rate (mL/min) - Base (Syringe D)

Feed rate (mL/min) - Additional (Syringe E)

Live control override for feed rate for a continuous pumping command

Bolus volume (mL) - Nutrient (Syringe A)

Bolus volume (mL) - Glucose (Syringe B)

Bolus volume (mL) - Antifoam (Syringe C)

Bolus volume (mL) - Base (Syringe D)

Bolus volume (mL) - Additional (Syringe E)

Live control override for bolus volume for a bolus pumping command

Bolus rate (mL/min) - Nutrient (Syringe A)

Bolus rate (mL/min) - Glucose (Syringe B)

Bolus rate (mL/min) - Antifoam (Syringe C)

Bolus rate (mL/min) - Base (Syringe D)

Bolus rate (mL/min) - Additional (Syringe E)

Live control override for bolus rate for a bolus pumping command

Syringe Pump [X] Estimated Rate (mL/min)

Actual pump rate for the specified syringe from Live Controls and/or Script controlled pumping

Syringe Pump [X] Target Rate (mL/min)

Commanded pump rate for the specified syringe from Live Controls and/or Script controlled pumping

Syringe Pump [X] Dispensed Volume (mL)

Volume dispensed from the specified syringe

It is critical for the user to update the value of the ‘Script controlled pumping’ column to ‘Enabled’ once the user has successfully completed their pumping intervention and would like to allow pumping actions defined within the Script to be executed for the relevant syringe. The user will need to review and submit this change in order to successfully re-enable script control. If the user does not enable script controlled pumping the syringe pump will not execute on any downstream pump commands issued by the Script throughout the remainder of the experiment.

Did this answer your question?