Semaphore Logo clickable link to home page.
Services
Services
Strategic ConsultingSystem ImplementationInformatics SupportScientific Software Development
Domains
Domains
ClinicalResearchLife Sciences
resources
resources
BlogCase StudiesWhitepapersCareers
ABOUT US
Contact
Contact
Integrations
Lab Automations

Complex Lab Software:

How to Best Manage it With Version Control

by

The Semaphore Team

When you’re automating your clinical lab, one of the first things you should look for is an opportunity to integrate instruments with your laboratory information management system (LIMS). This is a great way to reduce manual processing and boost the lab’s speed, efficiency, and accuracy.

‍

Integrating liquid handlers can provide a high return on investment. These robots are commonly used in labs around the world, from small research outfits to larger commercial operations, and can support a high level of automation. Integrating them with your LIMS is imperative if your lab is high-throughput, or plans to be.

‍

When labs ask us about how to best integrate robotic tools with a LIMS, we recommend they consider the following.

Choose the right integration method

As we’ve mentioned in a previous post, two of the main architectures for instrument integration are file-based or API-based. Each has benefits and limitations.

‍

File-based

‍This method uses CSV files (called “worklists”) to transfer information between the LIMS and the liquid handler. The file, generated from the LIMS, is a list of comma-separated values that contains information about the samples to be processed by the liquid handler, as well as data like the concentration, volume, and well mappings for transfer.

‍

Often, file-based integrations are managed by the lab tech when they’re using the liquid handler’s control software to set up a run. Note that liquid handlers also produce:

  • Log files, which indicate what tasks were performed.
  • Results files, which could be used to drive behavior in the LIMS (although this is a less common direction of operations).

CSV worklists are easy to create and read, and are supported by most, if not all, liquid handlers. In fact, the file format is so simple, there’s no requirement for an industry standard.

‍

However, there are several downsides. For instance:

  • Files must be transferred manually, or you need to set up a shared network location that can be accessed by the LIMS and the liquid handler. Consequently, it’s possible to inadvertently use the wrong worklist.
  • It’s possible to edit the files produced by the liquid handler and end up with a version that differs from what is tracked in the LIMS—something important to consider if you’re working in a regulated environment.
  • There’s no way to ensure that the user performing the operation on the liquid handler is qualified to work with the samples they are processing (i.e., there’s no way to perform user verification)

API-based

‍With this method, the liquid handler communicates directly with the LIMS via an application programming interface (API). A huge benefit of this approach is that it allows you to add extra verification steps. For example, you can:

  • Verify that users with appropriate training are performing the operation.
  • Verify that samples are loaded on the deck in the correct positions and are ready for processing.
  • Validate that reagents on the deck are not expired.

You can also track exactly what happened on deck and report issues more easily. For example, you could set up the LIMS to broadcast error notifications from the liquid handler to staff so that they can investigate issues.

‍

Unfortunately, though, there is no industry standard for API-based communication between a LIMS and a liquid handler. This means the API-based method typically requires more development effort to implement than the file-based approach.

Other things to consider

When you’re building an integration, you also need to consider where you want the programming logic to live in the overall system architecture—in the liquid handler method or in the LIMS? You can either tell the liquid handler what to do or track what the liquid handler has done. Which system do you want to change and which needs to be the most flexible? Take into account the complexity of configuring your LIMS to parse result files.

‍

We also recommend you consider the composition and availability of your informatics team. Do you have dedicated automation engineers who can design liquid handler methods and LIMS engineers who can encode all the behavioral logic into the LIMS? Do they have the bandwidth to build and maintain this integration, or will you need to work with a consultant?

‍

You should also decide on a method of version control. Neither the liquid handler software nor the LIMS can typically handle version control of your integration source code, so you should plan to keep the code in a software configuration management system like Git, ideally on a platform like GitHub. Version control is important because it helps you:

  • Track and manage changes, including who made the change, when was it made, and what was modified.
  • Roll back to a previous working version if something goes wrong—making the development of new functionality lower risk.

Whichever approach you choose, we highly recommend labs invest in integrations between liquid handlers and the LIMS. If you want to limit errors and improve the lab’s efficiency, one of the best ways you can do that is to reduce manual processing through automation.

‍

Contact us for a free consultation.

‍

Explore our blog

All Blog Posts

The Importance of Data Integrity in the Laboratory: Adhering to FDA Standards and ALCOA Principles

In today’s highly regulated laboratory environment, maintaining data integrity is not just a matter of good practice—it’s essential for compliance, reliability, and the overall success of lab operations. For lab managers and IT support staff, ensuring data integrity means safeguarding data’s accuracy, completeness, and consistency throughout its lifecycle.

12
min read

Updating Your Lab Workflow? 4 Feature Implementation Scenarios to Consider

When updating lab workflows, not all software changes are created equal. This blog post outlines four common implementation scenarios—ranging from enabling an out-of-the-box (OOTB) feature to developing a fully custom solution—and explains how each impacts cost, effort, and timelines. Whether you’re adding a new assay or integrating an instrument, understanding these scenarios helps labs plan smarter, reduce risk, and align stakeholders. Read on to learn how to choose the right approach for your lab’s needs and how Semaphore Solutions can help guide your next move.

6
min read

Mapping Lab Systems the Right Way: Workflow vs. State Diagrams

Workflow and state diagrams play a crucial role in documenting and visualizing laboratory systems. Both are invaluable for labs implementing a laboratory information management system (LIMS) or adding automations to streamline laboratory operations, reduce errors and redundancies, and ensure regulatory compliance. However, each type of diagram serves a distinct purpose.

7
min read
Semaphore Logo
  • Services
  • Domains
  • Resources
  • About Us
  • Careers
  • Contact Us
  • 1 (844) 744-3577 ext 1
  • 200-844 Courtney St.
  • Victoria, BC V8W 1C4
  • Canada
LinkedIn Social Media Icon Linking to Semaphore Account
  • Cookie Policy
  • Privacy Policy
All Rights Reserved © Semaphore Solutions Inc.