ThermoVis is an Omix plug-in for the analysis and three dimensional visualization of network thermodynamics.
Table of contents
- 1.2. Using ThermoVis
- 1.2.1. Loading ΔG0 Values
- 1.2.2. Loading Concentration Data
- 1.2.3. The Visualization
- 1.2.4. About Loading Data
The free Gibbs energy potential of a chemical substance with concentration (or, more precisely, activity) x is given by
ΔG = ΔG0 + RT ln(x)
Here the term ΔG0 is free Gibbs energy potential under standard conditions which are essentially defined by 1 mol concentration of the respective substance. R is the gas constant and T is temperature. If a chemical reaction step has sources A, B,… and targets U, V,… then it must consequently hold
ΔGA + ΔGB + ... > ΔGU + ΔGV + ...
for the reaction to proceed in forward direction. The set of thermodynamic constraints obtained in this way by collecting the respective inequalities for every reaction step imposes a multidimensional relation between possible substance concentrations, free Gibbs energies under standard conditions and flux directions.
Start ThermoVis by selecting the corresponding entry in the Extras menu:
Now, ThermoVis opens as an additional window and loads the network diagram given in Omix as 3D scene.
There are three ways to specify the metabolites' ΔG0 values:
- You can enter ΔG0 values for each individual metabolite by editing the table cells on the right side. Be aware of the unit which is used for the values which is by default J/mol. If you want to enter values in another unit select the target unit in the upper combobox.
- By selecting the button "Set Default Values" you can enter one fixed value for all metabolites.
The following image shows the dialog where you can define the default value. Optionally, you can add a random deviation within specific range that is applied on each metabolite individually.
- By selecting "Load From File" you can import a spreadsheet file containing the ΔG0 values. By default, ThermoVis supports data in the CSV file format. If the Excel or ODF plug-in is installed in Omix, ThermoVis also supports Excel and ODF spreadsheet files, respectively.
After selecting a data file whether in CSV, Excel or ODF you must tell ThermoVis how the data file is organized and where to find the required information. This can be done as described in sub section About Loading Data.
After specifying the ΔG0 values, click OK to visualize the energy potentials in the 3D scene as depicted in the next image.
Bottom of the main window you see the "Concentration Data" sidebar. The sidebar provides a number of buttons on the right side to manage the data. Similar to the ΔG0 values, you can edit the concentration values manually, create a (noisy) default value or load data from CSV, Excel or ODF file. The latter is described in the sub section About Loading Data. If a metabolite's concentration value is empty, zerro or NaN (not a number), the metabolite and involved reactions are not considered in the thermodynamic analysis and thus displayed in grey.
Be sure that the imported or edited concentration values have the correct unit. The currentls used concentration unit can be changed in the combobox on the concentration sidebar. If your concentration data has not been measured under standard temperature, you must change the reference temperature.
Therefore, press the "Properties" button in the concentration sidebar and change the temperature value in the following dialog window.
The first column of the data table provides a checkbox in each data row. By checking this box the concentration data in the selected row is used to display the ΔG energy potentials under real condition. If no box is checked, the standard condition is visualized (ΔG0).
As described in the introduction, the sum of the educts ΔGs must be higher than the sum of the products ΔGs. If this is the case for a reaction, the reactions shape and edges are colored green. If the assumed reaction direction is not feasible, the reaction is colored red. By this, an immediate overview about the feasibility of reaction directions is given for the entire network. Whereas the metabolites are displayed with the standard symbol like in the Omix diagram the reactions are shown as spheres in general.
The gradient between the sum of the educts ΔGs and the sum of the products ΔGs is displayed by the reactions sphere radius. Furthermore, the vertical sphere position corresponds to the average of the ΔG values of all educts and products of the reaction.
network thermodynamic under standard (a) and real conditions (b)
- Moving the mouse with pressed left mouse button rotates the camera around the scene center point.
- Moving the mouse with pressed right mouse button moves the camera relative to the scene center (up, down, left, right).
- Using the mouse wheel moves the camera towards or away from the scene center point.
- Arrow keys ↑ and ↓ move the network fore- and backwards.
- Arrow keys ← and → rotate the network scene around its yaw axis.
- Page up and down keys rotate the network scene around its pitch axis.
- + and - keys can be used to zoom in and out.
By clicking on the list entry "Reaction Network" the entire scene is visualized again and the home position is brought back to the scene center.
By pressing on the "Eye" button, the visualization of termodynamic potentials can be enabled or disabled.
Furthermore, the way, data is mapped to the depth of the metabolite shapes can be adapted.
Therefore, press the "Properties" button in the "Concentration Data" sidebar. A dialog window appears that allows you to set an offset for the energy potential values.
By default, no offset is used:
You can set the minimum of all ΔG as offset:
Use the ΔG value of a specific metabolite as offset:
You can also type a fixed value:
And in combination with all other options you can show inverted values:
Be aware that an offset may hamper the correct interpretation of the energetic relations in some reaction! This especially applies where reactions have unequal number of educts and products.
Therefore, you must specify, if the header is horizontal (meaning to be the first row of the table) or vertical (first column). If the header is horizontal, each column represents the data belonging to one metabolite. A column may contain data in multiple rows. You can select which data row shall be loaded.
Vice versa, if the header is vertical, each row represents the data belonging to one metabolite.
If your data is not given in the default unit, you have to select the matching unit in the unit combobox.
The format dialog provides a preview that shows the content of the data file. The preview table displays a header and any number of rows containing data. Make sure that the preview header contains the data header, i.e. the preview header must be filled with the metabolite names!
Likewise, you can specify quoting characters like quotation marks. This allows, for instance, to separate cells by komma but however place text with a komma sign in one cell:
A,B,"A,B",Crepresenting four cells
The escape character also allows to place the quotation sign itself in text:
"He said: \"Hello!\" to her."is interpreted as one text object
With the start line attribute, you can deside with what line, ThermoVis shall start to read the data table, for instance, if file starts with comment lines.
In case, you use special characters like umlauts, greek letters or accents in the CSV file, you must specify the character set used by your file (cf. character encoding).
If the numbers in your CSV file do not use the scientific or english notation, you have to specify the decimal number format (cf. decimal mark).
Excel and ODF files as long as the corresponding Omix plug-ins are installed. Beside common properties as described above, you can select the sheet to be imported because Excel and ODF files can contain multiple sheets. It is also possible to skip a certain number of rows before reading the table content.