Liquid handling / Data integration
From instrument evidence to connected records.
Connect executed liquid-handling evidence to sample preparation and plate genealogy. Seal connects the exported evidence to the experiments, samples and review workflows your team already uses.
- ExportThe vendor software saves the measurement or evaluated result.
- CollectSeal IoT on the site computer uploads the completed file.
- MapA Seal Script validates the data and writes your chosen fields.
Instrument acquisition, analysis and control stay in the vendor software. This connection uses the existing Seal file and entity APIs. Configure the collection and mapping for your installed software and export layout; selecting the instrument in the directory does not install a parser or start acquisition.
What evidence can Hamilton Microlab STAR VENUS provide?
- Source
- Hamilton / Hamilton Microlab STAR VENUS
- Evidence to collect
- VENUS run trace and configured sample-tracking outputs; retain the executed method and worklist.
Export options depend on the installed software and licences. The Hamilton Microlab STAR VENUS setup guide covers source preparation and collection in Seal.
This file workflow collects execution evidence. It does not launch VENUS methods, control the robot or install the separate VENUS Web API integration. Keep operating authority in the instrument software.
Keep one representative export and its matching instrument report. Record the software version, licensed export options, chosen columns or sheets, and which results the file actually contains. Check the layout after a software or report-template change.
Vendor reference: Hamilton VENUS 6 programmer manual: sample tracking and run evidence. Product pages describe the source software; verify detailed export options against the manual for your installed version.
Choose the records you need.
One preparation run with linked source-to-destination transfers where the executed evidence supports them.
These are suggested fields, not a required schema. Reuse your existing sample, experiment, equipment and method references. Preserve complete exports as File content; store selected values as typed fields when people need to filter, compare, calculate or review them.
| Information | Seal fields | Mapping rule |
|---|---|---|
| Run and method | Reference and text fields | Preserve executed run identity and method revision. |
| Transfer genealogy | Reference and number fields | Resolve source and destination labware, positions and reported transfer volume. |
| Execution outcome | Status and File fields | Keep errors, skipped steps and recovery evidence distinct from successful completion. |
| Source and revision | File and text fields | Retain the original export, instrument identity and analysis revision. Recognize an identical source revision before creating another result. |
Context to retain: Run and method; Transfer genealogy; Execution outcome; Source and revision. A missing, failed or qualified result should stay distinguishable from a valid zero. Require explicit sample identities and reject unexpected layouts before the Script writes results.
Ready to configure the connection?
The platform docs contain the setup steps: prepare the source export, choose your System and template, configure collection, and test a mapping Script against your actual fields.
Follow the Hamilton Microlab STAR VENUS setup guide ↗
Start with one representative export and its matching vendor report. The on-site equipment docs cover IoT installation, credentials and the first upload. The instrument mapping docs explain File content, typed records and ordinary Seal Scripts.
The site computer connects to Seal over outbound HTTPS. A cloud Script cannot read the instrument’s local drive. Collection frequency follows the export workflow: a folder watcher observes saved files and does not request new measurements.
Keep the source files until delivery and mapping are verified. For frequent or large datasets, choose useful summaries or intervals, retain coverage information and measure the intended volume before unattended operation.
Use the evidence in your existing workflow.
Imported records use normal Seal permissions and references. Compare typed results in views and formulas, link the analysis to a procedure, and use @ references to give neil the accessible samples, experiments and source evidence needed for a question.
Review the imported Hamilton Microlab STAR VENUS results for these samples. A worklist describes intended transfers, not proof they completed. Show the source evidence and any missing context.
neil can help write the mapping Script from a representative file and the actual fields in your System. Ask for a proposed mapping and a dry run first. Review its sample matching and scientific assumptions before allowing writes. An instrument name alone does not define a file layout or an analysis method.
Define which fields the import owns. Preserve user-entered notes, review decisions and formula-controlled values. Keep source acquisition time, analysis revision and import time separate so later reanalysis remains understandable.
Prove the workflow with representative data.
A useful first acceptance check
Use a disposable run with a skipped transfer and a recovery action. Verify only evidenced transfers become completed genealogy and the original worklist remains linked.
- Compare the result, not only the upload. Check the destination sample, selected values, units, qualifiers and linked File against the vendor report.
- Replay identical input. Verify the Script recognizes the source identity and revision before creating another result. File-upload calls alone do not prevent duplicate scientific records.
- Reprocess the analysis. Export a changed evaluation and check that it retains its prior evidence. Decide explicitly whether this creates a linked analysis or updates allowed fields under your normal review rules.
- Interrupt and recover. With disposable data, test a network interruption and restart. Also test failure after upload but before mapping completes. Confirm retained files, visible failures and correct retry behavior for the installed IoT app and Script.
Reconcile the source run or sample list with the imported analyses. A watcher cannot recover measurements the instrument never exported. Retain the checks and their evidence with the configured connection before relying on it for your intended use.
When the result is missing or looks wrong.
- No file arrives
- Confirm the instrument created a completed export in the watched folder. Check the IoT account’s file access, upload logs, destination System and template permissions.
- The File exists, but result fields are empty
- Check whether the mapping Script ran and recognized the export. Resolve missing sample identities or fields explicitly; uploading bytes does not populate an analysis automatically.
- The values differ from the instrument report
- A worklist describes intended transfers, not proof they completed. Preserve skipped operations, liquid-detection errors and recovery actions before asserting sample genealogy. Compare the exact export, report and evaluation revision using the field rules above.
- Results are repeated or an analysis is missing
- Check export selection, source identities and revision matching. Reconcile at the analysis level; a filename or successful network response alone cannot establish complete coverage.