Beckman Coulter, Vi-cell XR Cell Counter Configuration Guide

  • Updated


To provide details about the necessary steps to implement the Beckman Coulter, Vi-Cell XR adapter for use with the Benchling Connect platform.



The Vi-Cell XR adapter is a component used in the context of the Benchling Connect platform to parse data from Beckman Coulter, Vi-Cell XR cell counters to an Allotrope Simple Model (ASM) and make those data available within the Benchling UI in the context of a Run.

The Benchling Connect, Vi-Cell XR adapter is a ‘file-based’ based adapter, meaning that it processes text file exports generated by the Vi-Cell XR instrument. The data within the file export is then accessed by Benchling Connect through the use of a ‘watched’ file directory on the local computer hosting a Benchling Gateway, which has been configured via a Connection from within Benchling.

In order to successfully implement the Beckman Vi-Cell XR adapter for use with the Benchling platform, there are several steps that need to be followed across both the Vi-Cell XR and Benchling user interfaces. 

This guide details the steps to be taken in both applications in order to configure the integration.  


Steps within Vi-Cell XR

 The user should perform measurements following the Vi-Cell XR Instructions for Use (PN 383674BH, May 2022).

The user is expected to enter Sample ID values within the Vi-Cell XR UI that conform to entity identifiers within Benchling, either existing entity IDs or entities they wish to register upon processing of results.


Performing file export from Vi-Cell XR

The Vi-Cell XR adapter is designed to process the .xlsx export generated by the Vi-Cell XR instrument. The processing of a single sample is referred to as a Run within the Vi-Cell XR software. The user is expected to add the sample measurement to a multi-run file. This is done by either selecting ‘Add to multi-run file’ within the Log in Sample UI or within the Run Options tab in under Preferences (shown below). This multi-run file corresponds to the .xlsx export that will be processed by the adapter.

This multi-run file should be placed within the target directory which is specified during Connection configuration, when creating a Vi-Cell XR Connection within the Benchling UI.

Within the Run Options, the Concentration exponent should be set to 106.

Screenshot 2023-06-15 at 5.30.01 PM.pngScreenshot 2023-06-15 at 5.30.18 PM.png

The user is expected to configure the parameters to be included in the multi-run file by selecting the available options within the Export tab under the Preferences (shown below). However, of the available options, only those listed are captured by the adapter since these are defined within the cell counting ASM data model. Note the fields that are Required for adapter functionScreenshot 2023-06-16 at 1.32.10 PM.png


Parameters captured by adapter:

  • Sample ID (Required)
  • Cell Type
  • Minimum Diameter
  • Maximum Diameter
  • Dilution Factor
  • Sample Date
  • Total Cell Count (Required)
  • Viable Cell Count
  • Viability (Required)
  • Total Cells /mL
  • Viable Cells /mL
  • Average Diameter
  • Average Circularity
  • Images


If the user desires to capture the serial number of the instrument used to perform the analysis, this needs to be populated within the Hardware tab under the Configuration menu (shown below).

Screenshot 2023-06-16 at 12.40.13 PM.png


Steps within Benchling 

From within Benchling, a user must:

  1. Enable the Vi-Cell XR adapter on the tenant [internal admin console]

  2. Configure a Vi-Cell XR Connection

  3. Create a Result schema to structure the data to be recorded

  4. Configure a Run schema to accept data from Vi-Cell XR and records Results


For details on completing these steps, please reference the Benchling Connect Installation Guide.


Data returned by Vi-Cell XR adapter

The Benchling Connect - Vi-Cell XR cell counter adapter uses the Allotrope Simple Model (ASM) to structure the information parsed from the Vi-Cell XR file export. The data is processed in a two step process; step one from  Vi-Cell XR export to the .json based ASM, and step two from the ASM .json to a single sample file .csv file available for ingest to Benchling. 

Details about the Cell Counting ASM schema can be found here:

The sample file can contain the following columns (if available within the data):

  • model number
  • device serial number
  • file name
  • software name
  • software version
  • ASM converter name - this refers to the adapter that converted to original file to ASM
  • ASM converter version
  • analyst
  • measurement identifier
  • measurement time
  • sample identifier
  • device type
  • detection type
  • cell type processing method - this corresponds to the ‘Cell Type’ in the XR interface
  • minimum cell diameter μm brightfield
    - note: ‘μm’ refers to unit and ‘brightfield’ to the detection type 
  • maximum cell diameter μm brightfield
    note: ‘μm’ refers to unit and ‘brightfield’ to the detection type
  • cell density dilution factor
  • viability %
  • viable cell density 10^cells/mL
  • total cell count
  • total cell density 10^6cells/mL
  • average total cell diameter μm
  • viable cell count
  • average total cell circularity
  • image file - this is a record of the image file name, and not the image itself


Vi-Cell XR Adapter Requirements


Item Specification
Beckman, Vi-Cell XR Vi-Cell XR version 2.04 or 2.06
Operating System 64-bit Windows 10 or greater
Memory 4 GB RAM or greater
Gateway Benchling Gateway installed on PC, able to communicate on port 443


Revision History

2023/10 Initial Version



- Corrected supported version from 2.4 and 2.6 to 2.04 and 2.06


Was this article helpful?

Have more questions? Submit a request