From 022daef206aff0db8d7856a84bd361f30c62e9bd Mon Sep 17 00:00:00 2001 From: Nicholas VanFossen <35882058+VanFossen@users.noreply.github.com> Date: Tue, 18 Jul 2023 13:21:20 -0400 Subject: [PATCH] Update README.md --- README.md | 66 +++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 47 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 49d6c14..a7a958c 100644 --- a/README.md +++ b/README.md @@ -1,41 +1,69 @@ # Virtual-HeNDI-Spectrometer -This web application is intended to provide users with an overview of the anatomy of a Helium NanoDroplet Isolation (HeNDI) spectrometer. The application allows users to experiment with changing parameters such as the nozzle temperature to better understand the effect of these parameters on the spectra collected by the instrument. The user can simulate collecting spectra at a variety of nozzle temperatures ranging between 13.5 and 20 K. +The Raston Lab's **Helium NanoDroplet Isolation - Scientific Instrument Simulator** (HeNDI-SIS) was designed to emulate a student's classroom experience with a HeNDI spectrometer. The web application is intended to provide users with an overview of the anatomy of a HeNDI. When used, the application allows users to experiment with changing parameters such as the nozzle temperature to better understand the effect of these parameters on the spectra collected by the instrument. The user can simulate collecting spectra at a variety of nozzle temperatures ranging between 13.5 and 20 K. -The web application is accessible at: https://rastonlab.github.io/Virtual-HeNDI-Spectrometer/ +*Original work on this project was started by [Isaac Miller](https://github.com/isaac-j-miller)* + +## Installation + +**NOTE:** The frontend and backend exist together. The backend does not need to be run separately. + +1. Clone the repository + +2. Move into the cloned repository's directory + + ```bash + cd Virtual-HeNDI-Spectrometer + ``` + +3. Install all `npm` dependencies + + ```bash + npm install + ``` + +4. Run the server locally + + ```bash + npm start + ``` # Usage -## Instrument +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: + +- Instrument and Parameter View + +**_TODO_** -TODO +- Spectrum View -## Tooltips +**_TODO_** -TODO +## Contributing -## Temperature Controller +This project is intended to be a project for recruited undergraduate students, but pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. -TODO +## License -## Collect Spectrum +Licensed under **_TODO_** -TODO +**Relevant third-party tools and resources we depend on:** -# Running locally +- [big.js](https://github.com/MikeMcl/big.js): TODO (Licensed [MIT](https://github.com/MikeMcl/big.js/blob/master/LICENCE.md)) -The virtual spectrometer is made up of one program. +- [dygraphs](https://github.com/danvk/dygraphs): TODO (Licensed [MIT](https://github.com/danvk/dygraphs/blob/master/LICENSE.txt)) -- [Virtual-HeNDI-Spectrometer](https://github.com/RastonLab/Virtual-HeNDI-Spectrometer) +- [FileSaver.js](https://github.com/eligrey/FileSaver.js): TODO (Licensed [MIT](https://github.com/eligrey/FileSaver.js/blob/master/LICENSE.md)) - - This repository contains the front-end and back-end of the program using the React JavaScript library. +- [GitHub Pages Deploy Action](https://github.com/JamesIves/github-pages-deploy-action): GitHub Action used to automate deployment of web applications to GitHub Pages (Licensed [MIT](https://github.com/JamesIves/github-pages-deploy-action/blob/dev/LICENSE)) -## Front-end +- [MUI](https://mui.com/): React user interface component library (Licensed [MIT](https://github.com/mui/material-ui/blob/master/LICENSE)) -TODO +- [React](https://react.dev/): Javascript library for building user interfaces (Licensed [MIT](https://github.com/facebook/react/blob/main/LICENSE)) -# Architecture +- [SVGO](https://github.com/svg/svgo): Node.js tool for optimizing SVG files (Licensed [MIT](https://github.com/svg/svgo/blob/main/LICENSE)) -## GitHub Pages +- [SVGOMG](https://github.com/jakearchibald/svgomg): Web GUI for SVGO (Licensed [MIT](https://github.com/jakearchibald/svgomg/blob/main/LICENSE.md)) -The front-end of this project is hosted using [GitHub Pages](https://pages.github.com/). This allows us to have automatic updates to the live website after commits and pull requests are made to the central repository. These updates are automatically handled using [GitHub Actions](https://github.com/features/actions). Specifically, [GitHub Pages Deploy Action](https://github.com/JamesIves/github-pages-deploy-action) by James Ives. A simplified tutorial of this can be found on the [Raston Lab Wiki](https://github.com/RastonLab/.github/wiki/Tutorials#how-to-setup-a-github-action-to-host-a-react-application-on-github-pages)! +- [SVGR](https://github.com/gregberge/svgr): Tool for transforming SVGs into React components (Licensed [MIT](https://github.com/gregberge/svgr/blob/main/LICENSE))