Skip to content
Stoichiometry Table widget for LabArchives ELN
HTML JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Readme.md
script.js
widget.html

Readme.md

LabArchives eNotebook Stoichiometry Table Widget

This widget helps the researcher calculate and document amounts used in reactions for stoichiometry.

The widget can be added to a LabArchive Notebook page.

It was developed by the Sydney Informatics Hub from an initial version by Dr. Samuel Banister.

Installation

To install, you will need to copy the contents of widget.html and script.js into the Widget Manager.

  1. Go to the Widget Manager
  2. Under Available Widgets click New
  3. Enter the widget title: Stoichiometry Table (or whatever you choose to call it for your notebooks)
  4. In the Widget HTML Editor tab, click the Source button on the toolbar.
  5. In a new browser window:
    1. Go to https://github.com/Sydney-Informatics-Hub/labarchives-stoichiometry-widget/raw/master/widget.html
    2. Select All (find this in the Edit menu)
    3. Copy (find this in the edit menu)
    4. Close that browser window.
  6. Back in your Widget HTML Editor: Select All and Paste.
  7. Change to the Script Editor tab.
  8. In a new browser window:
    1. Go to https://github.com/Sydney-Informatics-Hub/labarchives-stoichiometry-widget/raw/master/script.js
    2. Select All (find this in the Edit menu)
    3. Copy (find this in the edit menu)
    4. Close that browser window.
  9. Back in your Script Editor: Select All and Paste
  10. Click the Save Widget button next to the Title entry box.

Add a Widget into your Notebook

See https://labarchives.kayako.com/knowledgebase/article/View/408/286/501-what-are-widgets

Expected Behaviour

The software requirements detail expected behaviour for each modification to the table's data.

The permitted user inputs to the Stochiometry widget and the subsequent results are documented for the following two scenarios -

  1. When first entering data into the table
  2. When changing the values of the experiment

Initializing the records of the experiment:

On launching the Stochiometry widget to add to the page, only row 1 will be enabled on entry, although subsequent rows will be displayed.

For row 1 initial entry, the permitted ways of entering values are tabulated below -

User Enters Automatically Calculated
amt then fw moles
fw then amt moles
moles then fw amt
fw then moles amt

The equiv value for row 1 is set to 1 and cannot be edited by the user.

For all non-initial rows for initial entry, the permitted ways of entering values are tabulated below -

User Enters Automatically Calculated
equiv then fw mol and amt
fw then equiv mol and amt
fw then amt mol and equiv
amt then fw mol and equiv
equiv mol
mol equiv
amt then mol equiv and fw
fwd then mol equiv and amt

Once the first row and the rows needed for experiment are filled, add the Stochiometry to the page.

Changing the values of the records of the experiment:

For row 1, the behaviour is as below -

User Changes Automatically Calculated
amt mol and amt are recalculated for all rows which have valid values
mol mol and amt are recalculated for all rows which have valid values
fw amt is recalculated for row 1

For rows greater than 1, the behaviour is as below -

User Changes Automatically Calculated
amt equiv and moles are recalculated for the row for which the amt was changed
equiv amt and moles are recalculated for the row for which the equiv was changed
fw amt and moles are recalculated for the row for which the fw was changed

For volume and density fields

If the user enters density to the experiment, the volume will be automatically calculated by the formula - volume = amount / density

Filling density and volumes field is optional to the experiment and is used when gases are involved in the chemical equation.

Volume will be re-calculated whenever the amount value changes.

You can’t perform that action at this time.