Overview
This article guides a user through the process of connecting their Agilent Mass Spectrometry instrument with the Scispot platform. The integration leverages our Scispot agent, a Java application that runs locally on your machine and manages the flow of information from a specified directory to your Scispot account.
Part 1: Setting up the Integration on Scispot
Step 1: Create a Scispot Agent
Navigate to the GLUE application on the left-hand menu of Scispot
Select Agents in the top bar of GLUE
Select Add Agent from on the left side of the screen
Choose a name for the agent you are creating and select your device's operating system to download the appropriate Java application
Select Add Agent to begin the download of the agent application
Step 2: Add Source
The source is the location that will be providing data to be synchronized with Scispot. In this case, it will be your Agilent Mass Spectrometer.
Navigate to GLUE within Scispot
Select Sources in the top bar of GLUE
Select Add Source and under Instruments, select Mass Spectrometer
From the instrument drop down, select your specific Agilent Spectrometer model
Add a name for this instrument in the corresponding field
Select the agent created in Step 1 from the dropdown menu
Select Create Source once this information has been added
Step 3: Add Destination
The destination is the location where the data from the source will be sent.
Navigate to Destinations within Scispot Glue
Select Add Destination and from Data Sources, choose Scispot Labsheets (by default, this means data will save to a file called Agent Files)
Select Scispot Labsheets and select Create Destination
Step 4: Create the Connection
To connect the configured source and destination to each other:
Select Connections in the top bar of GLUE
Select Add Connection in the top right corner of GLUE
Define the source as the created Agilent Spectrometer Instrument source, from Step 2
Define the destination as the created Labsheets destination, from Step 3
Select Create Connection
Part 2: Connecting Scispot and the Agilent Instrument
Step 1: Locate Agilent Mass Spectrometry Data
Locate the directory on your device or on your network where MassHunter is saving your Agilent instrument data (this is typically in a folder with the structure MassHunter/data/..)
This file directory is the place the Scispot Agent will monitor for live synchronization of instrument data with Scispot (configured in the following step)
Step 2: Configure the Connection
Back on Scispot, within GLUE, under the Sources tab, click on your created Spectrometer under Instruments, created in Part 1, Step 2
Under Configuration, scroll all the way to the bottom to see the field File Watcher Path
Insert a file path into the field; This will be where the agent will watch for file additions and changes. Insert the file path to the directory where desired data from the Spectrometer is saved, determined in the previous step
Confirm your selection once you have input the appropriate path by selecting Update in the upper right hand corner of the configuration tab
Step 3: Running the Agent
The downloaded Scispot agent file from Part 1, Step 1, is a .zip file containing a Java file that is the Agent application, as well as a batch file containing the command needed to run the agent
Extract these two files from the downloaded .zip file into a directory on the device that will be used for file synchronization - this should be a device that has access to the directory configured as the file path in Part 2, Step 1
Execute the command contained in the batch file in a terminal to begin running the agent
Your agent is now running! You can make sure it is connected by returning to the GLUE application within Scispot and navigating to the Agents tab. There, your named agent will appear with a green connected logo next to its name
Step 4: Data Sync Begins
The File Watcher will monitor the paths specified in the configuration and sync the files dropped into the folders to Scispot.
The synced files will now appear by default in a Labsheet called Agent Files
Once you have setup your data input format and desired data output with the Scispot team, the platform will automatically run calculations and transformations on the data so that it appears in custom Labsheets and Manifests, ready to be used by your team
Step 5: View the Connection and Data
Now, your folder paths are monitored by the Scispot agent, and whenever any file lands there, it will be sent to Scispot.
To view the status of the connection as well as monitor what files have been synced, from GLUE select Connections and select your specific Agilent Mass Spectrometry instrument to Labsheets connection - here you can see the transaction logs of file synchronization
Navigate to the Labsheet called Agent Files within Scispot to view the uploaded raw files
After setting up your data input format and desired data output, data will now also populate in custom Labsheets for your Agilent Mass Spectrometry instrument!