Skip to main content
Version: ELN v4.x

Reactions

Caution

This page is still being edited and reviewed.

Meaning​

The element Reactions can be used to summarize all actions that involve several substances, materials or chemicals. Samples are always an essential part of reactions. In general, the more carefully the Chemotion ELN user documents the use of samples and differentiates between the individual actions (e.g. use of split and copy), the easier it is to document reactions and analyze the individual influences on a successful reaction.

Naming​

Reactions are numbered consecutively and displayed in the list of reactions in reverse order. The reaction name is preceded by the abbreviation of the Chemotion ELN owner such that reactions can be clearly identified. If users want to assign another name to the reaction, they click the name in the detail panel header, to the right of the short label, and type there. Enter or clicking away applies it and Escape cancels; the reaction itself is then saved as usual. From version 4.0 there is no longer a Name field on the Scheme or Properties tab.

Generation​

Reactions are generated with the green button in the toolbar by choosing Create Reaction.

Once a reaction is generated, its details panel is displayed, and the user can fill the reaction with the interacting samples and the resulting products from within the Scheme tab. More details about populating a reaction with samples can be found in the Details panel for reactions chapter.

Reactions in the element panel​

Reactions list

In the element panel, the reaction tab has the symbol . The number right next to the reaction symbol indicates the number of reactions within the selected collection. The number in parentheses shows the number of selected reactions within the collection. The reactions list shown in the figure above appears when the Chemotion ELN is opened if no detail level has been selected. When selecting the level of detail by selecting a reaction, the reactions list is reduced and the details panel appears.

The view of the reactions list differs from the view of samples list mainly by the absence of the gray and white areas as there is only the possibility to copy reactions, with no other similar yet different functions such as Split in case of samples. On the right-side of each reaction, there's a cross to enable dragging & dropping of reactions. In case other elements are available to drop reactions within them (such as a research plan), the cross is colored in blue to indicate that it is active, otherwise, it appears in gray, and it can be used in this case.

The user can filter their reaction either by creation date, or update date. The image above shows a calendar icon Creation date calendar which corresponds to a filter by creation date. Next to the calendar are the fields From and To. Clicking on them opens a calendar for the user to pick the desired days. Pressing on the calendar icon switches to filter by update date, and here the calendar appears like this Update date calendar.

Another method for filtering is using text search or structure search from the toolbar. More details about those methods can be found in the Toolbar page.

By clicking on the reaction list, a details panel for reactions opens on the right side.

Reaction types​

The Scheme tab toolbar opens with a Reaction type selector offering Standard and Interaction. Standard is the default, and every reaction created before version 4.0 is a standard one.

Interaction adapts the scheme for guest–host interaction studies rather than synthesis, and changes what the tab offers:

  • Starting materials is relabelled Guest and host, and Reactants becomes Additives.
  • Products lose their Yield and Conversion columns. Starting materials and additives keep Eq.
  • The scheme graphic shows the products alone, without yields, solvents or temperature.
  • Vessel size is replaced by Time (incubation), a single field with a unit button; the start, stop and duration controls are hidden.
  • The Conditions block, the Type (Name Reaction) and Role row, and the Purification controls are all hidden. Additional information for publication and purification details stays.
  • The Current Scheme dropdown is hidden, and both gas and weight percentage modes are switched off immediately.
caution

Switching to Interaction clears any weight percentage values and reference without asking for confirmation.

pH​

A pH field sits in the main properties row, to the right of the temperature, for reactions of either type. It is an operator button followed by a value β€” clicking the button cycles through =, < and >.

Gas Phase Reaction Scheme​

The new Gas Phase Reaction Scheme feature introduces a mode to handle reactions involving gaseous reactants and products. This feature allows users to input and calculate parameters specifically for gas-phase reactions, differing from the default reaction mode that is typically used for liquid or solid phases.

Reactions list

Key Features:​

Selection Toggle Button: Users can select between the Default mode (for liquid/solid phases) and the new Gas mode via a toggle button:

  • Default Mode: Operates as a default mode, where inputs and calculations are based on liquid or solid reactants.
  • Gas Mode: Introduces new fields and buttons tailored for handling gas-phase reactions.

UI Changes in Gas Mode: When Gas Mode is selected, the UI will display additional options and fields specific to gas reactions. Each sample (starting material, reactant, or product) gets an extra button:

  • FS (Feedstock): Appears for all starting materials and reactants. When selected, it sets the sample as a feedstock gas.
  • CAT (Catalyst): Appears for all starting materials and reactants. When selected, it sets the sample as a catalyst.
  • Gas: Appears for all products. When selected, it expands the UI to include five additional fields: Time, Temperature, Part Per Million (ppm), Turnover Number (TON), and Turnover Frequency (TOF).
  • Off: Appears as a default option for all samples. It means that the sample is none of the above options (neither feedstock, catalyst, nor gas)

Input Fields for Gaseous Products:

Upon selecting the gas button for a product, additional fields are displayed:

  • Time: The duration for which the reaction is carried out to prepare the relative product.
  • Temperature: Temperature of the reaction, input in Β°C, Β°F, or K.
  • ppm (Part Per Million): Concentration of the gas in parts per million.
  • TON (Turnover Number): Calculated as the ratio of moles of product to moles of reference (catalyst).
  • TOF (Turnover Frequency): Calculated as the ratio of TON to time.

Further Equations: It is important to mention that certain calculations differ when operating in Gas Phase mode. The following equations are applicable exclusively under these gas phase conditions and use the following constants:

  • Pressure in atm = 1
  • Volume in L
  • Number of moles in mol
  • Ideal gas constant (R) = 0.0821 atm L/(molK)*
  • Temperature in K
  • default temperature (defined as 294)
  • parts per million factor (1000000)

Equations:

  • Calculation for moles of gas product equation: N = part per million * pressure * reaction vessel volume / (R * temperature (entered in temperature field) * parts per million factor)
  • Calculation for moles of feedstock reference: purity * pressure * volume of feedstock / R * default temperature
  • Yield Calculation for gas products: this is the ratio of product moles to feedstock moles (using reaction vessel volume instead of feedstock volume). Substituting the values into the equation, the yield can be calculated as follows:
    • part per million * default temperature / purity * parts per million factor * temperature (entered in temperature field)

User Interface Functionality: The system automatically recalculates and synchronizes data for the input fields as necessary information is entered. For product samples, click the gas button to expand the input fields. Enter the Temperature, reaction vessel size, Time, and part per million value of the product gas. Using the values entered for the input fields of moles for catalyst and feedstock samples, the system will automatically calculate:

  • The amount of the product in moles
  • The Turnover Number (TON)
  • The Turnover Frequency (TOF)
  • The product yield

Aside from the functionalities mentioned above, all other features of the default reaction scheme remain fully available when using the gas mode scheme.

Weight Percentage Reaction Scheme​

The weight percentage scheme is an alternative to assigning amounts by molar equivalents. It lets a chemist work from masses directly β€” aiming for 10 g of product made up of 70:30 wt% of two starting materials, for instance.

Switching the scheme on​

The Scheme tab toolbar carries a dropdown reading Current Scheme: Default. Choosing Weight Percentage Scheme switches the mode on, and the button then reads Current Scheme: Weight Percentage. An β“˜ button and a link to this page appear beside it.

Switching back asks for confirmation first, warning that any weight percentage reference and all wt% values will be deleted.

Choosing the Interaction reaction type clears wt% without asking

The confirmation applies only to the Current Scheme dropdown. Setting the reaction type to Interaction also leaves weight percentage mode, and does so immediately β€” every wt% value and the wt% reference are cleared with no prompt.

Assigning weight percentages​

In this mode the Eq cell of each starting material and reactant becomes a selector offering molar mass or weight percentage. Products keep their usual Eq behavior.

For starting materials and reactants the Ref column shows two nested circles: the outer one chooses the weight percentage reference, the inner one the molar reference. A product's Ref cell has a single button instead, which selects it as the weight percentage reference. The reference can sit in any of the three groups, and its target mass is what the percentages are taken from.

A wt% value is a fraction between 0 and 1 β€” 0.3 for 30%.

An out-of-range value is reported but not undone

Entering a value below 0 or above 1 shows the error Weight percentage should be between 0 and 1, but the value stays on the material and is used in the calculation. Correct it before saving rather than relying on the error to have blocked it.

How the amounts follow​

Each material's amount is the reference material's target amount multiplied by its weight percentage:

amount of material = target amount of the reference Γ— weight percentage

So with a 10 g reference and values of 0.30 and 0.70, the two materials come out at 3 g and 7 g. Entering a wt% value, or changing the reference's target mass, recalculates the others at once.

Two things are worth knowing while working this way. A weight percentage field stays disabled until a reference has been chosen and given a target amount above zero β€” the tooltip on the disabled field asks for both in turn. And the Conc column is read-only in this mode, so a concentration cannot be typed while weight percentages are in use.