Y24-382 - Research - updating volume after cherrypicking

[KatyTaylor]

Description
As an SSR (Liz C) I would like to know when well volumes in Sequencescape are updated after cherrypicks, so that I am confident when re-picking from a well that the remaining volume shown is correct.

Acceptance Criteria
The following outputs from the research are produced:

• Find where in the code the volume update is done after cherrypicking. N.B. I think it doesn't happen during the cherrypicking pipeline, but rather during the bed verification that follows.
• Check whether anything affects whether that volume update happens e.g. which option they pick out of ‘pick by volume (μl)’, ‘pick by concentration (ng/μl)’ and ‘pick by amount (ng)’.
• Document findings to an appropriate level in the user facing documentation produced by this story.
• Look into Liz C's findings when she tested this - get spreadsheet from Katy - not sure if it's appropriate to attach. Are there any bugs here? If so, update this placeholder story with what needs to be fixed.

Who the primary contacts are for this work
Katy

Knowledge or Stake holders
Liz C

Additional context or information
Related stories:

• Y24-380 - Documentation for cherrypicking options #4410
• Y24-381 - As a user of the Sequencescape cherrypicking pipeline (SSR), I would like some small tweaks to be made to improve the usability of the page and reduce the likelihood of user error. #4411
• Y24-383 - Cherrypicking improvements (minimum volume) [DRAFT] #4413

[StephenHulme]

Subject to verification, it appears that the volume reduction is triggered by https://github.com/sanger/sequencescape/blob/master/app/models/cherrypicking_pipeline.rb#L15 and clearly not in https://github.com/sanger/sequencescape/blob/master/app/models/pipeline.rb#L139. The actual calculation occurs in https://github.com/sanger/sequencescape/blob/master/app/models/cherrypick_request.rb#L19.

[StephenHulme]

Confirmed that the code in app/models/cherrypicking_pipeline.rb::CherrypickingPipeline.robot_verified! is executed on robot verification through Sample Management (Lab View) > Bed Verification.

Once this has been completed, then a Robot verification completed and source volumes updated. event appears at the bottom of the Batch page.

[StephenHulme]

Calculations (and explanations) for volumes can be found in app/models/cherrypick/volume_by_micro_litre.rb and sibling files. This is also where validity checks are for volume being defined. This is likely to be particularly helpful for Y24-383.