Skip to content

Front-end for the Raston Lab's Fourier Transform MicroWave - Scientific Instrument Simulator (FTMW-SIS)

License

Notifications You must be signed in to change notification settings

RastonLab/Virtual-FTMW-Spectrometer

Repository files navigation

Virtual-FTMW-Spectrometer

The Virtual FTMW Spectrometer (FTMW-SIS) is a web-based educational tool designed to simulate the operation of a Fourier Transform Microwave (FTMW) spectrometer. Developed for academic use, this simulator enables students to explore rotational spectroscopy principles, generate molecular spectra, and interact with a virtual FTMW instrument, providing hands-on learning without physical hardware. The code base is based off of The Virtual FTIR web application found here (https://ftir.rastonlab.org/).

This project uses React for the frontend and Flask for the backend. The backend is located in a separate repository.

Installation

Information on how to run the front-end can be found in the repository's wiki page.

Usage

The intended audience for this application is undergraduate chemistry students studying spectroscopy. The following screenshots are not exhaustive but acknowledge most of the main features:

  • Experimental Setup (Shows the spectrometer’s physical setup, including the vacuum chamber, molecular beam source, and microwave source)

b5b5a7d39cf8baabf826305b9ebbe46

  • Instrument Window (top-down view of simplified spectrometer)

9c5e7909104abfec865c14087eeaeb8

  • Schematic Window (Displays a block diagram of the FTMW spectrometer with clickable components to learn their functions)

e02d57f7019f924f4c6c1924f600dcc

  • Spectrum Window (Plots the generated rotational spectrum)

05729f9fa95a2dab146420dc589b5b8

  • Find Peaks (Highlights spectral peaks in a table or plot, allowing analysis of rotational transitions)

92838fee0b449c43e083169d054fc96

To use the simulator:

  1. Access the interface at http://localhost:3000.
  2. Set parameters (e.g., molecule, frequency range, pulse widths) in the Experiment Setup tab.
  3. Explore the Schematic tab to learn about the spectrometer’s components.
  4. Generate a spectrum in the Spectrum tab and analyze results in the Find Peaks tab.

License

See LICENSE

Relevant third-party tools and resources we depend on:

  • GitHub Pages Deploy Action: GitHub Action used to automate deployment of web applications to GitHub Pages (Licensed MIT)

  • MUI: React user interface component library (Licensed MIT)

  • Plotly.js: JavaScript data visualization library (Licensed MIT)

  • React: JavaScript library for building user interfaces (Licensed MIT)

  • React CSV: React components to build CSV files on the fly (Licensed MIT)

  • React Router: Declarative routing for React (Licensed MIT)

  • React to Print: React components for printing in the browser (Licensed MIT)

  • Redux Toolkit: Library for updating and managing application state (Licensed MIT)

  • SVGO: Node.js tool for optimizing SVG files (Licensed MIT)

  • SVGOMG: Web GUI for SVGO (Licensed MIT)

  • SVGR: Tool for transforming SVGs into React components (Licensed MIT)

  • React-Window: Lightweight and efficient windowing library for rendering large lists and tabular data (Licensed MIT)

Inspiration from:

About

Front-end for the Raston Lab's Fourier Transform MicroWave - Scientific Instrument Simulator (FTMW-SIS)

Resources

License

Stars

Watchers

Forks

Languages