Tecan, Magellan Configuration Guide

Purpose 

To provide details about the necessary steps to implement the Tecan Magellan connector for use with the Benchling Connect platform.

Introduction

The Tecan Magellan connector is a component used in the context of the Benchling Connect platform to parse data from Tecan's Magellan software to an Allotrope Simple Model (ASM) and make those data available within the Benchling UI in the context of a Run.

The Benchling Connect, Tecan Magellan connector is a ‘file-based’ based connector, meaning that it processes .XLSX exports generated by the Magellan software. The Magellan software is compatible with Tecan's line of microplate readers (Sunrise™, Infinite® F50, Infinite® 200 / 200 PRO series, Infinite® F500, Infinite® M1000). The data within the file export is 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 Tecan Magellan connector for use with the Benchling platform, there are several steps that need to be followed across both the Magellan software and Benchling user interfaces. 

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

Steps within Magellan Software

From within the Magellan software, a user must:

1. Configure a .XLSX export compatible with the Benchling Connect, Tecan Magellan connector.
2. Execute the export of that file from their Magellan workspace.
3. Ensure that the file is placed with the watched directory.

NOTE: Although the Magellan software supports Absorbance/Fluorescence/Luminescence measurement modes and Kinetic/Spectral data. At present, the Tecan Magellan connector only supports Absorbance endpoint measurements.

Exporting Compatible Excel File

Export settings need to be defined in the method definition via the Create/edit a Method wizard.

How to set up a data export

1. First, the data sets for export must be chosen in the menu Data handling\Data export:
2. Export options can be defined in the dialog box:
   

   The user is expected to set:

   Direction to Vertical

   Result to Table (well data in rows)

   Set Add temperatures to be included

   Under Add data include all fields listed

3.  

   Configure the dialog box for the settings for Excel export:

   The user is expected to set:

   Target to New workbook
   
   

4. Once export options are configured, in the File menu an export can be performed.
   User is expected to only export to Excel. ASCII file exports are not supported at this time
   
5. Upon exporting, the user should set the export location to the same 'watched' directory configured via Benchling Connection.

Steps within Benchling

From within Benchling, a user must:

1. Enable the Tecan Magellan connector on the tenant [internal admin console]

2. Configure a Tecan Magellan Connection

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

4. Configure a Run schema to accept data from Tecan Magellan and records Results

For steps 1 and 2, please reference the Benchling Connect Installation Guide for details related to creating and installing a Gateway and configuring a Connection.

Creation of Result schema for Tecan Magellan data

In order to record results returned via the integration a Result schema must be created. This can be done prior to configuration of the Run schema, or within the context of the Run schema Output File configuration. 

The Benchling Connect - Tecan Magellan connector uses the Allotrope Simple Model (ASM) to structure the information parsed from the Tecan Magellan Excel (.XLSX) export. The data is handled in a two step process; step one from Tecan Magellan export to the .json based ASM, and step two from the ASM .json to a .csv file available for ingest to Benchling. 

These data are structured using the Allotrope Plate Reader ASM data model. Details about the this ASM schema can be found here:

https://gitlab.com/allotrope-public/asm/-/blob/main/json-schemas/adm/plate-reader/REC/2024/06/plate-reader.embed.schema.json?ref_type=heads

The connector then converts the ASM to one of:

well file .csv - structured such that each row of the file represents a well of the plate

measurement file .csv - in which each row of the file represents a measurement

The well and measurement file CSV outputs can contain the following columns (if available within the data):

• Equipment serial number
• Data system instance identifier
• Software name
• Software version
• File name
• UNC path
• Model number
• Device identifier
• ASM converter version
• ASM converter name
• ASM file identifier
• Measurement Identifier - this is a UUID generated as part of data conversion
• Measurement Time
• Device Type - this will be 'plate reader' in all cases
• Analytical Method ID - this corresponds to the Magellan method name
• Experimental Data ID - this corresponds to the Magellan workspace name
• Container Type - this will be 'well plate' in all cases
• Plate Well Count 
• Well Plate Identifier
• Location Identifier
• Sample Identifier
• Compartment Temperature
• Detection Type - this will refer to Absorbance, Fluorescence, or Luminescence
• Detector Wavelength Setting* - where applicable
• Detector Bandwidth Setting* - where applicable
• ‘Measurement’* - this column header will vary depending on the modality: absorbance, fluorescence, or luminescence - e.g absorbance_mAU
• Absorbance (mAU)/Fluorescence (RFU)/Luminescence (RLU)*

* To account for experiments with multiple measurements these columns will be duplicated (as needed) and will be annotated with a number for each measurement. 

Tecan Magellan Connector Requirements

Revision History

2024/12/02

Initial Version